SuperAPI AI 工具集

google-workspace

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

用途:在 Google Drive 中查找文件,读取或编辑 Google Docs 和 Sheets。属于内置工具,应直接调用随技能提供的工具 schema,或使用随附的 code_exec 导入;reload_mcp 不管理这些工具。

权限与访问:需要 Docs 或 Sheets 的 Read 权限才能读取,Read and Write 才能创建或编辑。若需授权,应给出完整步骤,包括 Request Access 与 Google 同意屏幕,不能只让用户“启用 Docs”。工具缺失时无法区分账号未连接与权限不足,不要断言原因,也不要声称可自行授予访问权限。粘贴的 Docs 或 Sheets 链接不代表公开可访问;应使用已连接服务,其工具缺失时给出授权说明,而非尝试未认证的网络请求。用户明确说明文件公开或发布到网页时,可进行网页读取。按名称查找、搜索内容、以文本读取文档需要 Drive Read;仅 Docs 或 Sheets 链接只需对应服务权限,不需 Drive 权限。

工作流:Google URL 中 /d// 段为文件 ID,/folders/ 段为文件夹 ID。按名称搜索示例:trashed = false and name contains 'Budget'。Drive 搜索返回元数据而非内容,匹配正文需在查询中用 fullText contains。列出文件夹用 '' in parents,子文件夹需单独查询;若结果提示无法读取文件夹,请用户将其共享给已连接账号。

读取与编辑:先用 Docs 和 Sheets 各自工具读取,它们返回写入工具所需结构。文档读取因大小限制失败时,将同一文件 ID 传给 google_drive_download,导出为 Markdown 并返回有效期 24 小时的临时认证下载 URL,用 amp files get -o .amp/in/ 下载后读取本地文件,不要提交。对于 Docs 和 Sheets 工具无法读取的文件,如上传的 PDF、图片和 Office 文档按原样下载,Slides 和 Drawings 导出为文本和 PNG;可传 exportMimeType 导出 Google 支持的其他格式。PDF 和图片用 view_media 读取;大量 PDF 或 DOCX 可用 python3 -m venv 配合 pymupdf 或 python-docx 提取文本,扫描件与多栏页面需对照渲染页面检查。更新前先读取,Docs 读取包含标签页,batchUpdate 应定位目标标签页并传入该次读取的 revision ID;revision 过期需重新读取。Sheets 先读元数据找标签页名,再读有界 A1 范围。值默认 RAW,仅在需要公式或区域解析时用 USER_ENTERED。仅在用户要求创建或更改文件时使用写入工具;写入失败且结果不明时,先读取再重试。

适用场景与限制:适合查找、读取、搜索、导出和编辑 Google Drive 中的 Docs、Sheets 及部分其他文件。限制包括需先连接服务并授予相应权限,工具缺失时无法判断具体原因,也不能自行授权;Drive 搜索只返回元数据;下载链接仅 24 小时有效;不提交下载文件。其他收费、价格、平台等信息暂未提供。