用途:Flespi 是远程信息处理与物联网后端平台,提供设备连接、数据存储和分析能力,面向物联网方案提供商与系统集成商,用于构建和管理 telematics 解决方案。本技能通过 Membrane CLI 连接 Flespi,用于管理数据、记录并自动化工作流,适合需要与 Flespi 数据交互的场景。
主要能力:资料列出的实体包括 Device、Messages、Channel、Messages、Stream、Calculations、Token。可通过 Flespi API 通道访问这些资源。Membrane 负责身份验证与凭据自动刷新,用户无需自行处理鉴权。
使用方式:
- 安装 CLI:npm install -g @membranehq/cli@latest
- 登录:membrane login --tenant --clientName=<agentType>。无界面环境会打印授权 URL,用户在浏览器完成后执行 membrane login complete <code>。任意命令加 --json 可输出机器可读 JSON。
- 建立连接:membrane connection ensure "https://flespi.com/" --json。若状态为 BUILDING,可轮询 membrane connection get <id> --wait --json,直到不再为 BUILDING。READY 表示就绪;CLIENT_ACTION_REQUIRED 需按 clientAction 提示操作(如 connect 需在浏览器认证);CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。
- 搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。
- 运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json;传参用 --input '{"key": "value"}',结果在响应的 output 字段。
- 代理请求:membrane request CONNECTION_ID /path/to/endpoint,可选 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。Membrane 会自动拼接基础 URL 并注入鉴权头,凭据过期会透明刷新。
适用场景:与 Flespi 平台的数据、记录交互及工作流自动化,例如查询设备、消息、通道、流、计算与令牌相关数据。建议先搜索已有动作再自建调用。
限制:官方文档为 https://flespi.com/docs。资料未提供各动作的具体参数、字段、错误码细节、计费或平台限制,也未给出完整动作清单;上述能力以官方文档为准。不要向用户索取 API 密钥或令牌,应通过创建连接由 Membrane 管理凭据。