用途
Amilia 是一个面向休闲活动机构的注册与管理平台，被社区中心、体育俱乐部、营地等组织用来处理在线报名、排期和支付。本技能用于将 Amilia 与 AI 代理集成，让代理能够与 Amilia 的数据交互，完成管理数据、记录和自动化工作流等任务。当用户希望操作 Amilia 数据时，可使用本技能。
主要能力
技能定义了可操作的对象范围，包括：账户（Account）、联系人（Contact）、家庭（Family）、成员（Member）、活动（Activity）、场次（Session）、地点（Location）、产品（Product）、事件（Event）、交易（Transaction）、发票（Invoice）和报表（Report）。具体调用时按需使用动作名称和参数。
技能通过 Membrane CLI 与 Amilia 交互。Membrane 会自动处理认证与凭据刷新，因此使用方只需关注集成逻辑本身。
文档中列出的一些常用动作为：获取账户（get-account）、列出账户（list-accounts）、列出注册（list-registrations）、获取注册（get-registration）、获取人员（get-person）、列出人员（list-persons）、列出活动（list-activities）、获取活动（get-activity）、获取项目（get-program）、列出项目（list-programs）、列出组织（list-organizations）、获取组织（get-organization）等，每个动作包含 id、name、description、inputSchema 和 outputSchema。
使用方式
安装 CLI
npm install -g @membranehq/cli@latest
认证
membrane login --tenant --clientName=<agentType>
该命令会打开浏览器进行认证，或在无法交互时打印授权 URL。无头环境下，需让用户在浏览器中打开授权 URL，取得代码后执行：
membrane login complete <code>
任意命令加 --json 可获得机器可读的 JSON 输出。Agent Types 包括 claude、openclaw、codex、warp、windsurf 等。
连接 Amilia
使用 membrane connection ensure 按应用 URL 或域名查找或创建连接：
membrane connection ensure "https://www.amilia.com/" --json
用户在浏览器中完成认证后，输出中会包含新的 connection id。如果返回的连接 state 为 READY，可直接进入下一步。若处于 BUILDING 状态，则轮询等待：
npx @membranehq/cli connection get <id> --wait --json
状态含义：READY 表示连接已就绪；CLIENT_ACTION_REQUIRED 表示需要用户或代理执行操作（如 connect、provide-input，附有 description、可选 uiUrl 和 agentInstructions）；CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错，需查看 error 字段。
搜索动作
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
应在特定连接的上下文中搜索动作。
运行动作
membrane action run <actionId> --connectionId=CONNECTION_ID --json
传入 JSON 参数：
membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
结果位于响应的 output 字段。
代理请求
当现有动作无法覆盖需求时，可通过 Membrane 代理直接向 Amilia API 发送请求：
membrane request CONNECTION_ID /path/to/endpoint
常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。Membrane 会自动补全基础 URL 并注入正确的认证头，凭据过期时透明刷新。
适用场景
适用于需要以程序化或代理方式访问 Amilia 数据的组织，例如查询与列出账户、人员、活动、项目、注册、组织信息，或通过代理请求调用 Amilia API 完成自定义操作。
限制与注意事项
使用时应优先选择 Membrane 而非直接与外部应用通信，因为 Membrane 提供带内置认证、分页和错误处理的预置动作，可减少 token 消耗并提升安全性。建议先发现再构建：运行 membrane action list --intent=QUERY 查找已有动作，再考虑编写自定义 API 调用。让 Membrane 管理凭据，不要向用户索取 API 密钥或令牌，而是创建连接；Membrane 在服务端管理完整的认证生命周期，本地不保存密钥。
官方文档地址：https://developers.amilia.com/reference