AI 助手接入

用 Agent API 把 ThroughLine 接进你的 AI 助手。

创建 Agent Key 后，把 API 配置交给 WorkBuddy、Cursor 或你自己的 Agent。来源名称由你自定义，只用于识别用途和审计；写入、删除和批量操作仍然先预览再确认。MCP 作为可选适配器保留。

Agent API自定义来源名WorkBuddy / Cursor写入前确认
ThroughLine 操作预览
帮我把 AI 助手接入方案拆成 1 个项目和 5 个任务，先给我预览。
我将创建 1 个项目、5 个任务，并关联到「产品增长」目标。确认码：7391。
只有你回复确认码后，ThroughLine 才执行被冻结的动作。
接入后

在你的 Agent 里整理任务

让已接入的 AI 读取、整理并预览 ThroughLine 操作。

“把明天要做的三件事加到创业目标下面。”
AI IDE

把方案拆成真实项目

WorkBuddy、Cursor 或自定义 Agent 读完方案后，可以通过 API 写入 ThroughLine。

“把这个产品方案拆成 1 个项目和 5 个任务。”
复盘

让 AI 帮你整理未完成项

查询本月状态、批量调整下周计划，仍然先预览再确认。

“查一下本月 AI 助手接入项目还有哪些没完成。”
接入流程

三步接入，不需要把数据库交给 AI

1

命名并生成 Agent Key

来源名称由你自定义，只用于识别这个 Key 用在哪里，不代表固定平台分类。

2

复制 Agent API 配置

把 base URL、端点和 Bearer Key 交给能发起 HTTPS 请求的 Agent。

3

粘贴到 Agent 并测试

先用只读问题确认连接；涉及写入、删除或批量动作时，必须先看到预览和确认码。

安全机制

AI 可以帮你整理，但不能绕过你

Agent Key 只存哈希，完整 Key 只展示一次。
所有写入先生成预览，用户确认后才执行。
删除默认软删除，可按批次恢复。
Agent API 不支持创建、编辑、打卡或恢复习惯。
读、写、删除、批量操作都有独立权限 scope。
调用有速率限制和审计日志，异常 Key 可一键停用。
示例指令

你可以这样说

“帮我把这个方案拆成 1 个项目和 5 个任务。”
“把今天未完成任务推迟到明天，先给我预览。”
“给我的健康目标新增 3 个本周任务。”
“删除重复任务，但执行前让我确认。”
“恢复刚刚删除的任务。”
常见问题
我到底该用 MCP 还是 Agent API？

默认用 Agent API + Agent Key。它是 ThroughLine 的核心业务接口，能读取上下文、搜索实体、预览写入并确认执行。MCP 只是可选适配器，只有客户端明确要求 MCP server 配置时再用。

普通 ChatGPT 或手机 ChatGPT 能直接用吗？

普通聊天框本身不能只靠粘贴 Key 自动调用外部 API。能配置 Actions、工具调用或自定义 HTTPS 请求的 Agent 才能接入；否则只能把导出内容交给 ChatGPT 分析。

AI 会不会直接删掉我的数据？

不会绕过确认。删除需要对应权限，并且先生成预览和确认码；执行后也是软删除，可恢复。

AI 能创建习惯吗？

不能。当前 Agent API 只覆盖领域、目标、项目、任务和子任务；习惯需要在 ThroughLine 内创建、编辑和打卡。