用途:Karbon 是会计师事务所的实践管理平台,用于管理流程、内部协作与客户沟通;本技能借助 Membrane CLI 与该平台交互,当用户需要读取或操作 Karbon 数据时使用。
主要能力:可管理组织、联系人、工作流、模板、用户与角色,也可操作任务、工作时间记录等对象。已提供的动作包括创建用户、创建笔记、列出工作模板、列出用户、获取工作模板、创建工作项、创建客户组、列出/更新工作项、列出/更新/创建客户组、创建组织、更新/列出/创建联系人、列出/更新组织等。Membrane 负责认证与凭据刷新。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest;登录:membrane login --tenant --clientName=<agentType>(agentType 如 claude、codex、warp、windsurf 等;无界面环境会打印授权 URL,登录后用 membrane login complete <code> 完成)。任意命令加 --json 获取机器可读输出。建立连接:membrane connection ensure "https://karbonhq.com/" --json;若状态为 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。执行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}'。动作不覆盖时可走代理:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项。
适用场景:让 AI 代理查询或更新 Karbon 中的客户与工作数据,自动化常见事务所协作流程。
限制:未提供 Karbon 自身收费、价格与具体功能细节;所有操作依赖 Membrane 连接与认证成功,动作覆盖范围以实际返回为准,未列出的接口需通过代理自行请求。