跳到主要内容

cURL 调用

使用 cURL 可以快速测试 Agent 接口。

前置条件​

  • 已创建 Agent
  • 已获取 API Key（在云开发控制台「设置」→「API 密钥」中创建）

获取 Agent API 地址​

  1. 进入 云开发控制台
  2. 选择「AI Agent」→ 选择对应的 Agent
  3. 在 Agent 详情页查看「API 地址」

API 地址格式：

https://{envId}.api.tcloudbasegateway.com/v1/aibot/bots/{agentId}/send-message

发送消息​

curl 'https://{envId}.api.tcloudbasegateway.com/v1/aibot/bots/{agentId}/send-message' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Accept: text/event-stream' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "threadId": "thread-001",
    "runId": "run-001",
    "messages": [
      { "id": "msg-1", "role": "user", "content": "你好" }
    ],
    "tools": [],
    "context": [],
    "state": {}
  }'

响应示例​

data: {"type":"RUN_STARTED","threadId":"thread-xxx","runId":"run-xxx"}

data: {"type":"TEXT_MESSAGE_START","messageId":"msg-1"}

data: {"type":"TEXT_MESSAGE_CONTENT","messageId":"msg-1","delta":"你好"}

data: {"type":"TEXT_MESSAGE_CONTENT","messageId":"msg-1","delta":"！"}

data: {"type":"TEXT_MESSAGE_END","messageId":"msg-1"}

data: {"type":"RUN_FINISHED"}

请求参数​

参数类型必填说明
threadIdstring否会话 ID，用于多轮对话
runIdstring否运行 ID
messagesarray是消息列表，包含 id、role、content
toolsarray否客户端工具列表
contextarray否上下文信息
stateobject否自定义状态数据

相关文档​