GetMyBot 知识库

预约与 Google 日历

让 AI 代理安排咨询:连接 Google 日历、设置可约时间,并允许预约、改期或取消。

本页内容

AI 代理可以推荐空闲时间并把客户预约写入 Google 日历。例如,在工作日安排半小时咨询。按授予的权限,代理还能改期或取消。

在 AI → 日历连接账户、创建预约类型并检查空闲时间,然后在代理设置中启用所需日历动作。可预约的时间段在界面中称为时段。目前仅支持 Google 日历;预约类型、预约记录和代理工具虽使用平台统一接口,尚不能接入其他日历服务商。

连接账户

点击连接 Google 日历并在 Google 窗口授权。请求的权限包括日历列表、日程事件和忙闲信息。五分钟内未完成连接,须重新开始。

连接使用一次性的 state 参数绑定机器人及账户,配合 PKCE 和固定回调地址保护授权;state 有效期五分钟。续期令牌加密保存,不会再次展示。连接卡片只显示账户标签和四种状态之一:已连接、访问已过期、已断开、错误。过期后重新连接。

运行中的代理若启用了日历工具,断开日历按钮会被禁用,界面会列出这些代理。须先关闭工具或暂停代理。

预约类型

预约类型定义代理可提供的服务,设置包括:

  • 名称:显示在你的报告和客户日历事件中。
  • 日历:从已连接账户中选择。保存后的日历 ID 会加密且不再显示,因此编辑预约类型时须重新选择。
  • 时长:5–480 分钟。
  • 时区:IANA 名称,如 Europe/Berlin,决定下面可约时间的含义。
  • 可约时间:按星期设置 1–28 个区间,边界为 HH:MM;区间不能重叠,结束早于开始表示跨午夜。
  • 预约提前量:0–1,440 分钟,在此期限内不能预约。
  • 最长提前天数:1–366 天。
  • 会前与会后缓冲:各 0–1,440 分钟,保持为空闲。
  • 启用状态:只有启用的类型可被推荐或预约。

显示空闲时段会从已连接日历获取未来一周的真实结果,不是模拟。

如何选择时段

可用性同时取决于预约类型的每周时间、日历忙碌区间、缓冲时间和此连接已有的预约。候选时段每 15 分钟一个,默认返回 10 个,最多 20 个。界面按客户时区显示时间,存储时用 UTC;夏令时变化影响显示的本地时间,不改变已保存的绝对时刻。

为避免重复预约,系统按以下顺序处理:

  1. 写入前再次检查所选时段。
  2. 用幂等键保存待确认预约,重复请求不会创建第二场会议。
  3. 在日历中创建事件,必要时附上视频会议链接。
  4. Google 日历超时或暂时出错时,先按幂等键查找预约;结果不明的超时不会产生重复预约。
  5. 最后才确认预约。服务商事件 ID 和会议链接会加密保存。

改期和取消采用同样方式。若时段已被别人占用,操作会报错而不会重复预约。预约状态包括待确认、已确认、已改期、已取消、错误。

授权代理使用工具

在代理编辑器的允许的工具中,按需启用:

  • 查看空闲时段
  • 创建预约
  • 更改预约时间
  • 取消预约

每个已启用的日历工具都要指定至少一种当前已启用的预约类型,否则准备情况检查会阻止启用代理。运行中的代理目前只能使用日历工具,其他工具不会执行。

模型不能自行选择日历、客户或任意请求,只能建议调用;参数要通过禁止未知字段的封闭结构校验。机器人、订阅者和允许的预约类型由服务器上下文提供。工具调用有 15 秒截止时间和按处理轮次、调用序号生成的幂等键;日志会去除会议链接和联系方式。

报告

AI → 分析会在其他代理指标旁展示日历动作和预约结果;AI → 日历则显示预约记录本身。

遇到问题时

  • 启用了日历工具却没有已启用的预约类型:创建一种或启用现有类型,再启用代理。
  • 无法加载日历列表:可能需要重新连接账户;临时可手动输入连接 ID。
  • 未来一周没有空闲时段:检查每周时间、提前量、缓冲和日历已有日程。
  • 预约类型正在使用,不能删除:运行中代理的日历工具还引用了它。

相关内容