如何把 AI 助手接入 ThroughLine？

ThroughLine 的主接入方式是 Agent API：你在设置页创建 Agent Key，给它取一个自定义来源名称，然后把 API 配置交给 WorkBuddy、Cursor 或你自己的 Agent。

来源名称不是业务类型，只是人能看懂的标识，用于区分这个 Key 用在哪里，以及在审计和调用统计里帮助排查问题。ThroughLine 真正校验的是 Key、账号、权限 scope 和确认流程。

{
  "throughlineAgent": {
    "baseUrl": "https://throughline.cn",
    "sourceName": "WorkBuddy",
    "authorization": "Bearer <Agent Key>",
    "endpoints": {
      "context": "/api/v1/me/agent/context",
      "search": "/api/v1/me/agent/search",
      "getEntity": "/api/v1/me/agent/entities/{entityType}/{id}",
      "previewAction": "/api/v1/me/agent/actions/preview",
      "confirmAction": "/api/v1/me/agent/actions/confirm",
      "restoreAction": "/api/v1/me/agent/actions/restore",
      "openapi": "/api/v1/me/agent/openapi"
    }
  }
}

• 认证使用设置页创建的 Agent Key。
• Agent API 只覆盖领域、目标、项目、任务和子任务；习惯不能通过 Agent API 创建、编辑、打卡或恢复，需要在 ThroughLine 内管理。
• 写入仍然先生成预览和确认码。
• MCP 只作为可选适配层保留，底层仍然复用同一套 Agent Key 权限。