用途:该技能用于让 AI 代理与 OneDesk 数据交互。OneDesk 是一体化客户支持与项目管理平台,供企业(尤其是面向客户的团队)在单一位置管理支持工单、项目与客户反馈,以简化工作流并提升客户满意度。官方文档:https://www.onedesk.com/api/
主要能力:可操作的对象包括工单、任务、项目、客户、公司、会话、工时记录、用户、应用、集成、报表、仪表板、文章、工作流、自动化、视图、通知、自定义字段、SLA、工时表、角色、组、邮件模板、计费计划、公告、满意度评分等。具体动作名称与参数按需使用。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无界面环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 OneDesk:membrane connection ensure "https://www.onedesk.com/" --json,用户在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。动作未覆盖时可用代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要以自然语言方式查询或操作 OneDesk 中的支持工单、项目、客户与反馈数据时。
限制:认证与凭据刷新由 Membrane 服务端处理,不应向用户索取 API 密钥或令牌;应优先使用预置动作而非直接调用原始 API。资料未提供具体动作清单、参数细节、权限范围与配额限制。