2026/9/10 1:56:00
FEATURED · 精选文章 
Composio 谷歌日历Google CalendarToolkit 接入指南账号连接、事件操作、触发器配置与版本故障排查【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本指南以 Composio 仓库中 Google Calendar Toolkit 的支持知识文档docs/kb/articles/toolkits-google-calendar.md 及其源稿 docs/kb/source/toolkits/google_calendar/public.md为主体系统讲解如何在 Composio 中连接 Google Calendar 账号、操作事件与可用性数据、配置事件触发器并针对版本相关的常见问题给出排查思路。读完本文你将掌握 Google Calendar 集成/认证配置的完整流程、GOOGLECALENDAR_*系列工具与触发器的正确用法以及 RSVP 更新、时区处理、hangout_link读取等关键细节的避坑要点。连接 Google Calendar 账号在 Composio 中使用 Google Calendar第一步是创建 Google Calendar 集成integration/ 认证配置auth config随后连接账号再通过该已连接账号connected account调用 Google Calendar Toolkit 中的工具与触发器。核心流程如下创建认证配置在 Composio 平台或通过 SDK/API为googlecalendar创建一个 OAuth 认证配置。从源码结构看认证配置由auth_configs相关模块管理仓库中的示例 python/examples/auth_configs.py 展示了创建认证配置的完整调用方式。连接账号使用该认证配置引导用户完成 Google OAuth 授权得到 connected account。调用工具与触发器所有 Google Calendar 工具和触发器都通过该 connected account 执行。必需的 OAuth Scope调用event-list事件列表或event-fetch事件获取等需要事件访问权限的工具时必须确保 connected account 包含以下 scopehttps://www.googleapis.com/auth/calendar.events缺少该 scope 时事件读写类调用会因权限不足而失败。如果你还需要读取日历元数据、管理其他日历或处理会议信息应根据实际需要补充对应 scope。通过 SDK 使用 Google Calendar 工具创建好 connected account 后即可在 SDK 中指定 Google Calendar 工具。仓库文档 docs/content/docs/tools-direct/executing-tools.mdx 给出了示例通过tools[GOOGLECALENDAR_EVENTS_LIST]在 Python SDK 中启用事件列表工具。实际工具名以工具集枚举为准例如GOOGLECALENDAR_LIST_EVENTS、GOOGLECALENDAR_FIND_EVENT、GOOGLECALENDAR_EVENTS_LIST等。固定 Toolkit 版本Google Calendar Toolkit 支持按版本固定这直接关系到下文“过滤器被忽略”的排查。仓库文档 docs/content/docs/auth-configuration/custom-auth-params.mdx 展示了两种语言的写法Pythoncomposio Composio(toolkit_versions{googlecalendar: latest})TypeScripttoolkitVersions: { googlecalendar: latest },当遇到行为异常时应优先检查此处固定的版本将googlecalendar升级到latest或使用 v3.1/latest 行为。操作事件与可用性数据连接账号后就可以操作日历事件和查询可用性。本节整理四个高频且容易踩坑的点。RSVP 状态更新受出席者列表限制Google Calendar API 对包含多个出席者attendees的事件的 RSVP/状态更新存在限制。当事件有多个出席者时直接更新 RSVP 状态可能失败或不会生效。推荐的处理方式有两种先更新认证用户的 RSVP再重新添加出席者re-add the attendees或重新发送完整的出席者列表并携带更新后的状态。即把“更新状态”和“恢复出席者列表”拆成两个动作避免在一次调用中同时修改状态与出席者从而绕过 API 限制。需要“已处理”的可用性数据时使用 Find Free SlotsGoogle Calendar 提供两类可用性查询Find Free Slots查找空闲时间段返回经过处理processed的可用性结果例如已处理时区换算、合并连续空闲段等适合直接用于排期决策。Query Free/Busy查询忙闲状态返回的是 Google 提供的原始数据不包含额外处理例如时区处理需要调用方自行完成。因此如果你的 Agent 需要直接可用的空闲时段应优先使用 find-free-slots 工具若使用 free/busy 原始数据则必须在业务侧补齐时区与数据后处理逻辑。使用primary作为日历 IDGoogle Calendar 工具的calendarId参数应使用类似primary的合法日历 ID。me不是合法的 Google Calendar ID传入会导致调用失败。CLI 示例docs/content/docs/cli.mdx中即使用了calendar_id: primary来执行GOOGLECALENDAR_FIND_EVENTexecute(GOOGLECALENDAR_FIND_EVENT, { calendar_id: primary })会议链接从hangout_link读取创建或更新带会议conferencing功能的日历事件后生成的会议 URL 位于响应体中的hangout_link字段。请勿从其他字段猜测会议地址务必以hangout_link为准。典型用法创建事件后读取hangout_link将其发送给参会者或写入 Agent 的对话上下文。配置 Google Calendar 触发器触发器用于在日历事件发生变化时自动触发你的工作流。Google Calendar 相关的触发器配置需要注意以下几点。取消/删除事件触发器当事件被取消或删除时GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER会发送一个 payload。你的工作流应订阅该触发器以捕获事件被取消或删除的场景例如自动通知参会者或释放资源。同一用户、同一触发器 slug 可针对不同日历创建多个实例Composio 支持同一触发器 slug、同一用户下创建多个触发器实例前提是每个实例配置了不同的calendarId。也就是说你可以为多个日历分别创建各自的新事件触发器它们互不冲突。每个实例只需在配置中指定各自的calendarId即可。新触发器返回完整事件数据较新的 Google Calendar新事件触发器new-event trigger的 payload 包含完整事件数据而不再仅仅是事件 ID。这一变化的背景是Google Calendar 触发器行为从webhook 式投递逐步转向轮询polling因此 payload 可以携带更多细节调用方后续需要的补充处理follow-up processing例如回查事件详情更少。需要特别注意的是现有触发器流程在演进过程中被保留轮询能力是按需单独引入的。也就是说不同时间创建的触发器实例可能表现出不同的 payload 形态如果你的工作流依赖“完整事件数据”请确认所用触发器实例使用的是新版行为。以编程方式获取触发器元数据可以使用trigger-types 端点以编程方式获取 Google Calendar 触发器元数据包括触发器 slug、所需参数、payload 结构等搭建触发器前可先通过该端点查询可用触发器类型。具体的搭建指引请参考仓库中的触发器文档例如 docs/content/docs/setting-up-triggers/ 目录下的相关指南。对于需要自行注册回调地址的实时触发器还可参考 docs/content/docs/setting-up-triggers/custom-oauth-webhooks.mdx 中关于 webhook 端点的说明。排查事件过滤器被忽略症状修改timeMin、timeMax等过滤器后返回结果与修改前完全相同仿佛过滤器从未生效。根因较早固定pinned的 Google Calendar Toolkit 版本可能会在请求到达 Google 之前丢弃或重映射这些过滤器例如timeMin、timeMax导致 Google 侧实际没有收到过滤条件结果自然不变。解决方案升级到最新的 Google Calendar Toolkit 版本如toolkit_versions{googlecalendar: latest}或使用v3.1 / latest 行为对应 API 版本指南见 docs/lib/api-version.ts 相关的版本说明。升级后重新执行同样的过滤查询确认timeMin/timeMax等参数确实生效。小结主题要点账号连接创建googlecalendar认证配置 → 连接账号 → 通过 connected account 调用工具/触发器OAuth Scope事件读写需包含https://www.googleapis.com/auth/calendar.eventsRSVP 更新多出席者事件受 API 限制先更新本人 RSVP 再重加出席者可用性查询需要已处理结果用 Find Free Slotsfree/busy 需自行处理时区日历 ID使用primaryme无效会议链接从响应hangout_link字段读取取消/删除事件订阅GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER多日历触发器同一 slug/用户下按不同calendarId创建多个实例触发器 payload新版返回完整事件数据行为正从 webhook 向轮询演进过滤器失效升级 toolkit 到 latest或使用 v3.1/latest 行为以上内容均对应 Composio 仓库中的支持知识文档docs/kb/articles/toolkits-google-calendar.md及其源稿 docs/kb/source/toolkits/google_calendar/public.md并辅以仓库中的 SDK 示例、CLI 示例与配置文档佐证可作为接入与排障时的直接参考。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Composio 谷歌日历（Google Calendar）Toolkit 接入指南：账号连接、事件操作、触发器配置与版本故障排查
Composio 谷歌日历Google CalendarToolkit 接入指南账号连接、事件操作、触发器配置与版本故障排查【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本指南以 Composio 仓库中 Google Calendar Toolkit 的支持知识文档docs/kb/articles/toolkits-google-calendar.md 及其源稿 docs/kb/source/toolkits/google_calendar/public.md为主体系统讲解如何在 Composio 中连接 Google Calendar 账号、操作事件与可用性数据、配置事件触发器并针对版本相关的常见问题给出排查思路。读完本文你将掌握 Google Calendar 集成/认证配置的完整流程、GOOGLECALENDAR_*系列工具与触发器的正确用法以及 RSVP 更新、时区处理、hangout_link读取等关键细节的避坑要点。连接 Google Calendar 账号在 Composio 中使用 Google Calendar第一步是创建 Google Calendar 集成integration/ 认证配置auth config随后连接账号再通过该已连接账号connected account调用 Google Calendar Toolkit 中的工具与触发器。核心流程如下创建认证配置在 Composio 平台或通过 SDK/API为googlecalendar创建一个 OAuth 认证配置。从源码结构看认证配置由auth_configs相关模块管理仓库中的示例 python/examples/auth_configs.py 展示了创建认证配置的完整调用方式。连接账号使用该认证配置引导用户完成 Google OAuth 授权得到 connected account。调用工具与触发器所有 Google Calendar 工具和触发器都通过该 connected account 执行。必需的 OAuth Scope调用event-list事件列表或event-fetch事件获取等需要事件访问权限的工具时必须确保 connected account 包含以下 scopehttps://www.googleapis.com/auth/calendar.events缺少该 scope 时事件读写类调用会因权限不足而失败。如果你还需要读取日历元数据、管理其他日历或处理会议信息应根据实际需要补充对应 scope。通过 SDK 使用 Google Calendar 工具创建好 connected account 后即可在 SDK 中指定 Google Calendar 工具。仓库文档 docs/content/docs/tools-direct/executing-tools.mdx 给出了示例通过tools[GOOGLECALENDAR_EVENTS_LIST]在 Python SDK 中启用事件列表工具。实际工具名以工具集枚举为准例如GOOGLECALENDAR_LIST_EVENTS、GOOGLECALENDAR_FIND_EVENT、GOOGLECALENDAR_EVENTS_LIST等。固定 Toolkit 版本Google Calendar Toolkit 支持按版本固定这直接关系到下文“过滤器被忽略”的排查。仓库文档 docs/content/docs/auth-configuration/custom-auth-params.mdx 展示了两种语言的写法Pythoncomposio Composio(toolkit_versions{googlecalendar: latest})TypeScripttoolkitVersions: { googlecalendar: latest },当遇到行为异常时应优先检查此处固定的版本将googlecalendar升级到latest或使用 v3.1/latest 行为。操作事件与可用性数据连接账号后就可以操作日历事件和查询可用性。本节整理四个高频且容易踩坑的点。RSVP 状态更新受出席者列表限制Google Calendar API 对包含多个出席者attendees的事件的 RSVP/状态更新存在限制。当事件有多个出席者时直接更新 RSVP 状态可能失败或不会生效。推荐的处理方式有两种先更新认证用户的 RSVP再重新添加出席者re-add the attendees或重新发送完整的出席者列表并携带更新后的状态。即把“更新状态”和“恢复出席者列表”拆成两个动作避免在一次调用中同时修改状态与出席者从而绕过 API 限制。需要“已处理”的可用性数据时使用 Find Free SlotsGoogle Calendar 提供两类可用性查询Find Free Slots查找空闲时间段返回经过处理processed的可用性结果例如已处理时区换算、合并连续空闲段等适合直接用于排期决策。Query Free/Busy查询忙闲状态返回的是 Google 提供的原始数据不包含额外处理例如时区处理需要调用方自行完成。因此如果你的 Agent 需要直接可用的空闲时段应优先使用 find-free-slots 工具若使用 free/busy 原始数据则必须在业务侧补齐时区与数据后处理逻辑。使用primary作为日历 IDGoogle Calendar 工具的calendarId参数应使用类似primary的合法日历 ID。me不是合法的 Google Calendar ID传入会导致调用失败。CLI 示例docs/content/docs/cli.mdx中即使用了calendar_id: primary来执行GOOGLECALENDAR_FIND_EVENTexecute(GOOGLECALENDAR_FIND_EVENT, { calendar_id: primary })会议链接从hangout_link读取创建或更新带会议conferencing功能的日历事件后生成的会议 URL 位于响应体中的hangout_link字段。请勿从其他字段猜测会议地址务必以hangout_link为准。典型用法创建事件后读取hangout_link将其发送给参会者或写入 Agent 的对话上下文。配置 Google Calendar 触发器触发器用于在日历事件发生变化时自动触发你的工作流。Google Calendar 相关的触发器配置需要注意以下几点。取消/删除事件触发器当事件被取消或删除时GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER会发送一个 payload。你的工作流应订阅该触发器以捕获事件被取消或删除的场景例如自动通知参会者或释放资源。同一用户、同一触发器 slug 可针对不同日历创建多个实例Composio 支持同一触发器 slug、同一用户下创建多个触发器实例前提是每个实例配置了不同的calendarId。也就是说你可以为多个日历分别创建各自的新事件触发器它们互不冲突。每个实例只需在配置中指定各自的calendarId即可。新触发器返回完整事件数据较新的 Google Calendar新事件触发器new-event trigger的 payload 包含完整事件数据而不再仅仅是事件 ID。这一变化的背景是Google Calendar 触发器行为从webhook 式投递逐步转向轮询polling因此 payload 可以携带更多细节调用方后续需要的补充处理follow-up processing例如回查事件详情更少。需要特别注意的是现有触发器流程在演进过程中被保留轮询能力是按需单独引入的。也就是说不同时间创建的触发器实例可能表现出不同的 payload 形态如果你的工作流依赖“完整事件数据”请确认所用触发器实例使用的是新版行为。以编程方式获取触发器元数据可以使用trigger-types 端点以编程方式获取 Google Calendar 触发器元数据包括触发器 slug、所需参数、payload 结构等搭建触发器前可先通过该端点查询可用触发器类型。具体的搭建指引请参考仓库中的触发器文档例如 docs/content/docs/setting-up-triggers/ 目录下的相关指南。对于需要自行注册回调地址的实时触发器还可参考 docs/content/docs/setting-up-triggers/custom-oauth-webhooks.mdx 中关于 webhook 端点的说明。排查事件过滤器被忽略症状修改timeMin、timeMax等过滤器后返回结果与修改前完全相同仿佛过滤器从未生效。根因较早固定pinned的 Google Calendar Toolkit 版本可能会在请求到达 Google 之前丢弃或重映射这些过滤器例如timeMin、timeMax导致 Google 侧实际没有收到过滤条件结果自然不变。解决方案升级到最新的 Google Calendar Toolkit 版本如toolkit_versions{googlecalendar: latest}或使用v3.1 / latest 行为对应 API 版本指南见 docs/lib/api-version.ts 相关的版本说明。升级后重新执行同样的过滤查询确认timeMin/timeMax等参数确实生效。小结主题要点账号连接创建googlecalendar认证配置 → 连接账号 → 通过 connected account 调用工具/触发器OAuth Scope事件读写需包含https://www.googleapis.com/auth/calendar.eventsRSVP 更新多出席者事件受 API 限制先更新本人 RSVP 再重加出席者可用性查询需要已处理结果用 Find Free Slotsfree/busy 需自行处理时区日历 ID使用primaryme无效会议链接从响应hangout_link字段读取取消/删除事件订阅GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER多日历触发器同一 slug/用户下按不同calendarId创建多个实例触发器 payload新版返回完整事件数据行为正从 webhook 向轮询演进过滤器失效升级 toolkit 到 latest或使用 v3.1/latest 行为以上内容均对应 Composio 仓库中的支持知识文档docs/kb/articles/toolkits-google-calendar.md及其源稿 docs/kb/source/toolkits/google_calendar/public.md并辅以仓库中的 SDK 示例、CLI 示例与配置文档佐证可作为接入与排障时的直接参考。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
