用途:通过 Membrane CLI 与 Beacon 客服/客户数据平台交互,管理联系人、公司、交易、任务、笔记等记录,并自动化相关流程,适合让 AI 代理读写 Beacon 数据的场景。
主要能力:可发现并运行预置 action,覆盖 Contact、Contact Note、Company、Company Note、Deal、Deal Note、Task、Note 等对象;支持通过代理直接请求 Beacon API 补充未覆盖的用例。Membrane 会自动处理认证与凭证刷新,也支持分页和错误处理。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会输出授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://beacon.by" --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"}' 传入。也可用 membrane request CONNECTION_ID /path/to/endpoint 直接代理请求,支持 -X、-H、-d、--json、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
限制:资料中 Beacon 的官方文档链接指向 Estimote Beacon 相关内容,与客服平台描述不一致,官方 API 细节暂未提供;具体可用 action 列表、字段和权限范围需以实际连接后查询结果为准。