用途:该技能用于让 AI 代理与 Box 云内容管理与文件共享服务交互,管理文件夹、用户、组、协作、文件、文件版本、网页链接、任务、事件和搜索等数据。
主要能力:通过 Membrane CLI 调用预构建的 Box 操作,支持以自然语言意图搜索可用操作,并可在操作不足时通过代理直接请求 Box API。Membrane 负责认证与凭证刷新,无需向用户索取 API 密钥或令牌。
使用方式:安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。建立连接:membrane connection ensure "https://www.box.com/home" --json;连接处于 BUILDING 状态时用 npx @membranehq/cli connection get <id> --wait --json 轮询。搜索操作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行操作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。代理请求:membrane request CONNECTION_ID /path/to/endpoint,可选 -X、-H、-d、--json、--query、--pathParam 等参数。所有命令加 --json 可获得机器可读输出。
适用场景:需要以集成方式读取或操作 Box 中的文件、文件夹、用户、组、协作、任务与搜索结果的自动化流程。
限制:依赖 Membrane CLI 与有效连接;部分操作需在浏览器中完成认证;BLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 等状态需按提示处理;具体可用操作与参数以实际搜索返回为准,官方资料未提供完整操作清单与收费信息。