使用连接器读取和写入外部工具

理解连接器的读写边界、授权范围、任务写法和状态检查方式。

连接器让 Kollab 在当前空间里使用外部工具。它不是另一个聊天入口,而是任务、机器人和定时任务可以调用的工具通道。常见连接器包括 Notion、GitHub、Figma、Linear、Google Drive、Slack,以及团队自建的 MCP 服务。

先确认连接器在哪里生效

连接器属于空间。你在 A 空间安装的连接器,不会自动出现在 B 空间。开始任务前,先确认自己位于正确空间,再进入连接器页面查看目标连接器是否存在、是否启用、状态是否正常。

读和写分别适合什么

读取适合让 Kollab 使用外部资料:读取 Notion 页面、检索 GitHub issue、查看 Figma 文件说明、读取 Linear 问题、查找 Google Drive 文档或引用 Slack 频道上下文。

写入适合把结果沉淀回团队系统:创建 Notion 页面、更新 GitHub issue、补充 Linear 状态、整理 Google Drive 文档、把摘要发送回 Slack。写入前一定要说明目标位置、写入对象和格式,避免 Kollab 把结果留在任务里而没有写回外部工具。

一个可执行的任务写法

可以这样写:

“请读取连接器里的 Notion《支付重构需求》和 GitHub 仓库里的 open bug,生成一份测试清单。输出先在 Kollab 任务里给我确认,确认后再写回 Notion。如果信息不够,请列出缺少的页面或仓库权限。”

如果你已经确认要写回,可以这样写:

“请把最终版测试清单写入 Notion《支付重构测试计划》页面,使用二级标题分组,并在任务里回复写入位置。”

如果任务需要多个工具

把每个工具的职责分开写清楚会更稳。比如 Notion 提供需求背景,GitHub 提供缺陷列表,Linear 提供优先级,Slack 只用来补充本周讨论。相比只写“参考我们的资料”,这样 Kollab 更容易判断应该从哪个连接器开始。

写入前的安全做法

第一次让 Kollab 操作外部工具时,先要求它“只读取并给出计划”。确认计划无误后,再让它写回指定位置。对生产仓库、客户文档、公开频道和重要数据库,尤其建议先让 Kollab 说明将要修改什么。

访问不到内容时先检查什么

先检查四件事:连接器是否安装并启用;授权账号能不能在原工具里看到目标内容;具体页面、仓库、文件或频道是否分享给对应账号或集成;任务里是否写清了名称、链接或目标范围。权限没通时,反复改提示词通常没有用。

常见问题

连接器安装后,Kollab 就能访问所有内容吗?+

不一定。连接器只是把外部工具接入当前空间,Kollab 实际能访问什么,还取决于授权账号、外部工具分享范围、具体页面或仓库权限,以及任务里有没有说清目标位置。

读取和写入权限有什么区别?+

读取权限让 Kollab 查看资料或检索上下文;写入权限才允许创建页面、更新 issue、写入表格、发送消息或修改外部工具内容。写入前最好明确目标位置和输出格式。

相关文档