ttawdtt Google Workspace Skill for DeepAgents
本技能文件向 DeepAgents 说明如何通过 google_workspace 工具与用户的 Google 账号交互。
能力概览
- 读取 Gmail 邮件列表与邮件内容。
- 读取 Google Drive / Docs / Sheets / Slides 元数据。
- 在写权限开启时，可以执行写操作（例如创建文档、发送邮件等），但需要遵守安全策略。
使用约定
所有操作都通过
google_workspace工具完成，使用action字段区分具体功能：- 读能力示例：
auth_status：检查认证与 scope。gmail_list/gmail_get：列出或读取邮件。drive_list：列出 Drive 文件。
- 写能力示例（仅在 Aelin 策略允许时使用）：
docs_create：创建 Google 文档。- 后续可能扩展的
gmail_send、calendar_create_event等。
- 读能力示例：
在尝试写操作前，应先调用
auth_status检查：- 用户是否已登录。
- 是否具备所需 scope（如
documents、drive等）。
写操作需要遵守以下原则：
- 只在用户明确要求时创建或修改内容（例如「帮我创建一个 Google 文档」）。
- 文档、事件、邮件的标题与内容应简洁、可读，并用用户的语言回答。
如果出现权限不足或配置错误：
- 工具会返回
ok: false和error字段。 - 应向用户解释无法完成的原因，并给出下一步建议（例如要求用户在本地完成登录）。
- 工具会返回