Appearance
飞书办公连接器：从授权到可验收交付
先明确结果和边界
飞书连接器适合把已经授权的群聊、文档、知识库、日历或多维表格纳入 WorkBuddy 任务。它不是“接上就能读写一切”的开关。开始前先写清：任务要读什么、输出给谁、是否需要写回，以及失败时如何停止。
五步接入
1. 确认接入条件
- 当前 WorkBuddy 版本和企业租户显示飞书连接器入口；
- 有飞书企业管理员或应用管理员协助创建、授权和回收应用；
- 准备测试群、测试文档、测试日历或脱敏多维表格；
- 先约定只读验证，暂不开放发送、编辑、删除和全组织范围。
2. 创建或选择企业应用
在飞书开放平台创建或选择用于测试的企业应用，按照当前页面申请最小权限。不要把 App ID、App Secret、回调地址或 Token 粘贴到公开 Prompt、截图、仓库或本页。
3. 回到 WorkBuddy 完成授权
在 WorkBuddy 的 专家·技能·连接器 区域找到飞书，发起授权并启用连接器。入口名称可能随版本变化，以当前客户端显示为准。授权完成后，先记录应用身份、授权人、授权时间和可访问范围，不要直接进入生产群组。
4. 用只读任务验证连接
先执行一条不会改变资料的任务，要求返回执行身份、来源对象和读取范围。例如：
text
请读取测试群最近 10 条消息，按主题生成摘要草稿。
只读，不发送消息，不修改文档，不创建日历事件。
先返回：使用的连接器、数据范围、时间范围、来源对象和可能缺失的信息。验收连接是否确实只读、结果是否来自预期群组、是否遗漏权限导致不完整，以及日志或结果中是否泄露凭证。
5. 逐项开放场景
只读验证通过后，再一次开放一个场景，并为写入或外发保留预览：
| 场景 | 先做什么 | 最后确认什么 |
|---|---|---|
| 群聊总结 | 只读读取测试群并生成草稿 | 群组、时间范围、敏感内容和发布人 |
| 知识库周报 | 读取指定知识空间或文档目录 | 来源完整性、引用、读者范围和更新权限 |
| 日历与会议 | 先读取空闲时间或生成候选方案 | 参会人、时区、会议室、邀请发送 |
| 多维表格分析 | 读取副本并生成指标草稿 | 字段口径、公式、回写目标和版本 |
| 外部群机器人通知 | 先生成待发送文本 | 接收群、发送时间、敏感字段和撤回方式 |
常见失败与处理
- 找不到飞书入口： 先确认客户端版本、租户策略和当前账号，不要用非官方插件替代。
- 授权成功但读不到数据： 核对应用权限、用户身份、群组/文档范围和数据是否确实属于测试空间。
- 结果不完整： 先检查分页、时间范围、权限和来源对象，不用模型补写缺失事实。
- 写入或发送失败： 保留错误原文，确认目标对象和写权限；不要连续重试可能产生重复事件的操作。
- 需要回收： 在 WorkBuddy 关闭连接器，并在飞书开放平台撤销应用权限或停用测试应用；记录回收时间。
安全与权限提示
连接器权限应与飞书应用权限、用户权限和 WorkBuddy 任务范围同时收敛。个人账号能看到的内容，不等于应用或自动化任务可以读取；测试群能写入，也不等于生产群可以写入。涉及客户、人事、财务、内部策略或外部群时，先做数据分级和人工审批。
参考：腾讯云 WorkBuddy Connector 官方说明、WorkBuddy Enterprise 官方文档总览。