SuperAPI AI 工具集

service-omni-work-skill-routing-configure

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:编写 Omni WorkSkillRouting 规则,让工作项按记录字段值决定所需技能,而非仅依赖坐席已有技能。例如“当 Case.Origin = Phone 时要求 Voice 技能”。与 service-omni-skills-based-routing-configure(使坐席可路由)配合,本技能决定工作项需要哪个技能。

主要能力:生成一条 WorkSkillRouting 记录(头部加一条 workSkillRoutingAttributes 映射),经 Metadata API 部署。支持幂等与合并:重复同一映射报告 reused,新映射合并进现有属性列表,修改同一字段/值映射只更新该条目;读取不确定时不会静默替换现有规则。部署失败若形如 INVALID_TYPE 或“not available”,会报告 blocked 并提示基础设置,而非崩溃。

使用方式:运行 bash scripts/configure-and-report.sh <org-alias> <related_entity> <field> <skill> <value> [rule_master_label]。参数:org-alias 必填;related_entity 为适用 sObject(如 Case、MessagingSession、LiveChatTranscript、Lead、VoiceCall);field 为评估字段(如 Case.Origin 或 Origin,裸标准字段会补全实体前缀);skill 为匹配时要求的 Omni Skill DeveloperName(如 Voice);value 为映射的字段值(如 Phone,仅纯文本,不支持 XML 保留字符);rule_master_label 可选,默认 <related_entity> Skill Routing。环境变量覆盖:RULE_DEVELOPER_NAME(默认实体名,每实体一条规则)、IS_ACTIVE(默认 true)、SKILL_LEVEL(0–10)、SKILL_PRIORITY(0–10)、IS_ADDITIONAL_SKILL(true/false)。

前置条件:目标组织已通过 sf CLI 认证,具备 Service Cloud 许可,sf CLI ≥ 2.139.6;已启用 Omni-Channel 基础设置并开启基于技能的路由;引用的 Skill 已存在;应用三方 safe_to_write 生产保护。

限制:每次调用仅一个字段→技能映射,每个相关实体仅一条规则,多次调用可安全累积属性;不创建 Skill、ServiceResource、坐席用户、队列或状态配置;字段/值正确性由平台在部署时校验,无效字段或值会以 blocked 部署失败呈现。WorkSkillRouting 并非所有组织都提供(部分试用版/CDO)。