技能介绍

要解决什么问题

在对话里直接操作 Google 相册，往往卡在 OAuth、REST 路径和批量接口上：建相册、上传单张/多张、按条件搜媒体、把已有条目归到相册，每一步 API 和参数都不一样。本技能把流程收敛到 Rube MCP（Composio 的 googlephotos toolkit），让 Agent 先查工具 schema，再走统一连接与调用约定。

技能如何工作

前置：客户端接入 https://rube.app/mcp，确认 RUBE_SEARCH_TOOLS 可用；用 RUBE_MANAGE_CONNECTIONS 绑定 googlephotos，状态为 ACTIVE 后再执行业务。每次动手前应先 RUBE_SEARCH_TOOLS 获取当前工具定义。

核心能力：

相册：GOOGLEPHOTOS_LIST_ALBUMS 列出相册；GOOGLEPHOTOS_CREATE_ALBUM / GOOGLEPHOTOS_GET_ALBUM / GOOGLEPHOTOS_UPDATE_ALBUM 创建、查询与改标题/封面
上传：GOOGLEPHOTOS_UPLOAD_MEDIA（本地文件或 url）；GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS 批量上传并可指定 albumId
整理：GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS 按过滤器检索；GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS 把已有 mediaItemIds 加入相册
增强：GOOGLEPHOTOS_ADD_ENRICHMENT 为相册位置加文字、地点等 enrichments

常见组合：先 CREATE_ALBUM 再 BATCH_CREATE_MEDIA_ITEMS；或 SEARCH_MEDIA_ITEMS 拿到 ID 后 BATCH_ADD_MEDIA_ITEMS。工具文档见 composio.dev/toolkits/googlephotos。

边界与注意点

GOOGLEPHOTOS_LIST_MEDIA_ITEMS 已弃用，列举与筛选优先 GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS；filters 需符合 Google Photos API 结构，以 schema 为准。
单文件上传：图片约 200MB 上限，超限会失败；视频另有更大限制。
albumId 须来自 LIST_ALBUMS 或 CREATE_ALBUM 返回的 opaque 字符串。
BATCH_ADD_MEDIA_ITEMS 通常只能操作本应用创建的相册或用户拥有的相册。
API 新建的媒体项可能在 Web UI 中延迟出现（处理时间）。