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

service-omni-presence-user-config-deploy — скилл для Claude Code

Скилл service-omni-presence-user-config-deploy для Claude Code разворачивает конфигурацию присутствия Omni для агентов. Он включает отказ от работы с причиной и таймер ACW, затем назначает конфигурацию пользователям.

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

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

Что делает service-omni-presence-user-config-deploy

Скилл разворачивает PresenceUserConfig вместе с PresenceDeclineReason одним пакетом Metadata API. Он задаёт отключённый Auto-Accept, включённые Decline и Decline Reason, а также таймер After-Conversation-Work с максимальным временем. Агентов можно передать по username или User ID; ID скрипт разрешает в username.

Для запуска нужны аутентифицированная целевая org, лицензия Service Cloud, sf версии 2.139.6 или выше и включённые базовые настройки Omni-Channel. Также используются jq версии 1.6 или выше и python3 версии 3.8 или выше. Если задан PRESENCE_STATUS_ON_DECLINE, этот ServicePresenceStatus должен существовать заранее.

За один запуск создаётся или обновляется одна конфигурация; другие конфигурации и причины отказа скрипт не меняет. Повторный запуск определяет состояние компонентов по Metadata API. Скилл не настраивает таймер ACW на ServiceChannel и не выдаёт доступ к статусам через permission set.

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

  • развернуть конфигурацию присутствия Omni вместе с причиной отказа
  • включить отказ агента и таймер ACW в одной записи
  • назначить конфигурацию агентам по username или User ID
  • повторно применить конфигурацию без записи неизменённых компонентов

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

  • Создай конфигурацию присутствия Omni для агентов с отказом и причиной отказа.
  • Включи таймер ACW и назначь эту конфигурацию пользователям [email protected].
  • Разверни конфигурацию присутствия для User ID 005XXXXXXXXXXXXXXX.

Как установить service-omni-presence-user-config-deploy

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill service-omni-presence-user-config-deploy -a claude-code

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

~/.claude/skills/service-omni-presence-user-config-deploy/SKILL.md

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

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

Вопросы о service-omni-presence-user-config-deploy

Как установить service-omni-presence-user-config-deploy в Claude Code?

Выполни npx skills add forcedotcom/sf-skills --skill service-omni-presence-user-config-deploy -a claude-code. Файл скилла появится по пути ~/.claude/skills/service-omni-presence-user-config-deploy/SKILL.md.

Что делает service-omni-presence-user-config-deploy?

Скилл разворачивает PresenceUserConfig и связанную PresenceDeclineReason одним пакетом Metadata API. Он включает настройки отказа и таймер ACW, а затем назначает конфигурацию указанным агентам.

Что нужно для работы service-omni-presence-user-config-deploy?

Нужны аутентифицированная org с лицензией Service Cloud, включённые базовые настройки Omni-Channel, sf версии 2.139.6 или выше, jq версии 1.6 или выше и python3 версии 3.8 или выше. Указанный PRESENCE_STATUS_ON_DECLINE должен уже существовать.

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

SKILL.md · Apache-2.0
---
name: service-omni-presence-user-config-deploy
description: "Use to deploy an Omni PresenceUserConfig (presence configuration) as one whole-record Metadata write with the decline/ACW fields set consistently: Auto-Accept off, Decline on, Decline Reason on (with a PresenceDeclineReason deployed in the same package), and an After-Conversation-Work wrap-up timer. Agents are assigned by username. Idempotent via the Metadata API files[].state signal. Triggers: create presence configuration, enable decline + decline reason + ACW wrap-up timer for agents, assign presence config to users. Do not use for ServicePresenceStatus (separate skill), for permission-set access to statuses, or to set the channel-level ACW timer on a ServiceChannel."
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  version: "1.0"
  domains: ["Service"]
  minApiVersion: "66.0"
  relatedSkills:
    - "service-omni-agent-users-create"
    - "service-omni-base-settings-configure"
    - "service-omni-channel-setup-coordinate"
    - "service-omni-presence-status-deploy"
  accessCheck: "OrgPermissions.LightningService"
  cliTools:
    - tool: ["jq"]
      semver: ">=1.6"
    - tool: ["python3"]
      semver: ">=3.8"
    - tool: ["sf"]
      semver: ">=2.139.6"
---

# service-omni-presence-user-config-deploy

Deploy an Omni **PresenceUserConfig** (the "presence configuration" that governs how work is offered to agents) together with the **PresenceDeclineReason** it references, in one atomic Metadata API package. The decline / auto-accept / decline-reason / ACW fields have cross-field validators — enabling Decline requires Auto-Accept off, Decline Reason requires Decline on, and the ACW timer must be paired with its max time — so they can only be set correctly as a **single whole-record write**, not field-by-field. This skill encodes that consistent record and assigns it to the given agents. It runs after `service-omni-agent-users-create` / `service-omni-presence-status-deploy` and is invoked by `service-omni-channel-setup-coordinate` as a rep-experience step.

## Inputs

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

- `org-alias` (required).
- `config_developer_name` (optional, default `Omni_Demo_Presence_Config`).
- `agent_usernames_csv` (optional). Comma-separated Usernames (`…@…`) and/or 15/18-char User Ids (`005…`) to assign; Ids are resolved to usernames (metadata assigns by username). May also be set via `AGENT_USERNAMES_CSV`. Empty → the config deploys with no user assignments.

