К основному содержанию
скилл CX Codex

service-omni-work-skill-routing-configure — скилл для Claude Code

Скилл service-omni-work-skill-routing-configure для Claude Code настраивает маршрутизацию Omni по значению поля записи. Например, он связывает Case.Origin = Phone с требованием навыка Voice.

Apache-2.0 100 установок ★ 1 183 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill service-omni-work-skill-routing-configure -a claude-code
Открыть на GitHub

Что делает service-omni-work-skill-routing-configure

Скилл создаёт правило WorkSkillRouting: значение поля связанной записи определяет, какой Omni Skill требуется для маршрутизации работы. Скрипт scripts/configure-and-report.sh принимает организацию, объект, поле, навык и значение; за один запуск он добавляет одну связку. Правило одно на объект, повторный запуск с той же связкой переиспользует его, а новая связка добавляется к существующим атрибутам.

Перед настройкой нужны авторизованная через sf организация, лицензия Service Cloud, sf версии 2.139.6 или новее, включённая маршрутизация по навыкам и уже созданный Skill. Также нужны jq версии 1.6 или новее и python3 версии 3.8 или новее. Скилл проверяет, что целевая организация не production, читает существующие метаданные через Tooling API и развёртывает правило через Metadata API. Значения с XML-зарезервированными символами не поддерживаются; некорректное поле или значение блокирует развёртывание.

Какие задачи решает

  • направить записи Case по значению поля Origin
  • потребовать навык Omni для заданного значения поля
  • добавить связку поля и навыка в существующее правило маршрутизации
  • изменить отдельную связку, сохранив остальные атрибуты

Примеры запросов агенту

  • Настрой маршрутизацию: для Case.Origin = Phone требуется навык Voice.
  • Свяжи значение поля MessagingSession с нужным Omni Skill.
  • Добавь правило маршрутизации навыков для Case по полю Origin.

Как установить service-omni-work-skill-routing-configure

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-work-skill-routing-configure -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-omni-work-skill-routing-configure/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-omni-work-skill-routing-configure/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-omni-work-skill-routing-configure

Как установить service-omni-work-skill-routing-configure в Claude Code?

Выполни npx skills add forcedotcom/sf-skills --skill service-omni-work-skill-routing-configure -a claude-code. Файл скилла находится по пути ~/.claude/skills/service-omni-work-skill-routing-configure/SKILL.md.

Что делает service-omni-work-skill-routing-configure?

Создаёт правило WorkSkillRouting, которое назначает требуемый Omni Skill по значению поля записи. Существующие атрибуты сохраняются при добавлении новой связки.

Что нужно для работы service-omni-work-skill-routing-configure?

Нужны авторизованная организация Salesforce с лицензией Service Cloud, sf версии 2.139.6 или новее, jq версии 1.6 или новее и python3 версии 3.8 или новее. Маршрутизация по навыкам должна быть включена, а нужный Skill уже создан.

Исходный текст

SKILL.md · Apache-2.0
---
name: service-omni-work-skill-routing-configure
description: "Use to author an Omni WorkSkillRouting rule (field-based skill criteria): map a related-entity field value to a required Omni Skill (e.g. add the Voice skill when Case.Origin = Phone), deployed as one WorkSkillRouting record via the Metadata API. Idempotent via the Metadata API files[].state signal; one rule per related entity. Triggers: add field-based skill routing, route by a Case field to a skill, route by a MessagingSession field to a skill, configure attribute-based skills routing, require an Omni skill for a field value. Do not use to create the Skill or bind agents to it (service-omni-skills-based-routing-configure), to create agent users, or to configure queues."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-base-settings-configure"
    - "service-omni-channel-setup-coordinate"
    - "service-omni-skills-based-routing-configure"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["python3"]
      semver: ">=3.8"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-work-skill-routing-configure

