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

service-omni-supervisor-surface-deploy — скилл для Claude Code

Скилл service-omni-supervisor-surface-deploy для Claude Code заполняет интерфейс Omni-Channel Supervisor в Salesforce стандартными кнопками и вкладками через Data API. Запускается при настройке панели супервизора.

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

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

Что делает service-omni-supervisor-surface-deploy

Скилл добавляет действия и вкладки на существующую конфигурацию OmniSupervisorConfig с помощью вставки строк в дочерние объекты через Data API. Скрипты развёртывания проверяют окружение и блокируют запись в производственных средах, если не выполнены защитные условия. Для работы нужны утилита sf версии 2.139.6 или выше, jq версии 1.6 или новее, а также установленный python3 от версии 3.8. Конфигурация требует предварительно созданного объекта OmniSupervisorConfig и наличия лицензии Service Cloud в Salesforce.

Процесс работает идемпотентно и вставляет только недостающие типы без повторного развёртывания метаданных целиком. Новые элементы добавляются в конец списка с расчётом DisplayOrder, а пользовательские действия или внешние панели требуют ручной настройки через Setup.

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

  • заполнить кнопки и вкладки Omni Supervisor
  • добавить вкладки Wallboard и Agents
  • настроить действия супервизора Change Queues и Skills
  • выполнить идемпотентную вставку элементов интерфейса

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

  • Запусти деплой поверхности супервизора для организации prod-org и конфигурации Default_Config
  • Проверь план развёртывания элементов Omni Supervisor в организации staging с флагом PLAN_ONLY=1
  • Добавь стандартные вкладки и кнопки на панель супервизора для my-org

Как установить service-omni-supervisor-surface-deploy

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-supervisor-surface-deploy -a claude-code

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

~/.claude/skills/service-omni-supervisor-surface-deploy/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-omni-supervisor-surface-deploy/

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

Вопросы о service-omni-supervisor-surface-deploy

Как установить service-omni-supervisor-surface-deploy в Claude Code?

Выполните команду npx skills add forcedotcom/sf-skills --skill service-omni-supervisor-surface-deploy -a claude-code, а затем обратитесь к файлу ~/.claude/skills/service-omni-supervisor-surface-deploy/SKILL.md.

Что делает service-omni-supervisor-surface-deploy?

Скилл наполняет интерфейс Omni-Channel Supervisor стандартными кнопками действий и вкладками через Data API без пересоздания основного файла метаданных.

Что нужно для работы service-omni-supervisor-surface-deploy?

Требуются аутентифицированная организация Salesforce через sf CLI версии 2.139.6 или выше, jq версии 1.6+, python3 версии 3.8+, лицензия Service Cloud и существующий объект OmniSupervisorConfig.

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

SKILL.md · Apache-2.0
---
name: service-omni-supervisor-surface-deploy
description: "Use to populate the Omni-Channel Supervisor action + tab surface on an existing OmniSupervisorConfig by inserting the standard OmniSupervisorConfigAction and OmniSupervisorConfigTab companion rows via the Data API, idempotent (inserts only the missing types). Requires an OmniSupervisorConfig from service-omni-supervisor-config-deploy. Triggers: give the supervisor the standard action buttons and tabs, add Wallboard/Agents/Queues tabs to Omni Supervisor, configure supervisor actions like Change Queues/Skills. Do not use to create the supervisor configuration itself, create supervisor users, assign the supervisor permission set, or add custom-action / FlexiPage / AWS-dashboard / AI-agent surfaces (those need an external reference and must be set up in Setup)."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-command-center-analyze"
    - "service-omni-supervisor-config-deploy"
    - "service-omni-supervisor-permset-assign"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["python3"]
      semver: ">=3.8"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-supervisor-surface-deploy

Populate the Omni-Channel Supervisor **surface** — the action buttons and tabs a supervisor sees — on an existing `OmniSupervisorConfig`. `OmniSupervisorConfigAction` and `OmniSupervisorConfigTab` are createable child sObjects (`OmniSupervisorConfigId`, a `*Type` picklist, and `DisplayOrder`), so the surface is populated with plain Data API inserts against the parent config's Id rather than by re-deploying the whole `OmniSupervisorConfig` metadata document. That keeps this leaf independent of `service-omni-supervisor-config-deploy` (which owns the user/queue companions inside the metadata file) and lets it run idempotently — it inserts only the types that are missing.

## Inputs

`bash scripts/deploy-and-report.sh <org-alias> [config_developer_name]`

- `org-alias` (required) — must resolve via `sf org display --target-org <alias>`.
- `config_developer_name` (optional) — the `OmniSupervisorConfig.DeveloperName` to populate. Omit it when the org has exactly one config; the skill resolves it. With multiple configs and no name, the skill blocks and lists them.

Env overrides (both CSV of picklist values; defaults are the reference-free standard set):

- `SUPERVISOR_ACTIONS` — default `AllAgents.ChangeQueues,AllAgents.ChangeSkills,AllAgents.ChangeGroups,AllAgents.AssignLearning,QueuesBacklog.ManageQueues`.
- `SUPERVISOR_TABS` — default `Wallboard,Agents,QueuesBacklog,AssignedWork,SkillsBacklog`.
- `PLAN_ONLY=1` — report intent (existing vs. requested) and stop before any write.

## Preconditions and safety

