Agent Skills
返回列表
🤖

Google 日历日程桥接

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/google-calendar-freebusy-scheduler-bridge。

技能介绍

解决日历排期中的协同摩擦

在自动化 Agent 流程中，直接创建或修改日历事件往往面临盲区。Agent 缺乏对参与者真实空闲状态的感知，容易导致时间冲突或频繁的二次修改。Google Calendar FreeBusy 调度器桥接正是为了消除这一摩擦而生。它允许 Agent 在真正写入事件之前，先通过 Google Calendar API 的 freeBusy 端点和 Events 资源查询多方可用性，从而做出更合理的排期决策，减少人工介入。

核心能力与工作流

该技能主要围绕 Google Calendar API 的三个关键部分展开协同：

  • 空闲状态查询：利用 freeBusy 端点批量获取参与者的忙闲状态，精准识别共同的可用时间窗口。
  • 事件资源操作：通过 Events 资源读取现有日历数据，或在确认可用性后执行事件的创建与移动。
  • 会议元数据注入：支持 conferenceData 字段，方便在创建事件时直接附带 Google Meet 等视频会议信息，实现排期与会议链接的无缝衔接。

典型的 Agent 工作流包括：接收排期意图 -> 调用 freeBusy 比对候选时间 -> 锁定最佳时间窗口 -> 调用 Events 创建事件并填充 conferenceData -> 返回结构化结果。

适用边界与前置条件

虽然该技能大幅简化了排期逻辑，但在使用时仍需注意以下工程约束：

  • 凭证与权限：必须配置有效的 OAuth 2.0 凭证，并在 Google Cloud 项目中启用 Google Calendar API。
  • 运行环境：上游依赖要求环境中具备 Node.js 或 Python 运行时支持。
  • API 配额限制：高频调用 freeBusy 端点可能触发 Google API 的速率限制，建议在 Agent 逻辑中加入适当的重试与退避机制。

使用场景

  • 团队助理 Agent 在创建周会前，先调用 freeBusy 比对多名成员的空闲时段，再在共同窗口写入事件并附带会议链接。
  • 调度 Agent 需要把既有事件改期时，先用 Events 资源读取当前状态，再通过 freeBusy 确认新时间无冲突后再移动。
  • 机器人在帮团队批量预约评审会时，查询所有参会者忙碌状态锁定候选窗口，并用 conferenceData 生成视频会议信息。
  • Agent 在写日历前先调用 freeBusy 与 Events 做可用性检查，确认没有时间冲突后才创建带会议元数据的事件。

适合人员

  • 后端工程师：想让自动化服务在写入日历事件前先校验参与者的可用性，避免冲突后再落库。
  • Agent 开发者：需要让程序读取多方空闲状态并据此决定会议时间，同时附带会议元数据。
  • 日历工具集成者：希望在创建或移动事件时自动附带 conferenceData 字段的视频会议信息。
  • 自动化平台工程师：要在既有排期流程中嵌入 freeBusy 查询与 Events 写入的校验环节。