API 参考

聚道云 AI 提供 RESTful API，方便开发者集成和扩展。

认证

所有 API 请求需要在 Header 中携带 API Key：

Authorization: Bearer your-api-key

API Key 可在"设置 > API 管理"页面生成。

基础 URL

https://api.judao.ai/v1

对话接口

发送消息

POST /chat/messages

请求体：

{
  "employee_id": "emp_xxx",
  "message": "你好，帮我查询今天的天气",
  "stream": false
}

响应：

{
  "id": "msg_xxx",
  "content": "今天北京天气晴，气温 15-25°C...",
  "tokens": 128,
  "model": "claude-sonnet",
  "skills_used": ["weather"]
}

流式对话

设置 stream: true 开启 SSE 流式响应，实时获取 AI 回复。

数字员工接口

获取列表

GET /employees

创建数字员工

POST /employees

更新配置

PUT /employees/:id

删除

DELETE /employees/:id

工作流接口

触发工作流

POST /workflows/:id/trigger

查询执行状态

GET /workflows/:id/runs/:run_id

知识库接口

上传文档

POST /knowledge-bases/:id/documents
Content-Type: multipart/form-data

检索查询

POST /knowledge-bases/:id/search

速率限制

| 方案 | 限制 | |------|------| | 免费版 | 60 次/分钟 | | 专业版 | 300 次/分钟 | | 企业版 | 自定义 |

超过限制会返回 429 Too Many Requests。