跳到主要内容

端点列表

Agents​

创建 Agent​

POST /v1/agents
{
  "name": "我的 Agent",
  "instructions": "你是一个有用的助手",
  "tools": ["web-search"],
  "model": "claude-sonnet-4-20250514"
}

列出 Agents​

GET /v1/agents

获取 Agent​

GET /v1/agents/{agent_id}

更新 Agent​

PATCH /v1/agents/{agent_id}

删除 Agent​

DELETE /v1/agents/{agent_id}

运行 Agent​

POST /v1/agents/{agent_id}/run
{
  "message": "帮我搜索最新的 AI 新闻",
  "stream": false
}

流式运行 Agent​

POST /v1/agents/{agent_id}/run/stream

Memory​

存储记忆​

POST /v1/memory
{
  "content": "用户偏好深色主题",
  "source": "conversation",
  "tags": ["preference", "ui"]
}

检索记忆​

POST /v1/memory/recall
{
  "query": "用户的 UI 偏好",
  "scope": "user_preference",
  "limit": 10
}

列出记忆​

GET /v1/memory

删除记忆​

DELETE /v1/memory/{memory_id}

Tools​

注册工具​

POST /v1/tools
{
  "name": "http-request",
  "description": "发送 HTTP 请求",
  "parameters": {
    "type": "object",
    "properties": {
      "url": { "type": "string" },
      "method": { "type": "string", "enum": ["GET", "POST"] }
    }
  }
}

列出工具​

GET /v1/tools

删除工具​

DELETE /v1/tools/{tool_name}

Chains​

创建链​

POST /v1/chains

运行链​

POST /v1/chains/{chain_id}/run

获取链状态​

GET /v1/chains/{chain_id}/runs/{run_id}

Webhooks​

注册 Webhook​

POST /v1/webhooks
{
  "url": "https://your-server.com/webhook",
  "events": ["onComplete", "onError"],
  "agent_id": "agent_xxx"
}

列出 Webhooks​

GET /v1/webhooks

删除 Webhook​

DELETE /v1/webhooks/{webhook_id}

Integrations​

连接集成​

POST /v1/integrations/{service}

断开集成​

DELETE /v1/integrations/{service}

同步集成​

POST /v1/integrations/{service}/sync

下一步​