外部智能体调用

外部智能体调用

智能体开放接口将平台内已发布的连接配置用于程序调用。客户端以智能体的资源密钥调用，外部服务的地址与凭证由后端读取，调用方无需重复配置。

一、前置配置

在智能体工作区选择 OpenClaw 或 Hermes，完成连接测试、草稿试聊与发布。开启资源 API，并签发该智能体的资源密钥。

POST /agent/{id}/v1/chat/completions 接收对话请求，支持同步与流式模式。

二、请求示例

curl "$AI_API_BASE/agent/$AI_AGENT_ID/v1/chat/completions" \
  -H "Authorization: Bearer $AI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "model":"<智能体工作区提供的模型标识>",
    "messages":[{"role":"user","content":"介绍当前服务的职责。"}],
    "stream":true
  }' -N

路径主键指向平台智能体资源，不是外部服务的主键。模型标识、消息及可用参数以工作区 API 示例和接入服务为准。

三、会话与响应

按对话协议读取回答、思维信息和结束状态；保留服务端返回的会话标识，后续请求继续携带。连续对话应使用同一资源和会话，外部会话的映射由平台执行服务处理。

分层定位

认证失败先检查开放密钥及其资源作用域；连接失败再检查外部服务地址、凭证和协议。两者分别属于平台接入与外部执行链路。

四、发布配置变更

更新地址、角色或运行参数后，先草稿试聊，再重新发布。开放接口读取发布配置，以已发布版本验证后再复测程序调用。

连接步骤见 外部智能体配置，试聊与发布见 智能体调试与发布。