SuperAPI AI 工具集

service-omni-skills-based-routing-configure

智能体与模型

查看项目

更新于 10-16 08:47

技能介绍

用途:让坐席可通过 Omni 基于技能的路由(SBR)被路由。可路由坐席需要 Skill 以及将该技能分配给坐席用户的 SkillUser 关联记录。SkillUser 是经典 Omni-Channel 模型,由 Setup > Skills > Assign Users 写入,并在工作项带技能要求时被评估。本技能针对一个技能、一组活跃坐席用户,幂等地确保两者都存在。

主要能力:脚本 configure-and-report.sh 分两个幂等阶段,每阶段先检测后写入。Skill 阶段按 DeveloperName 查询 Skill,存在则复用,不存在则通过 Metadata API 部署 Skill 组件并重新查询其 Id。SkillUser 阶段查询该 Skill 与已解析用户的现有 SkillUser 记录,仅通过 REST DML 创建缺失的 (SkillId, UserId) 绑定;并发 DUPLICATE_VALUE 会被视为复用。

使用方式:bash scripts/configure-and-report.sh <org-alias> <skill_developer_name> [agent_members_csv] [skill_master_label]。org-alias 必填;skill_developer_name 必填,为要确保并绑定的 Omni Skill DeveloperName;agent_members_csv 可选,逗号分隔的坐席(Username 或 15/18 位 User Id),也可通过 AGENT_MEMBERS_CSV 提供,省略时技能会阻塞而不猜测;skill_master_label 可选,仅在需创建技能时使用。

前置条件:目标 org 已通过 sf CLI 认证,Service Cloud 许可证,sf CLI ≥ 2.139.6;已启用 Omni-Channel 基础设置并开启基于技能的路由;指定坐席存在且活跃;适用三方 safe_to_write 生产保护。

输出:单个 JSON 对象,含 status(configured | reused | partial | blocked)、skill、agents、created_counts、reused_counts、manual_actions、blocking_issue。

限制:每次调用仅一个技能;不编写 WorkSkillRouting 规则或基于字段的技能条件;不创建坐席用户、队列或状态配置;SkillUser.SkillLevel 保持平台默认,需修改 DML 才能设置明确熟练度。在普通 Service Cloud org 上,ServiceResource.IsActive 不可写或查询,故使用 SkillUser 路径。