Env overrides: `DECLINE_REASON_LABEL` (default `Training`), `DECLINE_REASON_DEVELOPER_NAME` (default derived from the label), `CAPACITY` (default `5`, 1–100), `ACW_SECONDS` (default `60`, 10–3600), `PRESENCE_STATUS_ON_DECLINE` (optional ServicePresenceStatus DeveloperName).

## Preconditions and safety

- Target org authenticated via `sf` CLI, Service Cloud license, `sf` CLI ≥ 2.139.6.
- Omni-Channel base settings enabled (`service-omni-base-settings-configure`).
- Any `PRESENCE_STATUS_ON_DECLINE` must already exist (`service-omni-presence-status-deploy`).
- The three-way `safe_to_write` production guard applies.

## Run

`deploy-and-report.sh` materializes two components into a temp DX project and deploys them in one call:

1. `PresenceDeclineReason:<reason>` — the decline reason (label only).
2. `PresenceUserConfig:<config>` — capacity + label, `enableAutoAccept=false`, `enableDecline=true`, `enableDeclineReason=true`, `declineReasons=<reason>`, `hasAfterConvoWorkTimer=true`, `afterConvoWorkMaxTime=<ACW_SECONDS>`, optional `presenceStatusOnDecline`, and `assignments/users` for the resolved agents.

Elements are emitted in strict XSD order. Idempotency comes from the Metadata API `files[].state` per component (`Unchanged`→reused, `Changed`→updated, `Created`→created); the deploy runs `--async` and polls to a terminal state.

## Behavior

**Whole-record + consistent.** The record is always emitted with the validator-safe combination, so a re-deploy is a clean no-op rather than a field diff that could trip a cross-field rule.

**Non-destructive.** Only the named config and decline reason are written; other presence configs and decline reasons on the org are never touched. Assignments are declared for the resolved agents; the skill does not remove users it did not add (a redeploy declares the full assignment set for this config).

## Output contract

A single JSON object: `status` ∈ `created` | `updated` | `reused` | `blocked`, `config` (`{developer_name, label, capacity, acw_seconds, state}`), `decline_reason` (`{developer_name, label, state}`), `assigned_usernames`, `deploy_id`, `manual_actions`, `blocking_issue`.

## Limitations

- One presence configuration per invocation.
- Encodes the decline+ACW rep profile from the steel thread; other field combinations require forking the XML template.
- Does **not** set the channel-level After-Conversation-Work timer on a `ServiceChannel` (a separate concern), deploy `ServicePresenceStatus`, or grant status access via permission set.

## References

| File | When to read |
|---|---|
| `references/api-notes.md` | PresenceUserConfig cross-field validators, XSD element order, decline-reason packaging, and ACW field pairing |
| `scripts/tests/_bootstrap.py` | Test bootstrap loaded by the contract suite to locate the skill root and run its shell entry point |
| `scripts/tests/test_presence_user_config_contracts.py` | Run after changing the deployment script to verify guard, whole-record, membership, and output contracts |

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

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

Все скиллы по теме «DevOps и инфраструктура» →
mastering-animate-presence raphael-salaja Скилл mastering-animate-presence проверяет код Motion и Framer Motion на ошибки в AnimatePresence и exit-анимациях. Пригодится при ревью модалок и списков. CX Codex +1 323установок github-presence jonathimer Скилл github-presence для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode оптимизирует README, профиль и видимость репозиториев на GitHub. Запускается по фразам «GitHub README», «GitHub профиль», «awesome lists». CX Codex +1 ★ 88звёзд репо firebase-remote-config-basics Google LLC Скилл firebase-remote-config-basics помогает управлять Remote Config в приложениях на Android и iOS через Firebase CLI. Позволяет менять флаги функций и параметры без выкатки обновлений в магазины. CX Codex +1 132 400установок omni-tunnels cheaper-inference Скилл omni-tunnels создаёт защищённые туннели (ngrok, Cloudflare Tunnel или собственные) и раскрывает OmniRoute в интернет или подключает удалённых агентов и CI-пайплайны. CX Codex +1 1 300установок omni-proxies cheaper-inference Скилл omni-proxies настраивает HTTP, HTTPS и SOCKS-прокси для запросов к апстрим-провайдерам в OmniRoute: правила по провайдеру или глобально, проверка соединения и ротация. CX Codex +1 1 300установок agentmemory-config rohitg00 Скилл agentmemory-config настраивает и диагностирует локальный agentmemory: MCP, переменные окружения, порты, секреты и флаги функций. Помогает понять, почему память или отдельная функция не работает. CX Codex +1 11 900установок

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

Весь набор →
service-omni-base-settings-configure Скилл service-omni-base-settings-configure для Claude Code и других ассистентов настраивает базовые параметры Omni-Channel в Salesforce через Metadata API. Включает пять главных флагов маршрутизации перед созданием очередей. CX Codex +1 103установок 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-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установок service-omni-work-skill-routing-configure Скилл service-omni-work-skill-routing-configure для Claude Code настраивает маршрутизацию Omni по значению поля записи. Например, он связывает Case.Origin = Phone с требованием навыка Voice. CX Codex +1 100установок

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

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