SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场asavie

asavie

通用与其它

查看项目

更新于 10-16 02:07

技能介绍

Asavie 集成（Asavie integration）用于管理数据、记录并自动化工作流。当用户希望与 Asavie 数据交互时使用本技能。

用途 Asavie 为企业提供面向移动办公人员和物联网（IoT）设备的安全、托管连接解决方案，适用于需要管理并保护远程员工与联网设备数据访问的企业，可视作 VPN 与移动设备管理平台的结合。本技能即用于通过 Membrane CLI 与该平台交互。官方文档地址：https://www.asavie.com/developer-portal/

主要能力 本技能覆盖 Asavie 的多种对象，包括：Profile、Device、SIM、Data Plan、Alert、User、Group、Application、Firewall Rule、Web Filter Profile、Web Filter Override、Trusted Location、Tunnel、Policy、Report、Audit Log、Support User、API Key、Authentication Source、LDAP Mapping、Notification、Branding、Role、Terms of Service、Privacy Policy、Mobile Threat Defense Configuration、System Setting、License、Hotspot、Sponsor、Voucher、Splash Page、Network、Subscriber、Usage Quota、Rate Plan、Payment、Invoice、Credit Note、Debit Note、Tax Rate、Currency、Gateway、Message Template、SMS、MMS、USSD、Number、Short Code、Keyword、Campaign、List、Segment、Form、Workflow、Integration、File、Folder、Shared Link。可按需使用相应的 action 名称与参数。

使用方式 本技能通过 Membrane CLI 与 Asavie 交互，Membrane 会自动处理认证与凭证刷新，因此可专注于集成逻辑而非认证管道。

安装 CLI： npm install -g @membranehq/cli@latest

认证： membrane login --tenant --clientName=<agentType> 该命令会打开浏览器进行认证，或在无交互模式可用时向控制台打印授权 URL。无头环境（Headless）下会打印授权 URL，需请用户在浏览器中打开；用户完成登录后会看到验证码，随后执行： membrane login complete <code> 任意命令添加 --json 可获得机器可读的 JSON 输出。Agent Types 包括 claude、openclaw、codex、warp、windsurf 等，用于针对所用框架调整工具。

连接到 Asavie： 使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接： membrane connection ensure "https://www.asavie.com/" --json 用户在浏览器中完成认证，输出包含新的 connection id。该 URL 会被规范化到域名并与已知应用匹配；若未找到应用，则会创建应用并自动构建连接器。若返回的连接 state 为 READY，可直接进入下一步。

等待连接就绪（1b）：若连接处于 BUILDING 状态，可轮询直到就绪： npx @membranehq/cli connection get <id> --wait --json --wait 标志会进行长轮询（最长 --timeout 秒，默认 30）直到状态变化，需持续轮询直到 state 不再是 BUILDING。状态含义：

  • READY：连接已完全建立，进入下一步。
  • CLIENT_ACTION_REQUIRED：用户或代理需执行操作，clientAction 对象描述所需操作。clientAction.type 为所需操作类型："connect" 表示用户需认证（OAuth、API key 等），涵盖初始认证及断连后的重新认证；"provide-input" 表示需要更多信息（如连接到哪个应用）。clientAction.description 为人类可读的说明；clientAction.uiUrl（可选）为预构建 UI 的 URL，存在时应展示给用户；clientAction.agentInstructions（可选）为 AI 代理以编程方式继续的指令。用户完成操作后，再次轮询 membrane connection get <id> --json 检查状态是否变为 READY。
  • CONFIGURATION_ERROR 或 SETUP_FAILED：出现错误，检查 error 字段获取详情。

搜索动作：使用自然语言描述想要执行的操作： membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 应始终在特定连接的上下文中搜索动作。每个结果包含 id、name、description、inputSchema（动作接受的参数）与 outputSchema（返回值）。 也可使用：npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 来发现可用动作。

运行动作： membrane action run <actionId> --connectionId=CONNECTION_ID --json 传入 JSON 参数： membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json 结果位于响应的 output 字段中。

代理请求：当可用动作无法覆盖用例时，可通过 Membrane 的代理直接向 Asavie API 发送请求。Membrane 会自动将基础 URL 追加到提供的路径，并注入正确的认证头，包括凭证过期时的透明刷新： membrane request CONNECTION_ID /path/to/endpoint 常用选项：-X/--method 指定 HTTP 方法（GET、POST、PUT、PATCH、DELETE），默认 GET；-H/--header 添加请求头（可重复），如 -H "Accept: application/json"；-d/--data 请求体（字符串）；--json 作为发送 JSON body 并设置 Content-Type: application/json 的简写；--rawData 按原样发送 body 不做处理；--query 查询字符串参数（可重复），如 --query "limit=10"；--pathParam 路径参数（可重复），如 --pathParam "id=123"。

最佳实践

  • 始终优先使用 Membrane 与外部应用通信：Membrane 提供内置认证、分页与错误处理的预构建动作，可减少 token 消耗并提升通信安全性。
  • 先发现再构建：运行 membrane action list --intent=QUERY（将 QUERY 替换为意图）查找现有动作，再编写自定义 API 调用；预构建动作可处理原始 API 调用容易遗漏的分页、字段映射与边界情况。
  • 让 Membrane 处理凭证：不要向用户索取 API key 或 token，而应创建连接；Membrane 在服务端管理完整的认证生命周期，不在本地保存密钥。

适用场景 适用于用户希望与 Asavie 数据进行交互、管理其平台对象与记录并自动化相关工作流的场景。

限制 除上述通过 Membrane CLI 的交互方式外，本技能未提供更多关于 Asavie 平台自身功能、收费、价格或平台范围的信息。