Knowledge API

知识库检索 API — 让 AI Agent 获取 AiCOO 云端知识库中的确定性商业运营经验。

认证

API Key 通过 URL 查询参数传递：

https://aicoo-ai.com/v1/knowledge?action=start&key=YOUR_API_KEY

端点

1. action=start — 开始知识库检索

返回第一条知识碎片。首次调用后可使用 next 继续遍历。

curl "https://aicoo-ai.com/v1/knowledge?action=start&key=YOUR_API_KEY"

响应：

{
  "ok": true,
  "fragment": {
    "id": "frag-001",
    "content": "...",
    "total": 24,
    "remaining": 23
  }
}

2. action=next — 获取下一块碎片

在 start 之后调用，逐块遍历知识库。

curl "https://aicoo-ai.com/v1/knowledge?action=next&key=YOUR_API_KEY"

遍历完所有碎片后返回：

{ "ok": true, "fragment": null, "remaining": 0 }

3. action=agents — 列出可用 Agent

返回套餐范围内的 Agent 列表及简要说明。无需 start 即可单独调用。

curl "https://aicoo-ai.com/v1/knowledge?action=agents&key=YOUR_API_KEY"

响应：

{
  "ok": true,
  "agents": [
    {"name": "战略总管", "role": "全局视野 · 任务派遣 · 项目记忆中枢"},
    ...
  ]
}

4. action=search — 按编码搜索技能

精确搜索指定编码的技能 SOP。Pro / Ultra 套餐可用。

curl "https://aicoo-ai.com/v1/knowledge?action=search&code=SKILL-001&key=YOUR_API_KEY"

未找到：

{ "ok": true, "found": false }

各套餐可访问的知识域

错误处理

下一步

• API 概览 — 全部端点一览
• 快速开始 — 10 分钟上手