谷歌文档助手

要解决什么问题

在对话式 Agent 或自动化流程里，经常需要按标题创建文档、按关键词检索已有 Doc、用 Markdown 整篇覆盖正文、批量查找替换占位符，或把文档导出为 PDF、从模板复制一份再填内容。直接对接 Google Docs API 要处理 OAuth、请求体结构和 Drive 搜索语法，成本高。

本技能通过 Rube MCP（Composio 的 googledocs 工具包）把上述操作收敛成一组命名清晰的工具调用；前提是客户端已接入 Rube，且对 googledocs 的连接状态为 ACTIVE（未完成授权前不要跑写操作）。

核心能力与典型流程

工作流上应先用 RUBE_SEARCH_TOOLS 拉取当前工具 schema，再确认连接。常用动作包括：

• 新建：GOOGLEDOCS_CREATE_DOCUMENT（title、text）
• 搜索：GOOGLEDOCS_SEARCH_DOCUMENTS（query 使用 Drive 搜索语法，如 name contains 'report'）
• 按 ID 读取：GOOGLEDOCS_GET_DOCUMENT_BY_ID
• Markdown 重写全文：GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
• 全文替换：GOOGLEDOCS_REPLACE_ALL_TEXT
• 按索引插入：GOOGLEDOCS_INSERT_TEXT_ACTION（可 append_to_end: true）
• 底层 batch 编辑：GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT（需自行构造 editDocs）
• 导出 PDF：GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
• 复制文档：GOOGLEDOCS_COPY_DOCUMENT

常见组合：先搜再改（搜索拿 document_id 再 Markdown 更新或替换）；模板复制（COPY + REPLACE_ALL_TEXT）；读后改（GET + UPDATE_EXISTING_DOCUMENT）。分享可与 googledrive 工具包的 GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE 配合。

工具参考文档：composio.dev/toolkits/googledocs

边界与坑点

• GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN 替换整篇内容，不是追加；局部改动用插入或 REPLACE_ALL_TEXT。
• GOOGLEDOCS_INSERT_TEXT_ACTION 依赖准确的 insertion_index；不确定位置时用末尾追加更安全。
• 同一文档在不同工具里可能叫 id、document_id 或 file_id，数值通常一致。
• GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT 需要按 Google Docs API 编写 batch update，结构错误会直接失败。