用途:该技能用于与 Zendesk Guide 数据交互。Zendesk Guide 是知识库与自助服务平台,供客服团队和终端用户创建、管理、共享支持内容并自助查找答案。
主要能力:可操作 Article(文章)、Comment(评论)、Section(分区)、Category(类别)等对象,支持按需使用动作名与参数;通过 Membrane 代理可直接向 Zendesk Guide API 发送请求,Membrane 自动附加基础 URL 并注入认证头,凭据过期时透明刷新。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。连接:membrane connection ensure "https://www.zendesk.com/guide/" --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,结果在 output 字段。代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可得机器可读输出。
适用场景:需要读取或管理 Zendesk Guide 知识库内容、自动化支持内容工作流时使用。
限制:官方 API 参考见 https://developer.zendesk.com/api-reference/help_center/help-center-api/;不要向用户索要 API 密钥或令牌,应通过连接由 Membrane 服务端管理认证生命周期;具体可用动作与参数以实际查询结果为准,资料未提供完整动作清单。