用途:通过 Membrane CLI 连接 Kintone,管理其应用(App)、记录(Record)、评论、附件、用户、群组、组织、流程管理、视图与报表,适合需要以自然语言方式读写 Kintone 数据的自动化或智能体场景。
安装:npm install -g @membranehq/cli@latest
认证:membrane login --tenant --clientName=<agentType>;无头环境下命令会打印授权 URL,用户登录后获得 code,再执行 membrane login complete <code>。任意命令可加 --json 输出机器可读 JSON。
连接 Kintone:使用膜连接确保命令按应用 URL 或域名查找或创建连接,如 membrane connection ensure "https://www.kintone.com/" --json;若状态为 BUILDING,可用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。CLIENT_ACTION_REQUIRED 表示需用户或代理完成认证或补充输入,可参考 clientAction.description 与 clientAction.uiUrl。
搜索动作: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 直接向 Kintone API 发请求,Membrane 自动附加基础 URL 并注入认证头。常用选项有 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
最佳实践:优先使用 Membrane 预建动作以降低 token 消耗并提升安全性;先搜索已有动作再编写自定义 API 调用;不要向用户索要 API 密钥或令牌,由 Membrane 在服务端管理完整认证生命周期。
限制:具体 Kintone 版本、配额、收费与平台细节官方资料中暂未提供。