集成 REST API：在您自己的系统中使用智能体和数据

控制台中的所有功能都可以通过 REST API 访问，因此您可以在自己的网站、移动应用、CRM 或联络中心中使用 AI Agent Buddy，并自动推送数据。

1. 创建密钥

在控制台中，打开 API & keys，为密钥起一个能说明其用途的名称（例如 mobile-app-prod），然后点击 Create key。请立即复制：系统只存储指纹，因此密钥无法再次显示。请将其保存在服务器的密钥管理中，切勿放在客户可下载的网站或应用中。

2. 调用智能体

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'

• auto 让路由器自动选择智能体；也可以使用特定密钥，例如 personal-shopper。
• 添加 "stream": true 即可逐个 token 接收回答（server-sent events），同时还会收到产品、门店和退货等事件，您可以将其渲染为卡片。

3. 推送数据

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

文件会自动映射并处理。可通过 GET /api/v1/datasets/{id} 查询进度。

端点

吊销密钥

点击旁边的 Revoke。使用该密钥的调用将立即停止。