🤖 智能体控制台

快速操作

接入步骤

1. 确认 API 基地址（与上方“API 服务地址”一致）。
2. 在“配置管理”中创建职责、规则集、智能体与任务流（或使用已有任务流）。
3. 调用提交任务接口，传入文档或文本/JSON 数据。
4. 通过查询接口轮询结果，或在任务完成后接收回调。

接口概要

以下为常用接口路径（请拼接 API 基地址）：

• 提交任务：POST /api/tasks（multipart/form-data）
• 查询任务：GET /api/tasks/{task_id}
• 回调通知：POST {callback_url}（application/json）

如需鉴权，请在请求头携带 X-API-Key。

回调返回参数：task_id（任务ID）、status（任务状态：completed/failed 等）、timestamp（回调时间）、result（任务结果，结构同查询接口中的 result 字段）。

提交任务示例

文档审核（.docx）

curl -X POST "$API_BASE/api/tasks" \
  -H "X-API-Key: your_api_key" \
  -F "file=@demo.docx" \
  -F "flow_id=your_task_flow_id_xxx" \
  -F "auto_start=true"

通用/文本任务 — 传入 JSON 示例

下面列出三种常见调用方式，建议使用表单字段方式以兼容后端的 multipart 解析。

方式一（推荐 — JSON 作为表单字段）

curl -X POST "$API_BASE/api/tasks" \
  -H "X-API-Key: your_api_key" \
  -F 'input_data={"ingredients":["chicken","broccoli"],"goal":"weight_loss"}' \
  -F 'flow_id=your_task_flow_id_xxx' \
  -F 'auto_start=true'

方式二（上传 JSON 文件作为表单字段）

# 将 JSON 保存在 data.json，然后：
curl -X POST "$API_BASE/api/tasks" \
  -H "X-API-Key: your_api_key" \
  -F "input_data=@data.json;type=application/json" \
  -F 'flow_id=your_task_flow_id_xxx' \
  -F 'auto_start=true'

提示：input_data 支持纯文本或 JSON 字符串；当使用表单方式时请注意对引号进行适当转义或直接使用文件上传。

示例成功响应（简化）

{
  "task_id": "task_abc123",
  "status": "queued",
  "flow_id": "diet_plan_flow"
}