用途:该技能用于让 AI 代理与 Cloudinary 云媒体管理平台交互,管理媒体数据、记录并自动化工作流。Cloudinary 是云端媒体管理平台,帮助开发者与营销人员存储、优化和交付图片与视频。
主要能力:通过 Membrane 预置动作操作 Cloudinary,涵盖资产(Asset)、标签(Tags)、元数据(Metadata)、转换(Transformations)、上传(Uploads)等对象。常见动作包括:列出标签(list-tags)、生成归档(generate-archive)、列出转换(list-transformations)、获取用量(get-usage)、创建/删除文件夹(create-folder、delete-folder)、列出根文件夹(list-folders)、更新资源(update-resource)、获取资源(get-resource)、列出视频(list-videos)、列出图片(list-images)、搜索资产(search-assets)、重命名资产(rename-asset)、销毁资产(destroy-asset)、从 URL 上传资产(upload-asset)。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://cloudinary.com/" --json,若状态为 BUILDING 则用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。动作未覆盖时可经代理直接请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要以编程或代理方式批量管理 Cloudinary 媒体资产、查询用量、整理文件夹与标签、执行搜索与上传等任务。
限制:认证与凭据由 Membrane 服务端管理,不应向用户索取 API 密钥或令牌;具体动作参数与返回结构以 inputSchema、outputSchema 为准。官方文档见 https://cloudinary.com/documentation。其他细节暂未提供。