API 端点
Agents
创建 Agent
POST /v1/agents
请求体：
{
"name": "Agent 名称",
"description": "Agent 描述",
"instructions": "Agent 指令",
"model": "gpt-4",
"tools": ["web-search", "calculator"]
}
响应：
{
"id": "agent_abc123",
"name": "Agent 名称",
"createdAt": "2025-01-01T00:00:00Z"
}
获取 Agent
GET /v1/agents/{agentId}
列出所有 Agent
GET /v1/agents
查询参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| limit | number | 返回数量（默认 20） |
| offset | number | 偏移量 |
运行 Agent
POST /v1/agents/{agentId}/run
请求体：
{
"message": "用户消息",
"context": {
"sessionId": "session_123"
}
}
删除 Agent
DELETE /v1/agents/{agentId}
Sessions
创建会话
POST /v1/sessions
请求体：
{
"agentId": "agent_abc123",
"metadata": {}
}
获取会话消息
GET /v1/sessions/{sessionId}/messages
发送消息
POST /v1/sessions/{sessionId}/messages
请求体：
{
"content": "消息内容"
}
Knowledge
添加文档
POST /v1/knowledge/{agentId}/documents
搜索知识库
POST /v1/knowledge/{agentId}/search
请求体：
{
"query": "搜索查询",
"limit": 5
}
删除文档
DELETE /v1/knowledge/{agentId}/documents/{documentId}
Tools
注册工具
POST /v1/tools
列出工具
GET /v1/tools
删除工具
DELETE /v1/tools/{toolId}
Chains
创建链
POST /v1/chains
运行链
POST /v1/chains/{chainId}/run
请求体：
{
"input": "输入内容"
}