深脑 API 文档

v1 · 基础认证 + 转写推送 + 分析读取

认证

所有 /api/v1/* 接口需在请求头携带 API Key：

Authorization: Bearer lj_live_xxxxxxxxxxxxxxxx

API Key 在 /settings/api-keys 创建。

POST /api/v1/transcripts

推送转写文本（适用：硬件设备、第三方录音工具 webhook）

请求

curl -X POST https://deepagent.wiki/api/v1/transcripts \
  -H "Authorization: Bearer lj_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "说话人1: ...\n说话人2: ...",
    "title": "周三战略会议",
    "device_id": "meeting-room-shanghai-01"
  }'

响应

{
  "transcript_id": "550e8400-e29b-41d4-a716-446655440000",
  "analysis_id": null,
  "message": "转写已保存"
}

GET /api/v1/analyses

列出 org 的最近分析（50 条）

curl https://deepagent.wiki/api/v1/analyses \
  -H "Authorization: Bearer lj_live_xxxxxxxx"

GET /api/v1/analyses?id=xxx

获取分析详情（含证据锚点）

curl "https://deepagent.wiki/api/v1/analyses?id=ANALYSIS_ID" \
  -H "Authorization: Bearer lj_live_xxxxxxxx"

POST /api/v1/ask

问你的第二大脑。系统自动判断走快答（一次性 RAG）还是深度检索（智能体多步翻文档），SSE 流式返回。

curl -N -X POST https://deepagent.wiki/api/v1/ask \
  -H "Authorization: Bearer lj_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "上次客户的核心顾虑是什么？我们答应了什么？",
    "projectId": "可选：限定某个项目",
    "mode": "auto"
  }'

SSE 事件：mode（走了哪条路）/ tool_call·tool_result（智能体翻阅过程）/ sources（溯源原子）/ token（流式答案）/ insufficient / done / error。

data: {"type":"mode","mode":"agent"}
data: {"type":"tool_call","tool":"search_atoms","args":{"query":"客户 顾虑"}}
data: {"type":"tool_result","tool":"search_atoms","result":"[#1] (人物判断) …"}
data: {"type":"token","delta":"客户的核心顾虑集中在…"}
data: {"type":"done"}

接入第二大脑（MCP）

把你的第二大脑暴露成 MCP Server，任何支持 MCP 的智能体（Claude 桌面端 / Cursor 等）都能直接把你的组织知识当工具调用。

MCP endpoint：https://deepagent.wiki/api/mcp（用你的 API key 鉴权 · 需 brain.ask 权限）

提供以下工具：

ask_brain(question, project_id?) — 问大脑——完整智能体，多步翻文档后给带溯源的答案
search_brain(query, project_id?) — 语义搜索沉淀的洞察原子
list_decisions(project_id?) — 列出决策与行动项及状态
ingest_transcript(text, title?) — 反向摄取——把对话转写直接投喂进深脑（需 transcript.write 权限）

典型场景：钉钉/飞书里的机器人收到会议转写后，调 ingest_transcript 直接送进你的第二大脑；之后在深脑里分析、沉淀、可被问到。

Claude Code

claude mcp add --transport http deepbrain https://deepagent.wiki/api/mcp \
  --header "Authorization: Bearer lj_live_xxxxxxxx"

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "deepbrain": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://deepagent.wiki/api/mcp",
               "--header", "Authorization: Bearer lj_live_xxxxxxxx"]
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "deepbrain": {
      "url": "https://deepagent.wiki/api/mcp",
      "headers": { "Authorization": "Bearer lj_live_xxxxxxxx" }
    }
  }
}

配置后重启客户端，就能对它说「查下我深脑里关于 X 客户的判断」，它会调用你的第二大脑。

限流

每分钟 60 次请求 / API Key（超出返回 429）

权限 (scopes)

transcript.write — 推送转写
analysis.read — 读分析
brain.ask — brain.ask —— 问大脑 / 检索（用于 /api/v1/ask 与 MCP）
* — 全部

错误码

状态码	含义
401	Key 无效 / 已撤销
403	Key 缺少所需权限
404	资源不存在
429	限流
500	服务异常

支持

问题反馈：hi@zaowuyun.com