Author an Omni **WorkSkillRouting** rule so work is routed to agents by a **field value on the work record**, not just by skills the agent happens to hold. Where `service-omni-skills-based-routing-configure` makes an agent *routable* (Skill + ServiceResource + ServiceResourceSkill), this skill decides *which skill a work item requires* based on one of its fields — for example "when `Case.Origin` = `Phone`, require the `Voice` skill". The rule is one `WorkSkillRouting` record (a header plus one `workSkillRoutingAttributes` mapping) deployed via the Metadata API. It runs after the referenced Skill exists and belongs to the same routing family coordinated by `service-omni-channel-setup-coordinate`.

## Inputs

```bash
bash scripts/configure-and-report.sh <org-alias> <related_entity> <field> <skill> <value> [rule_master_label]
```

- `org-alias` (required).
- `related_entity` (required). The sObject the rule applies to (e.g. `Case`, `MessagingSession`, `LiveChatTranscript`, `Lead`, `VoiceCall`).
- `field` (required). The field the attribute evaluates (e.g. `Case.Origin` or `Origin`). Bare standard fields are qualified with the related entity before deploy, so `Origin` becomes `Case.Origin` instead of being misread as a custom-field metadata name.
- `skill` (required). The Omni `Skill` DeveloperName required when the field matches (e.g. `Voice`).
- `value` (required). The field value that maps to the skill (e.g. `Phone`). Plain values only; XML-reserved characters are not supported.
- `rule_master_label` (optional). MasterLabel for the rule; defaults to `<related_entity> Skill Routing`.

Env overrides: `RULE_DEVELOPER_NAME` (fullName of the rule, default the related-entity name — one rule per entity), `IS_ACTIVE` (default `true`), `SKILL_LEVEL` (0–10), `SKILL_PRIORITY` (0–10, additional-skill drop order), `IS_ADDITIONAL_SKILL` (`true`/`false`).

## Preconditions and safety

- Target org authenticated via `sf` CLI, Service Cloud license, `sf` CLI ≥ 2.139.6.
- Omni-Channel base settings enabled with **skills-based routing** turned on (`service-omni-base-settings-configure`).
- The referenced `Skill` already exists (`service-omni-skills-based-routing-configure`).
- The three-way `safe_to_write` production guard applies.

## Run

1. **safe_to_write** — query `Organization`; refuse to write to a real production org.
2. **Skill prereq** — query `Skill` by DeveloperName; if absent, block and point at `service-omni-skills-based-routing-configure`.
3. **Merge** — read the existing `WorkSkillRouting.Metadata` through the Tooling API, preserve unrelated attributes, and replace or append only the requested `(field, value)` mapping. An inconclusive read blocks the write; `WSR_REPLACE=1` is the explicit destructive-replacement escape hatch.
4. **Deploy** — materialize the merged `WorkSkillRouting` record (elements in XSD/alphabetical order) and deploy it via the Metadata API (async + poll to a terminal state).
5. **Classify** — read `files[].state` (`Created` / `Changed` / `Unchanged`) to report `created` / `updated` / `reused`.

## Behavior

**Idempotent + merge-safe.** WorkSkillRouting permits a single rule per related entity, so the rule's fullName defaults to the entity name. Re-running the same mapping reports `reused`; a new mapping is merged into the existing attribute list; changing the same field/value mapping updates only that entry. The skill never silently replaces an existing rule when its current metadata could not be read.

**Graceful degradation.** WorkSkillRouting is not provisioned on every org (some trials/CDOs). A deploy failure shaped like `INVALID_TYPE` / "not available" / "WorkSkillRouting" is reported as `blocked` with a clear limitation message and a pointer to base settings — the skill surfaces the limitation rather than crashing.

## Output contract

A single JSON object: `status` ∈ `created` | `updated` | `reused` | `blocked` (plus `action_needed` in plan mode), `rule` (`{developer_name, master_label, related_entity, is_active, state}`), `attribute` (`{field, skill, value, skill_level, skill_priority, is_additional_skill}`), `merge` (`{merged_from_existing, attribute_count, preserved_count}`), `deploy_id`, `manual_actions`, `blocking_issue`.

## Limitations

