用途:Kontomatik 是一款金融数据聚合工具,允许用户安全连接银行账户,并将交易历史共享给第三方应用。金融科技公司与贷款机构常用它进行信用评分和风险评估。本技能用于让用户与 Kontomatik 数据进行交互,管理数据、记录并自动化工作流。
主要能力:该集成围绕授权(Authorization)、同意(Consent)、账户(Account)、账单(Statement)、余额(Balance)、交易(Transaction)等对象提供操作,可按需使用相应动作名称与参数。官方文档位于 https://kontomatik.com/doc/。
使用方式:本技能通过 Membrane CLI 与 Kontomatik 交互,Membrane 自动处理认证与凭据刷新。先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成登录后用 membrane login complete <code>;任意命令可加 --json 获得机器可读输出。
连接:执行 membrane connection ensure "https://www.kontomatik.com/" --json,用户在浏览器完成认证,输出包含 connection id。若连接处于 BUILDING 状态,轮询 npx @membranehq/cli connection get <id> --wait --json,直到状态不再是 BUILDING。READY 表示就绪;CLIENT_ACTION_REQUIRED 需要用户或代理执行操作;CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错。
查找与运行动作:使用 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 参数可加 --input '{"key": "value"}',结果在响应的 output 字段。
代理请求:当现有动作无法覆盖需求时,可通过 Membrane 代理直接请求 Kontomatik API:membrane request CONNECTION_ID /path/to/endpoint,常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
限制与注意事项:应优先使用 Membrane 与外部应用通信,以利用内置认证、分页与错误处理;在编写自定义 API 调用前先通过 membrane action list --intent=QUERY 查找已有动作;不要让用户提供 API 密钥或令牌,而应创建连接,由 Membrane 在服务端管理完整认证生命周期。资料未提供具体动作清单、字段定义、计费与平台支持细节。