SuperAPI AI 工具集

balena

数据与分析

查看项目

更新于 10-16 00:25

技能介绍

Balena 是部署和管理 IoT 设备群的平台,开发者与企业可用它远程更新和监控运行 Linux 的设备。官方文档:https://www.balena.io/docs/。

该技能通过 Membrane CLI 与 Balena 交互,Membrane 自动处理认证与凭证刷新。相关对象包括 Application、Release、Device、Device Service、Environment Variable,可按需使用对应的 action 名称和参数。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。然后登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,完成登录后用 membrane login complete <code> 收尾;加 --json 可得机器可读输出。

建立连接:membrane connection ensure "https://www.balena.io/" --json,用户在浏览器完成认证,输出含 connection id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪;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 字段。

当现有动作不覆盖需求时,可通过代理直接请求 Balena API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项,Membrane 自动补全 base URL 并注入认证头。

限制与说明:应优先使用 Membrane 预建动作以获得内置认证、分页与错误处理;先发现再构建;不要向用户索取 API key,改用连接管理凭证。资料未提供具体平台支持范围、收费与价格等信息。