连接器:先画清数据从哪里来、到哪里去

作者: ·

在接入外部工具前确认数据流、权限和失败处理,避免自动化变成不可控的数据搬运。

想读文档、查工单或建会议时,WorkBuddy 需要一条通往外部系统的线。线一接上,权限也跟着进来了。

连之前先画数据流。先验证只读输入,再决定要不要写入或自动同步。连接不是越多越好,是越清楚越好。

这一节做完,手里会有一张连接器授权与字段清单

先把这件事想明白

连接器让 Agent 从「会想」走到「能在授权的系统里做事」。但任何一次连接,都该先被当成数据流和权限来设计。

搞懂「读取」「调用」「写入」三类权限

  • MCP 是 Anthropic 2024 年底开源的协议,相当于 AI 世界的 USB-C 接口,把 N×M 的对接砍成 N+M
  • 它标准化三种能力:Tools 执行操作、Resources 读取数据、Prompts 提供模板。读和写是两件事
  • 自定义连接器先用最小账号、最小范围、只读方式验证,再谈写入

现在跟着做

开始前,先准备这几样东西。

  • 确认数据来源和所有者
  • 定好要哪些字段
  • 判断涉及不涉及敏感内容
WorkBuddy 连接器管理界面示意Wattter · 教程示意连上外部系统之前,先确认它能读什么、能写什么。

材料就位后,按这个顺序走。

  1. 画出来源、处理、结果三个节点
  2. 只选这次任务必需的字段
  3. 先用只读方式测一小段数据
  4. 写入前说清目标位置、覆盖规则和人工确认点

做到这儿,就可以先停

  • 只读验证能看到真实数据样本
  • 写入有目标位置和覆盖规则
  • 没授权的字段不会被自动抓走

换一件小事,再走一遍

用会议连接器建一场项目会

建会议看起来只是一句话。真正要确认的却不少,主题、时长、时区、参会人和议程,错一个都可能要重新通知人。先让它给出待确认草稿,再决定是否写进日历。省下的那十秒,不值得换一次撤销和重约。

  1. 确认连接器的账号、日历范围和可写权限
  2. 先读可用时间和目标参会人,不建任何会
  3. 生成会议草稿:主题、时长、时区、参会人、议程
  4. 人工确认后建,把会议链接回写到项目任务

把这段话改成你自己的任务

先放进练习工作区。方括号里的内容,换成你手上那件小事。

来源:【系统 / 文件】\n读取字段:【哪些】\n处理动作:【做什么】\n结果位置:【放哪】\n写入规则:【新建 / 覆盖 / 需确认】
卡住时,先看这里
  • 权限越界读到无关字段。连接器返回里混出无关字段 通常是因为授权范围太宽。 缩小授权字段,写清禁用字段。
  • 写入覆盖了源数据。跑完发现源数据被改了 通常是因为没写写入目标和覆盖规则。 改成「先复制再写入」,留一个人工确认点。

还容易犯这几种错

  • 一上来接入全部数据
  • 没分清读取权限和写入权限
  • 字段含义都没搞清就直接分析

先停一下敏感数据不授权读取或写入;关键系统写入前留人工确认;自定义连接器先用最小账号测。

留十分钟,做成自己的

为一个任务画出来源、处理、结果的数据流,交一张授权清单。

连接器管系统对接,下一步把已完成的任务扩到手机和 IM 入口。

还有几个常见问题

这一页最先要准备什么?先确认数据来源和所有者。连之前先画数据流。先验证只读输入,再决定要不要写入或自动同步。连接不是越多越好,是越清楚越好。

做这一步时心里应该记住什么?MCP 是 Anthropic 2024 年底开源的协议,相当于 AI 世界的 USB-C 接口,把 N×M 的对接砍成 N+M

最容易卡在哪里?一上来接入全部数据

完成这一页后,下一步怎么接?连接器管系统对接,下一步把已完成的任务扩到手机和 IM 入口。