- One field→skill mapping per invocation and one rule per related entity. Multiple invocations safely accumulate attributes on that rule.
- Does not create the Skill, ServiceResources, agent users, queues, or presence configuration.
- Field/value correctness is validated by the platform at deploy time; an invalid field or value surfaces as a `blocked` deploy failure.

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | WorkSkillRouting metadata shape, XSD element order, one-rule-per-entity constraint, attribute fields, and graceful-degradation triggers |
| `scripts/tests/test_work_skill_routing_contracts.py` | When validating changes — run `python3 scripts/tests/test_work_skill_routing_contracts.py` from this skill directory |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
omni-combos-routing cheaper-inference Скилл omni-combos-routing для Claude Code настраивает комбинированные маршруты моделей, резервные цепочки отказоустойчивости и запрашивает метрики провайдеров через API OmniRoute. CX Codex +1 1 600установок google-gemini-omni-video calesthio Скилл google-gemini-omni-video для Claude Code генерирует короткие видео Gemini Omni Flash. Он также редактирует ролики по изображениям и прошлым взаимодействиям. CX Codex +1 144установок cloudflare-email-service cloudflare Скилл cloudflare-email-service для Claude Code, Cursor, Codex и других агентов — учит реализовывать и отлаживать Cloudflare Email Sending и Email Routing. Покрывает Workers-биндинг, REST API и входящие письма через email()-хендлер. CX Codex +1 120 200установок routing-traffic-with-route53-and-cloudfront aws Скилл routing-traffic-with-route53-and-cloudfront для Claude Code настраивает маршрутизацию домена через Route 53 к CloudFront. Активируется при работе с DNS-записями, HTTPS-сертификатами или IPv6 для CloudFront. CX Codex +1 6 500установок amazon-location-service aws-geospatial Подключает API Amazon Location Service к проекту: карты, геокодинг, маршруты, поиск мест, геозоны и трекинг устройств. CX Codex +1 1 300установок vtex-io-service-configuration-apps vtex Скилл vtex-io-service-configuration-apps помогает разделять логику сервисов и настройки в VTEX IO с помощью билдера configuration. Пригодится при передаче единой схемы конфигурации между несколькими приложениями. CX Codex +1 1 200установок

Из того же набора232

Весь набор →
service-omni-supervisor-surface-deploy Скилл service-omni-supervisor-surface-deploy для Claude Code заполняет интерфейс Omni-Channel Supervisor в Salesforce стандартными кнопками и вкладками через Data API. Запускается при настройке панели супервизора. CX Codex +1 102установок service-omni-supervisor-users-create Скилл service-omni-supervisor-users-create для Claude Code создаёт учётные записи супервайзеров Omni-Channel в Salesforce. Запускается по запросу создать или подготовить таких пользователей. CX Codex +1 102установок service-omni-supervisor-permset-assign Скилл service-omni-supervisor-permset-assign для Claude Code, автоматизирующий назначение ContactCenterSupervisor пользователям в Salesforce. Запускает проверку и выдачу прав супервайзера в CI или окружении разработки. CX Codex +1 102установок service-omni-presence-user-config-deploy Скилл service-omni-presence-user-config-deploy для Claude Code разворачивает конфигурацию присутствия Omni для агентов. Он включает отказ от работы с причиной и таймер ACW, затем назначает конфигурацию пользователям. CX Codex +1 102установок service-omni-agent-users-create Скилл service-omni-agent-users-create для Claude Code создаёт пользователей-агентов Salesforce для настройки Omni-Channel и проверки маршрутизации. Запускается по запросам на создание или восстановление тестовых агентов. CX Codex +1 101установок education-cloud-domain-configure Скилл education-cloud-domain-configure для Claude Code настраивает домены Education Cloud в Salesforce через диалог. Запускается, когда нужно включить функции домена. CX Codex +1 100установок service-agentforce-contact-center-coordinate Скилл service-agentforce-contact-center-coordinate для Claude Code автоматизирует настройку голосового канала Agentforce Contact Center. Запускается при запросе на создание голосового канала и подключение агента. CX Codex +1 100установок salesforce-development Плагин salesforce-development помогает создавать Salesforce-приложения и агентов через Apex, метаданные, деплой, безопасность и отчёты. Он сам подхватывает контекст DX-проекта. ★ 1 183звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой