第 8 章　接入飞书：文档、消息、日程与多维表格

飞书连接器让WorkBuddy在任务中读取获得授权的文档、消息、日程和表格，也可能支持创建或更新。先跑通一项只读测试，再逐步验证其他资源，通常比一次要求“把飞书全部接好”更容易定位问题。

本章讲从WorkBuddy调用飞书。若要在飞书聊天窗口向WorkBuddy发任务，那是助理消息入口，配置见第9章。两者可能使用不同应用或权限，不能因其中一种已通，就推定另一种也可用。

按顺序接入

第一步，打开左侧“专家·技能·连接器”，选择连接器。找到飞书后打开详情，确认是本次要使用的连接器，再点击添加。先看账号与企业条件，必要时请管理员协助，避免用错误租户创建应用。

图8-1 飞书连接器列表与添加入口。

第二步，按连接器指引进入飞书开放平台，创建或选择应用。出处教程展示了创建应用、输入名称并继续开通授权的过程。当前页面若提供不同接入方式，遵循实际说明，不把旧截图中的每个选项当作固定配置。

第三步，查看并开通所需权限，完成账号授权。应用被授权、用户可见资源和管理员设置会共同影响实际能力。读取一个文档的练习，只需要相应文档访问能力；发送消息、读群记录、写表格、建日程是不同操作，应分别确认。

图8-2 飞书授权页面。检查权限清单和组织后再继续。

第四步，回到WorkBuddy任务，打开输入区“+”中的连接器列表，启用飞书。完成添加但没有在当前任务启用，模型可能不会调用它。第五步，使用一份专门准备的测试文档，验证读取，再核对出处。

请调用飞书连接器，只读取这份测试文档：〈文档链接〉。
先返回文档标题、实际可读内容范围与访问状态。
提取文中三项测试事项，按“原文、整理结果、原文位置”列成表。
不要读取同一知识库的其他文档，不修改文档，不发消息，不创建日程。
若只有标题或部分内容可读，明确说明，不把读取不全写成没有其他事项。

把四类资源分别验证

文档读取完成后，可以再测试消息。指定测试群的稳定链接或准确名称，并限定时间范围；群名重名时先选择对象。汇总应保留消息日期与可定位线索，区分明确决定、个人建议和未答复问题。不要把一条提议直接登记成团队共识。

日程测试先读取自己的测试日历，写明日期与时区，再查询忙闲或候选时段。群里有人说“下午有空”，不能替代所有参会人的日历状态。创建会议前明确开始、结束、参会人、地点和提醒设置；腾讯会议链接若由另一服务生成，也要另行授权。

多维表格读取先确认Base、数据表、视图及字段名称，查看实际返回记录是否受视图过滤、分页或权限影响。读到第一页不代表已经取得全表。法律项目常用的合同台账、案件进度和补件清单，都应先确认统计口径，再汇总数量与状态。

读取我指定的飞书多维表格链接，只处理〈表名/视图〉。
先列字段和实际读到的记录数量，说明是否仍有分页。
按已有“状态”字段汇总数量，空值单列，不推测案件是否已经完成。
生成本地“台账检查.md”，列出缺字段、重复候选和需人工确认的记录。
本轮不新增、修改或删除远端记录，不清空未知值。

从读取走向写入

需要将检查结果放回飞书时，先给出可审阅的拟写内容。追加段落与替换全文不同，新建任务与更新旧任务不同；每个目标都用链接或稳定记录标识确认。写入后读回标题、字段和记录数量，确认没有重建重复对象。

发消息前说明目标群、发送身份和完整文本。可以使用机器人向外部群发送通知的实例，但该功能涉及应用发布、外部共享与机器人入群；普通内部测试无需直接开启所有对外能力。先在测试群检查，再处理正式群通知。

无法读取时，逐项检查账号、组织、资源分享范围和应用权限；能读不能写时，查看写权限与目标字段类型。不要把失败归结为“飞书没有该内容”，也不要为了绕过权限改用其他人的凭据。