- Target org authenticated via `sf` CLI, Service Cloud license present, `sf` CLI ≥ 2.139.6.
- An `OmniSupervisorConfig` exists — provisioned by `service-omni-supervisor-config-deploy`. If none exists (or the named one is absent), the skill blocks with a `target_skill` pointer.
- **Production guardrail:** the script computes `safe_to_write` as `IsSandbox` OR `TrialExpirationDate != null` OR `OrganizationType` in {Developer Edition, Base Edition}, and blocks with no override when it is false.

## Run

```bash
bash scripts/deploy-and-report.sh <org-alias> [config_developer_name]
```

It resolves the parent config, reads the surface rows already present, inserts only the missing action/tab types (appending `DisplayOrder` after the current maximum), and emits JSON to stdout.

## Behavior

**Reference-free types only.** The companion rows expose no reference field, so only self-contained types can be inserted headlessly. The skill accepts the standard set (`SAFE_ACTIONS` / `SAFE_TABS` in `references/api-notes.md`) and **blocks up front** on any type that needs an external reference — `*.CustomAction`, `*.AWSDashboard`, `FlexipageType`, `AIAgents`, `AgentforceSDR` — pointing you to Setup. Requesting a type outside the supported vocabulary also blocks before any write.

**Idempotency.** The requested types are diffed against the rows already on the config; existing types are reported as `reused` and never re-inserted, missing types are inserted and reported as `created`. `status` is `created` when anything was inserted, otherwise `reused`. Re-running the skill unchanged makes no writes.

**Ordering.** New rows are appended: `DisplayOrder` starts one above the current maximum for that companion type, preserving any ordering already configured in Setup.

## Output contract

A single JSON object to stdout. `status` is one of `created`, `reused`, `blocked`, or (with `PLAN_ONLY=1`) `action_needed`. The object also carries `config` (`developer_name`, `id`), `actions` and `tabs` (each with `requested`, `created`, `reused`, `count`), `manual_actions`, and `blocking_issue` (`null` unless `status: blocked`).

Org-side spot-check:

```sql
SELECT OmniSupervisorActionType, DisplayOrder FROM OmniSupervisorConfigAction WHERE OmniSupervisorConfigId = :configId ORDER BY DisplayOrder
SELECT OmniSupervisorTabType,    DisplayOrder FROM OmniSupervisorConfigTab    WHERE OmniSupervisorConfigId = :configId ORDER BY DisplayOrder
```

## Limitations

- Populates only the reference-free standard action and tab types. Custom actions, FlexiPage tabs, AWS dashboards, and AI-agent surfaces need an external reference and must be configured in Setup.
- Does not create, rename, or delete the parent `OmniSupervisorConfig`, its user/queue companions, or supervisor users/permission sets.
- Does not remove surface rows — it only adds missing ones (no destructive reconciliation).

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | The full `OmniSupervisorActionType` / `OmniSupervisorTabType` vocabulary, which types are reference-free, and companion-row insert semantics |

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

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

Все скиллы по теме «Бэкенд и API» →
omni-webhooks cheaper-inference Скилл omni-webhooks управляет вебхуками OmniRoute: создаёт, проверяет и удаляет конечные точки, настраивает события и повторные доставки. CX Codex +1 1 300установок omni-cli-tools cheaper-inference Скилл omni-cli-tools для Claude Code управляет интеграциями CLI-инструментов через API OmniRoute: позволяет настраивать профили, проверять статусы и вызывать плагины автоматизации. CX Codex +1 1 300установок google-gemini-omni-video calesthio Скилл google-gemini-omni-video для Claude Code генерирует короткие видео Gemini Omni Flash. Он также редактирует ролики по изображениям и прошлым взаимодействиям. CX Codex +1 144установок vercel-auto-deploy davila7 Хук vercel-auto-deploy запускает деплой в Vercel сразу после того, как Claude Code меняет файлы исходного кода в проекте. 454установок api-integration-surface-strategy Samuel Berthe Скилл api-integration-surface-strategy помогает решить, какие поверхности интеграции платформа отдаёт наружу — REST, GraphQL, gRPC, вебхуки, SDK, MCP — и в каком порядке их строить. CX Codex +1 10 400установок alibabacloud-solution-deploy aliyun Скилл alibabacloud-solution-deploy для Claude Code развёртывает официальные решения Alibaba Cloud через Terraform или CLI. Запускает готовые архитектуры — от RAG-системы до веб-приложения — без ручных действий в консоли. CX Codex +1 182установок

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

Весь набор →
service-omni-supervisor-config-deploy Скилл service-omni-supervisor-config-deploy для Claude Code разворачивает конфигурацию классического Omni-Channel Supervisor в Salesforce. Запускается по просьбе настроить Omni Supervisor или Supervisor Command Center. CX Codex +1 104установок service-omni-sidebar-configure Скилл service-omni-sidebar-configure для Claude Code включает и проверяет боковую панель Omni-Channel в консольных приложениях Lightning. Активирует закреплённую область оператора через метаданные CustomApplication. CX Codex +1 103установок service-omni-presence-status-deploy Скилл service-omni-presence-status-deploy для Claude Code развёртывает статусы доступности Omni-Channel. Запускается при настройке Available-статусов для Case, Incident, Messaging или Voice и стандартного Busy. CX Codex +1 103установок service-omni-base-settings-configure Скилл service-omni-base-settings-configure для Claude Code и других ассистентов настраивает базовые параметры Omni-Channel в Salesforce через Metadata API. Включает пять главных флагов маршрутизации перед созданием очередей. CX Codex +1 103установок 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установок

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

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