完成本教程后，你可以
- 让智能体查询已授权飞书账号可访问的指定日历。
- 按日期和时区列出会议名称、开始时间和结束时间。
- 找出已查询日程之间的时间重叠。
- 在同一个工作区中，让其他已配置相应能力的智能体复用现有连接。
开始前的准备
运行环境通常由管理员配置。日常使用者只需在智能体对话中提出查询需求。
本教程使用工作区中的团队连接。查询使用的是连接器已授权的飞书账号，不会因提问者不同而自动切换为各自的个人账号。首次查询前，请先确认要使用谁的账号、查询哪一个日历。
第一步：连接飞书账号
进入目标 工作区 → 连接器，找到 飞书卡片并点击 连接。首次连接需要完成应用授权和用户授权两个阶段。完成应用授权
- 在打开的飞书授权页面中扫码或登录。
- 按平台页面完成应用相关设置和授权确认。
- 返回 Xpert 查看连接状态。
完成用户授权
- 如果授权页面没有进入下一阶段，返回飞书连接器卡片，点击 继续授权。
- 使用本次要用于查询日历的账号，完成用户授权确认。
- 等待 Xpert 中的连接状态变为 已连接。
- 打开连接详情，核对已连接账号。
第二步：为智能体配置飞书连接器
连接账号后，需要让实际执行任务的智能体加载飞书能力。如果管理员已经完成这部分配置，可以直接进行下一步。- 打开目标智能体的 Studio／编排页面。
- 在画布添加菜单中选择 添加中间件 → 连接器。
- 在中间件的 连接器字段中选择 飞书。
- 将该中间件关联到实际执行任务的智能体节点。
- 为同一个智能体配置可用沙箱和 沙箱命令行工具。
- 保存并发布智能体，然后打开它的对话页面。
第三步：明确日期、时区和日历范围
为了得到可核对的结果，查询前应明确三项信息：
下面的操作使用 2026 年 9 月 25 日作为示例。实际使用时，请替换为你要查询的日期和日历名称。
如果日历名称重复，可以请管理员提供准确的日历标识；智能体无法确定目标时，应先确认范围，再执行查询。
第四步：查询日程并整理时间表
在配置好的智能体对话中发送：预期结果示例
假设测试日历中存在以下三条日程，结果可以整理为： **查询范围：**2026 年 9 月 25 日，Asia/Shanghai，“连接器测试日历”。
**冲突说明：**产品例会与客户方案沟通在 09:30—10:00 重叠，共 30 分钟。
以上为示例数据，用于说明输出形式，不代表已经读取了你的日历。
如何理解冲突结果
时间冲突由已读取事件的起止时间判断。例如，09:00—10:00 与 09:30—10:30 存在重叠；09:00—10:00 与 10:00—11:00 仅首尾相接，不属于时间重叠。 全天事件和跨日事件应单独标明，结合事件性质判断是否影响安排。若某个事件只允许查看忙闲状态，结果应保留这一限制，不推测会议标题和详情。 “没有发现冲突”只针对本次已成功读取的日历和事件，不代表其他未查询日历、不可见事件中也没有冲突。第五步：结合结果整理当天安排
收到时间表后，可以继续提出整理要求：验证查询是否正确
建议先选择一个测试日历，由有权限的人员在飞书中手动准备三条测试日程，再执行查询。准备测试数据与智能体的查询任务是两个独立步骤。
核对以下结果：
- 实际查询的账号和日历与准备的测试对象一致。
- 日期和时区正确，起止时间与飞书中看到的一致。
- 三条日程均出现在结果中，没有遗漏或重复。
- 两场上午会议的重叠时段为 09:30—10:00。
- 下午会议没有被误判为与上午会议冲突。
- 飞书中的日程内容保持不变，没有新增邀请或修改操作。