Knowledge API

Knowledge retrieval API — gives your AI agent deterministic business-operations know-how from the AiCOO cloud knowledge base.

Authentication

The API key is passed as a URL query parameter:

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

Endpoints

1. action=start — start the knowledge walkthrough

Returns the first knowledge fragment. After the first call you can use next to keep walking through the rest.

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

Response:

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

2. action=next — get the next fragment

Call this after start to walk the knowledge base fragment by fragment.

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

Once every fragment has been returned, you get:

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

3. action=agents — list available agents

Returns the agents included in your plan, with a short description of each. Can be called on its own — no start needed.

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

Response:

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

4. action=search — search a skill by code

Looks up the SOP for a specific skill code. Available on Pro and Ultra plans.

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

Not found:

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

Knowledge domains by plan

Error handling

Next steps

• API Overview — every endpoint at a glance
• Quick Start — up and running in 10 minutes