name: google_admin-automation description: “通过Rube MCP (Composio)自动化Google Admin任务:用户管理、组织单位、群组和域管理。始终首先搜索工具以获取当前模式。” requires: mcp: [rube]
通过Rube MCP的Google Admin自动化
通过Composio的Google Admin工具包,通过Rube MCP自动化Google Admin操作。
工具包文档: composio.dev/toolkits/google_admin
先决条件
- Rube MCP必须连接(RUBE_SEARCH_TOOLS可用)
- 通过
RUBE_MANAGE_CONNECTIONS与工具包google_admin建立活动的Google Admin连接 - 始终先调用
RUBE_SEARCH_TOOLS以获取当前工具模式
设置
获取Rube MCP: 在客户端配置中添加https://rube.app/mcp作为MCP服务器。无需API密钥——只需添加端点即可工作。
- 通过确认
RUBE_SEARCH_TOOLS响应来验证Rube MCP是否可用 - 调用
RUBE_MANAGE_CONNECTIONS,工具包为google_admin - 如果连接不是ACTIVE,请按照返回的身份验证链接完成设置
- 在运行任何工作流之前,确认连接状态显示为ACTIVE
工具发现
始终在执行工作流之前发现可用工具:
RUBE_SEARCH_TOOLS: queries=[{"use_case": "user management, org units, groups, and domain administration", "known_fields": ""}]
返回:
- Google Admin的可用工具标识符
- 建议的执行计划步骤
- 已知问题和边界情况
- 每个工具的输入模式
核心工作流
1. 发现可用的Google Admin工具
RUBE_SEARCH_TOOLS:
queries:
- use_case: "list all available Google Admin tools and capabilities"
在继续之前,查看返回的工具、其描述和输入模式。
2. 执行Google Admin操作
发现工具后,通过以下方式执行:
RUBE_MULTI_EXECUTE_TOOL:
tools:
- tool_slug: "<discovered_tool_slug>"
arguments: {<schema-compliant arguments>}
memory: {}
sync_response_to_workbench: false
3. 多步工作流
对于涉及多个Google Admin操作的复杂工作流:
- 使用特定用例搜索所有相关工具:
RUBE_SEARCH_TOOLS - 先执行先决步骤(例如,先获取后更新)
- 使用工具响应在步骤之间传递数据
- 使用
RUBE_REMOTE_WORKBENCH进行批量操作或数据处理
常见模式
行动前搜索
始终在创建新资源之前搜索现有资源,以避免重复。
分页
许多列表操作支持分页。检查响应中的next_cursor或page_token,直到获取完成为止。
错误处理
- 在继续之前检查工具响应是否有错误
- 如果工具失败,验证连接是否仍为ACTIVE
- 如果连接过期,通过
RUBE_MANAGE_CONNECTIONS重新认证
批量操作
对于批量操作,使用RUBE_REMOTE_WORKBENCH与run_composio_tool()在循环中,并配合ThreadPoolExecutor进行并行执行。
已知缺陷
- 始终先搜索工具:工具模式和可用操作可能会改变。永远不要在不首先通过
RUBE_SEARCH_TOOLS发现它们的情况下硬编码工具标识符。 - 检查连接状态:确保在执行任何工具之前Google Admin连接是ACTIVE。过期的OAuth令牌需要重新认证。
- 尊重速率限制:如果收到速率限制错误,请降低请求频率并实施回退。
- 验证模式:始终传递严格符合模式的参数。当返回
schemaRef而不是input_schema时,使用RUBE_GET_TOOL_SCHEMAS加载完整的输入模式。
快速参考
| 操作 | 方法 |
|---|---|
| 查找工具 | RUBE_SEARCH_TOOLS 使用Google Admin特定用例 |
| 连接 | RUBE_MANAGE_CONNECTIONS 工具包 google_admin |
| 执行 | RUBE_MULTI_EXECUTE_TOOL 使用发现的工具标识符 |
| 批量操作 | RUBE_REMOTE_WORKBENCH 与 run_composio_tool() |
| 完整模式 | RUBE_GET_TOOL_SCHEMAS 用于具有 schemaRef 的工具 |