用途:该技能用于与 CATS 应用交互,管理数据、记录并自动化工作流,适合需要读取或操作 CATS 数据的场景。资料中列出的相关概念包括 Kitten、Litter Box、Cat Fact。
主要能力:通过 Membrane CLI 与 CATS 通信,Membrane 自动处理认证与凭据刷新;支持搜索并运行预置动作,也支持通过代理直接请求 CATS API。
安装与认证:安装命令为 npm install -g @membranehq/cli@latest。登录命令为 membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,完成后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
连接:使用 membrane connection ensure "https://catsone.com/" --json 查找或创建连接,用户在浏览器完成认证,输出包含连接 id。若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询,直到 READY;CLIENT_ACTION_REQUIRED 时按 clientAction 提示处理。
动作:用 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"}'。
代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制:资料未提供 CATS 的具体动作清单、字段结构、收费与平台支持等细节;官方文档链接为 https://developers.thecatapi.com/。建议优先使用 Membrane 预置动作,避免直接索要 API 密钥。