企业官网建设流程全解析

Composio Google Slides 工具包使用指南：发现、读取、创建与连接 Google 幻灯片

【免费下载链接】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 Slides 工具包，系统讲解如何通过 Google Drive 发现并读取演示文稿、将演示文稿 ID 传给GOOGLESLIDES_PRESENTATIONS_GET、通过 Google Super 创建演示文稿、配置 OAuth 作用域与触发器。阅读完本文，你将掌握一套可直接落地到 AI Agent 工作流中的 Google Slides 集成方案。

一、Google Slides 工具包概览

根据 toolkits.json 中的元数据，Composio 的 Google Slides 工具包（slug：googleslides）分类为 documents，认证方式为OAUTH2，同时支持 Composio 托管认证（composioManagedAuthSchemes）。目前该工具包包含 8 个工具和 1 个触发器，当前版本号为20260826_00。

工具包内已提供的工具包括：

• GOOGLESLIDES_CREATE_PRESENTATION：创建空白演示文稿，可指定标题、语言和页面尺寸；
• GOOGLESLIDES_CREATE_SLIDES_MARKDOWN：从 Markdown 文本创建演示文稿，自动按---分隔符拆分为多页并套用模板；
• GOOGLESLIDES_GET_PAGE_THUMBNAIL2：生成指定页面的缩略图预览 URL；
• GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE：通过 Markdown 或原始 API 文本批量更新演示文稿，支持主题、自动格式化及多类页面（标题、要点、表格、引用、图片、双栏）；
• GOOGLESLIDES_PRESENTATIONS_COPY_FROM_TEMPLATE：基于模板复制演示文稿，保留主题、母版与版式；
• GOOGLESLIDES_PRESENTATIONS_GET：获取指定演示文稿的最新版本；
• GOOGLESLIDES_PRESENTATIONS_PAGES_GET：获取演示文稿中指定页面的详情；
• GOOGLESLIDES_PRESENTATIONS_PAGES_GET_THUMBNAIL：获取页面缩略图。

需要注意的是，这个工具列表来自当前仓库快照，具体可用工具集合与版本以你使用的实际 SDK 或 MCP 环境为准。

二、发现并读取 Google Slides 演示文稿

1. 通过 Google Drive 发现演示文稿

Google Slides 没有提供独立的"列出全部演示文稿"端点。因此，在 Composio 中要发现演示文稿，正确做法是使用GOOGLEDRIVE_FIND_FILE，并用 Drive 的q参数按 MIME 类型过滤：

mimeType = 'application/vnd.google-apps.presentation'

把过滤结果返回的演示文稿 ID 传入 Google Slides 工具即可。这一方式与 Google Drive 工具包文档 中描述的"用 Drive 搜索发现文件"的模式一致：Drive 搜索负责枚举，Slides 工具负责消费 ID。

2. 将演示文稿 ID 传给GOOGLESLIDES_PRESENTATIONS_GET

GOOGLESLIDES_PRESENTATIONS_GET的入参是 Google Slides 演示文稿 ID。获取该 ID 有两种途径：

• 从演示文稿的 URL 中提取（URL 形如https://docs.google.com/presentation/d/<presentation_id>/edit）；
• 使用GOOGLEDRIVE_FIND_FILE发现演示文稿时返回的 ID。

得到 ID 后，将其作为参数传入GOOGLESLIDES_PRESENTATIONS_GET即可拉取演示文稿的最新版本（工具包元数据中该工具的描述即为"Retrieve the latest version of a presentation"）。

3. 发现与读取必须使用同一个 Google 账户

当工作流先用GOOGLEDRIVE_FIND_FILE发现演示文稿、再用GOOGLESLIDES_PRESENTATIONS_GET读取时，必须确保连接的 Google Drive 账户和 Google Slides 账户是同一个账户。否则会出现"Drive 发现时 ID 有效、但 Slides 连接无权访问"的问题。排查时可参考 Google Drive 文档中的做法：对连接账户 ID 调用GOOGLEDRIVE_GET_ABOUT，确认当前使用的 Drive 账户身份是否与预期一致（见 toolkits-googledrive）。

三、创建演示文稿：使用 Google Super 工具包

