用途:该技能用于通过 Membrane CLI 与 CommCare 平台交互。CommCare 是面向社区健康工作者和现场人员的移动数据采集与服务交付平台,常用于资源有限环境下的客户跟踪与支持。官方文档见 https://commcare-hq.readthedocs.io/。
主要能力:可管理 CommCare 中的多种对象,包括 Case、表单、应用、用户、群组、位置、移动工作者、Web 用户、库存与供应点、查找表、报表、SMS、导出等。内置常用动作如 list-cases、create-case、update-case、get-case、list-forms、get-form、list-applications、get-application、list-locations、list-groups、list-mobile-workers、list-web-users、list-fixtures、list-location-types 等。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://www.dimagi.com/commcare/" --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。也可通过代理直接请求 API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。
适用场景:需要读取或写入 CommCare 数据、批量导出、管理用户与位置、自动化表单与 Case 工作流时。
限制:认证与凭据刷新由 Membrane 处理,不应向用户索取 API 密钥;具体动作参数与返回结构需以实际查询结果为准。资料未提供收费、价格、平台支持范围及效果保证等信息。