用途:Fidel 是金融基础设施 API,允许开发者连接用户的信用卡和借记卡,用于构建消费管理、忠诚度计划、个性化财务洞察等功能,面向金融科技、银行和零售行业。官方文档:https://fidel.uk/docs/。
主要对象:Merchant、Transaction、Program、Authorization、Insight。
使用方式:本技能通过 Membrane CLI 与 Fidel 交互,自动处理认证与凭据刷新。先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>。无头环境会打印授权 URL,用户在浏览器完成登录后,用 membrane login complete <code> 完成。任何命令加 --json 可输出机器可读 JSON。
连接:membrane connection ensure "https://fidel.uk/" --json,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,轮询 npx @membranehq/cli connection get <id> --wait --json,直到 READY。CLIENT_ACTION_REQUIRED 表示用户或代理需执行操作,clientAction.type 可为 connect 或 provide-input。
查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。
运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json;传 JSON 参数:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json;结果在响应的 output 字段。
代理请求:当现有动作不覆盖用例时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接请求 Fidel API,Membrane 自动补全 base URL 并注入认证头。常用选项:-X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
最佳实践:优先用 Membrane 与外部应用通信;先发现再构建,先运行 action list --intent=QUERY 查找已有动作,避免写自定义 API 调用;不要让用户提供 API 密钥或令牌,改用连接,Membrane 在服务端管理完整认证生命周期,不保存本地密钥。
限制:资料未提供 Fidel 的具体收费、价格、速率限制和可用动作清单,这些暂未提供。