Invoke Agent

curl --request POST \
  --url https://zeus-api.agentspro.cn/api/agent/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "Analyze the data trends in sales.csv",
    "llm_config": {
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "sk-...",
      "modelName": "gpt-4o",
      "temperature": 0.7
    },
    "session_id": "sess_456",
    "mode": "agent",
    "sandbox_mode": "cloud",
    "knowledge_base_ids": ["kb_789"],
    "enable_memory": true,
    "tools": [
      {
        "type": "mcp",
        "name": "tavily",
        "base_url": "https://mcp.tavily.com/mcp",
        "api_key": "tvly-..."
      }
    ]
  }'

data: {"type": "message_chunk", "content": "Let me help you analyze"}
data: {"type": "message_chunk", "content": " the data trends in sales.csv"}
data: {"type": "tool_call", "tool_name": "sandbox_exec", "tool_args": {...}}
data: {"type": "tool_result", "tool_name": "sandbox_exec", "result": "..."}
data: {"type": "message_chunk", "content": "Based on the analysis..."}
data: {"type": "done", "session_id": "sess_456"}

POST

api

agent

invoke

curl --request POST \
  --url https://zeus-api.agentspro.cn/api/agent/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "Analyze the data trends in sales.csv",
    "llm_config": {
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "sk-...",
      "modelName": "gpt-4o",
      "temperature": 0.7
    },
    "session_id": "sess_456",
    "mode": "agent",
    "sandbox_mode": "cloud",
    "knowledge_base_ids": ["kb_789"],
    "enable_memory": true,
    "tools": [
      {
        "type": "mcp",
        "name": "tavily",
        "base_url": "https://mcp.tavily.com/mcp",
        "api_key": "tvly-..."
      }
    ]
  }'

data: {"type": "message_chunk", "content": "Let me help you analyze"}
data: {"type": "message_chunk", "content": " the data trends in sales.csv"}
data: {"type": "tool_call", "tool_name": "sandbox_exec", "tool_args": {...}}
data: {"type": "tool_result", "tool_name": "sandbox_exec", "result": "..."}
data: {"type": "message_chunk", "content": "Based on the analysis..."}
data: {"type": "done", "session_id": "sess_456"}

The core entry point for Zeus. Starts an Agent conversation with full capabilities including MCP/OAuth tools, knowledge base RAG, memory, sandbox code execution, Skills, HITL approval, and more. Returns an SSE streaming response. See Streaming for message format details.

string

required

Bearer JWT Token (user_id is automatically extracted for store isolation)

Core Parameters

string

required

User message content

object

required

LLM model configuration (sourced from the frontend localStorage)

Show llm_config

string

required

API base URL

string

required

API key

string

required

Model name (e.g. gpt-4o, claude-sonnet-4-20250514)

number

default:"0.7"

Temperature parameter

string

Session ID for Checkpointer persistence. Auto-generated if not provided

string

default:"agent"

Conversation mode:

agent — Full capability mode (default)
ask — Read-only Q&A mode, write tools disabled
plan — Interactive planning mode

Tool Configuration

array

default:"[]"

Unified tool list. Each tool is distinguished by its type field

Show MCP Tool (type: mcp)

string

required

mcp

string

required

MCP server name

string

required

MCP server URL

string

default:"streamable_http"

Transport type

string

API key (optional)

object

Custom HTTP headers (optional)

Show OAuth Tool (type: oauth)

string

required

oauth

string

required

Tool name: github, gmail, google_drive, slack, notion

string

required

OAuth access token

string

OAuth refresh token (optional)

number

Token expiration timestamp (optional)

string

default:"cloud"

Code execution environment mode:

"cloud" — Use cloud sandbox (E2B / OpenSandbox / Daytona)
"local" — Use local container (Docker / Apple Containerization), requires working_directory
"none" — No code execution environment

boolean

default:"false"

Whether to enable the Web Search Tool (Tavily + DuckDuckGo)

RAG & Memory

array

default:"[]"

List of knowledge base IDs. When provided, the search_knowledge_base tool is automatically registered

boolean

default:"false"

Whether to enable the Memory Tool (long-term memory read/write)

Skills

object

Skills activation configuration

Show skills

array

List of explicitly activated Skill names. If empty, automatic matching is used

boolean

default:"true"

Whether to automatically match Skills based on message content

number

default:"3"

Maximum number of Skills to activate simultaneously

Context

array

default:"[]"

List of historical conversation messages [{ role, content, timestamp? }]

array

default:"[]"

List of resource files [{ name, content, type }] (e.g. Markdown prompts)

array

default:"[]"

Files uploaded to the sandbox [{ name, path, type, size? }]

array

default:"[]"

User-added chat attachments [{ id, name, size, type, content }]

HITL Approval

object

Tool interrupt configuration (Human-in-the-Loop)

Show hitl_config

object

default:"{}"

Tool name to interrupt config mapping { enabled, requires_interrupt, allowed_decisions, timeout }

boolean

default:"true"

Whether tools not listed in the config require interrupt by default

array

default:"[]"

Allowlisted tools — tools in this list execute automatically without interruption

number

default:"60"

Default timeout in seconds

curl --request POST \
  --url https://zeus-api.agentspro.cn/api/agent/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "Analyze the data trends in sales.csv",
    "llm_config": {
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "sk-...",
      "modelName": "gpt-4o",
      "temperature": 0.7
    },
    "session_id": "sess_456",
    "mode": "agent",
    "sandbox_mode": "cloud",
    "knowledge_base_ids": ["kb_789"],
    "enable_memory": true,
    "tools": [
      {
        "type": "mcp",
        "name": "tavily",
        "base_url": "https://mcp.tavily.com/mcp",
        "api_key": "tvly-..."
      }
    ]
  }'

data: {"type": "message_chunk", "content": "Let me help you analyze"}
data: {"type": "message_chunk", "content": " the data trends in sales.csv"}
data: {"type": "tool_call", "tool_name": "sandbox_exec", "tool_args": {...}}
data: {"type": "tool_result", "tool_name": "sandbox_exec", "result": "..."}
data: {"type": "message_chunk", "content": "Based on the analysis..."}
data: {"type": "done", "session_id": "sess_456"}

Auth

Agent API

Tools API

Knowledge Base API

Document API

Search API

Node API

Scheduled Tasks API

Channels API

WebSocket

Invoke Agent

Core Parameters

Tool Configuration

RAG & Memory

Skills

Context

HITL Approval

​Core Parameters

​Tool Configuration

​RAG & Memory

​Skills

​Context

​HITL Approval

Core Parameters

Tool Configuration

RAG & Memory

Skills

Context

HITL Approval