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"}
Agent API
Invoke Agent
Agent mode invocation — supports tool calling, automatic planning, and SSE streaming response
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.
Core Parameters
Conversation mode:
agent— Full capability mode (default)ask— Read-only Q&A mode, write tools disabledplan— Interactive planning mode
Tool Configuration
Unified tool list. Each tool is distinguished by its
type fieldShow MCP Tool (type: mcp)
Show MCP Tool (type: mcp)
Code execution environment mode:
"cloud"— Use cloud sandbox (E2B / OpenSandbox / Daytona)"local"— Use local container (Docker / Apple Containerization), requiresworking_directory"none"— No code execution environment
RAG & Memory
List of knowledge base IDs. When provided, the
search_knowledge_base tool is automatically registeredSkills
Context
HITL Approval
Tool interrupt configuration (Human-in-the-Loop)
Show hitl_config
Show hitl_config
Tool name to interrupt config mapping
{ enabled, requires_interrupt, allowed_decisions, timeout }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"}