创建类功能在 Composio 中归属于 Google Super 工具包，而不是通过 Google Slides 工具包"硬造"原生 Slides 文件。

核心结论：对创建演示文稿的工作流，应使用 Google Super 中的相关工具，不要尝试通过通用的 Drive 文本上传来生成原生 Google Slides 文件——Drive 的纯文本上传无法创建原生演示文稿。

Google Super 是一个覆盖 Google Workspace 多个服务的统一（superset）工具包，一个连接即可覆盖 Gmail、Google Calendar、Google Meet 及相关 Google API（见 toolkits-googlesuper）。因此：

1. 为 Google Super 连接配置好所需的 Google Slides 相关作用域；
2. 使用 Google Super 中的演示文稿创建工具完成创建；
3. 创建完成后，把返回的演示文稿 ID 交给GOOGLESLIDES_PRESENTATIONS_GET或GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE进行读取与内容更新。

该分工方式也在仓库的变更记录中得到印证：Google Slides 相关工具被归入 Google Super 工具包的变更可见于 changelog/12-31-25.mdx。

四、连接与认证：OAuth 作用域与自定义应用校验

1. 自定义 Google OAuth 应用必须通过敏感作用域校验

如果使用自定义的 Google 开发者应用来对接 Google Slides，该应用必须针对其请求的敏感 Google 作用域完成 Google 的验证（verification）。若未通过验证，Google 可能会在 OAuth 授权确认流程中阻止或弹出警告。

这与 Composio 文档中 Google 系工具包的通用认证指引一致（见 Google Drive 工具包文档）：

• 在客户自己的 Google Cloud OAuth 应用中配置并验证所需作用域，然后把这些凭据用于 Composio 的 auth config；
• 确认 auth config 只请求预期的作用域，避免过度授权；
• 优先选择能支撑工作流的最小作用域（例如drive.file仅允许访问应用创建或用户显式授权的文件；需要全盘访问的工作流才考虑drive作用域）。

2. 通过 Composio 托管认证快速接入

Google Slides 工具包同时支持OAUTH2的 Composio 托管认证。也就是说，你可以不配置自定义 Google 开发者应用，直接使用 Composio 托管认证完成 OAuth 授权，再连接账户使用工具。如果业务对作用域、品牌或审批流有特殊要求，再切换到客户自有凭据。

五、触发器支持

Google Slides 在 Composio 中被列为支持触发器的工具包，目前提供 1 个触发器（toolkits.json 中triggerCount: 1亦可佐证）。触发器的使用遵循 Composio 平台统一的触发器配置流程：在启用触发器的工具包下创建连接、按需开启对应触发器并监听事件回调。具体到 Google Slides 的这一个触发器支持何种事件类型，以平台当前返回的工具包元数据为准。

六、典型工作流汇总

综合以上内容，可以构建如下典型工作流：

读取类工作流（Agent 需要分析已有 PPT）

1. 连接 Google Drive 与 Google Slides（确保同一个账户）；
2. 调用GOOGLEDRIVE_FIND_FILE，q设为mimeType = 'application/vnd.google-apps.presentation'；
3. 取返回的演示文稿 ID；
4. 调用GOOGLESLIDES_PRESENTATIONS_GET读取内容。

创建类工作流（Agent 需要生成新 PPT）

1. 通过 Google Super 连接创建演示文稿；
2. 得到演示文稿 ID 后用GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE填充内容（Markdown 或批量更新）；
3. 需要基于模板时，用GOOGLESLIDES_PRESENTATIONS_COPY_FROM_TEMPLATE复制模板再替换占位内容。

易错点清单

• Drive 发现与 Slides 读取必须同一账户；
• 创建演示文稿走 Google Super，不走 Drive 文本上传；
• 自定义 OAuth 应用需通过敏感作用域验证；
• auth config 只请求必要的最小作用域。

七、相关资源

• 知识库原文：toolkits-googleslides.md
• 支持知识源头：public.md
• Google Drive 工具包指南（发现、认证、作用域细节）：toolkits-googledrive.mdx
• Google Super 工具包指南（创建与统一连接）：toolkits-googlesuper.mdx
• 工具包元数据（工具、触发器、版本号）：toolkits.json

【免费下载链接】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