Skip to main content
The SambaNova Agent provides access to specialized AI agents for different tasks. Each agent has both a fire-and-forget endpoint (single call) and an interactive endpoint (multi-turn conversation).

​
Available agents

AgentEndpointCapabilities
Main Agentapi/agent/mainagentGeneral-purpose assistant with access to all subagents
Financial Analysisapi/agent/financialanalysisStock analysis, financial metrics, market data
Deep Researchapi/agent/deepresearchMulti-iteration research with comprehensive reports
Data Scienceapi/agent/datascienceDataset analysis, visualizations, ML workflows
Coding Agentapi/agent/codingCode execution, debugging, sandboxed Python

​
Key features

  • Artifacts System: Files (charts, PDFs, scripts) returned as downloadable IDs
  • Multi-turn Conversations: Interactive endpoints with thread_id continuity
  • Auto-approval: Deep research and data science interrupts handled automatically
  • File Upload: Data science accepts dataset uploads
  • Bearer Auth: Secure API key authentication

​
Common patterns

​
Fire-and-forget pattern

Single API call that processes the request and returns the complete result. Use case: Quick queries, one-shot tasks, automated workflows 
curl -X POST "https://<base-url>/agent/mainagent" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a bar chart for Q1 sales"
  }'

​
Interactive pattern

Multi-turn conversation with persistent context using thread_id. Use case: Follow-up questions, iterative development, complex workflows

​
Step 1: Initial request

curl -X POST "https://<base-url>/agent/mainagent/interactive" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a bar chart for Q1 sales",
    "resume": false
  }'

​
Step 2: Follow-up request

curl -X POST "https://<base-url>/agent/mainagent/interactive" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Now create a pie chart showing the distribution",
    "thread_id": "thread-abc",
    "resume": true
  }'