zoom-virtual-agent-web — скилл для Codex: что делает и как установить
Встраивает веб-SDK Zoom Virtual Agent в интерфейс через campaign embed или entry ID. Помогает настроить управление событиями, обновить контекст пользователя и соблюсти CSP.
npx skills add openai/plugins --skill web -a codexЧто делает zoom-virtual-agent-web
Скилл помогает интегрировать веб-виджет Zoom Virtual Agent на сайт. Он настраивает запуск чата по идентификатору кампании или entry ID и передаёт контекст пользователя в сессию.
Внутри собраны правила по жизненному циклу виджета. SDK требует блокировать любые вызовы управления интерфейсом (show, hide, open, close) до полной инициализации через событие zoomCampaignSdk:ready или вызов waitForReady(). Без корректных политик CSP и разрешений для хоста скрипта виджет просто заблокируется браузером.
Для снижения трения пользователей документация рекомендует выбирать запуск через campaign embed вместо entry ID.
Какие задачи решает
- внедрить чат Zoom Virtual Agent на веб-страницу
- настроить передачу контекста пользователя в сессию агента
- синхронизировать вызовы методов виджета с событием
waitForReady() - настроить политики CSP для безопасной загрузки SDK
Примеры запросов агенту
- Настрой встраивание виджета Zoom Virtual Agent через campaign embed с проверкой
waitForReady() - Добавь обновление контекста пользователя и обработку события
zoomCampaignSdk:ready - Проверь правила Content Security Policy для веб-скрипта Zoom Virtual Agent
Как установить zoom-virtual-agent-web
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill web -a codex2Вручную: положить файлы
.agents/skills/web/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill web -a claude-code2Вручную: положить файлы
~/.claude/skills/web/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/web/
Вручную: положить файлы
.cursor/skills/web/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins web2Вручную: положить файлы
.github/skills/web/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/zoom/skills/virtual-agent/webВручную: положить файлы
.devin/skills/web/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о zoom-virtual-agent-web
Как установить zoom-virtual-agent-web в Codex?
Выполните npx skills add openai/plugins --skill web -a codex. Файл скилла будет сохранён по пути .agents/skills/web/SKILL.md.
Что делает zoom-virtual-agent-web?
Скилл инструктирует агента при интеграции Zoom Virtual Agent Web SDK, задавая правила инициализации, настройки CSP и обработки событий.
Почему нельзя вызывать методы show или hide сразу после загрузки страницы?
Вызовы методов интерфейса до завершения инициализации SDK приводят к ошибкам. Их необходимо блокировать до срабатывания zoomCampaignSdk:ready или завершения waitForReady().
Исходный текст
SKILL.md · MIT
--- name: zoom-virtual-agent-web description: "Zoom Virtual Agent SDK for web embeds. Use for campaign or entry ID chat launch, event-driven controls, user context updates, and CSP-safe deployment." --- # Zoom Virtual Agent SDK - Web Official docs: - https://developers.zoom.us/docs/virtual-agent/web/ - https://developers.zoom.us/docs/virtual-agent/web/reference/ ## Quick Links 1. [concepts/lifecycle-and-events.md](concepts/lifecycle-and-events.md) 2. [examples/campaign-and-entry-patterns.md](examples/campaign-and-entry-patterns.md) 3. [references/web-reference-map.md](references/web-reference-map.md) 4. [troubleshooting/common-issues.md](troubleshooting/common-issues.md) ## Hard Guardrails - Gate calls behind readiness (`zoomCampaignSdk:ready` or `waitForReady()`). - Do not call `show/hide/open/close` before SDK initialization. - Keep CSP and script host policy validated before debugging business logic. - Prefer campaign embed over entry ID when minimizing user friction is a priority. ## Chaining - Product-level architecture and drift checks: [../SKILL.md](../SKILL.md) - Contact Center web context: [../../contact-center/web/SKILL.md](../../contact-center/web/SKILL.md) - OAuth or REST for backend workflows: [../../oauth/SKILL.md](../../oauth/SKILL.md), [../../rest-api/SKILL.md](../../rest-api/SKILL.md)
© Zoom · MIT · openai/plugins
