SuperAPI AI 工具集

cloudflare-r2

部署与运维

查看项目

更新于 10-16 00:25

技能介绍

用途:该技能让 AI 代理以 Membrane CLI 与 Cloudflare R2(对象存储服务)交互,用于管理数据、记录并自动化工作流。资料提到涉及的概念包括存储桶(Bucket)、对象(Object)、账户(Account)和 API Key。

主要能力:通过 membrane 命令查找并运行针对某连接的预置动作(action),支持的字段包括 id、name、description、inputSchema、outputSchema;当预置动作无法覆盖需求时,可通过 Membrane 代理直接向 Cloudflare R2 API 发送请求,Membrane 会自动拼接基础 URL 并注入认证头,凭证过期时透明刷新。官方文档为 https://developers.cloudflare.com/r2/。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,其中 agentType 可为 claude、openclaw、codex、warp、windsurf 等;无交互环境时会打印授权 URL,用户完成后用 membrane login complete <code> 收尾。建立连接:membrane connection ensure "https://www.cloudflare.com/products/r2/" --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 --json,参数用 --input '{"key": "value"}' 传入,结果在 output 字段。代理请求:membrane request CONNECTION_ID /path/to/endpoint,可加 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。

适用场景:需要以自然语言意图检索动作、对 R2 数据做管理或自动化,以及在不编写自定义 API 调用的情况下完成对象存储相关操作时。

限制:资料说明认证为浏览器授权或授权 URL 流程,凭证由 Membrane 服务端管理,不应向用户索取 API key 或 token;状态可能为 READY、CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR、SETUP_FAILED 等,需按提示处理。具体动作清单、权限范围、配额与计费信息暂未提供。