用途:该技能用于让 AI 代理通过 Membrane CLI 与 Retriever 数据交互,可管理 Organizations、Leads、Projects、Pipelines、Users、Filters 等对象,适合需要与 Retriever 数据交互的用户。
主要能力:通过 Membrane 预置动作搜索并执行操作,支持按自然语言意图发现动作;当预置动作不足时,可通过 Membrane 代理直接向 Retriever API 发送请求,自动处理基础 URL、认证头及凭证刷新。
安装与认证:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。无头环境会打印授权 URL,完成后运行:membrane login complete <code>。所有命令可加 --json 获取机器可读输出。
连接:使用 membrane connection ensure "https://helloretriever.com/" --json 查找或创建连接,由用户在浏览器完成认证。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询直至 READY;若为 CLIENT_ACTION_REQUIRED 等状态,按提示处理。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 搜索动作;membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 执行动作,结果在 output 字段。代理请求示例:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项。
限制与注意:官方文档为 https://retriever-docs.readthedocs.io/en/latest/;资料未提供具体动作清单、定价、平台覆盖或效果数据。应优先使用 Membrane 预置动作而非自行拼装 API 调用,且不要向用户索取 API 密钥,认证由 Membrane 在服务端管理。