# widget-embedding

Субагент widget-embedding помогает встроить голосового ассистента ElevenLabs на сайт через готовый веб-компонент, настроить стили и подключить авторизацию.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 78316 у репозитория
- Автор: calesthio
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/widget-embedding.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/widget-embedding

## Что делает

Субагент содержит инструкции по интеграции голосового виджета `<elevenlabs-convai>` в веб-приложения. Он генерирует разметку для загрузки скрипта, подсказывает атрибуты внешнего вида — цвета градиента сферы, аватарку, текстовые подсказки и режим отображения.

Внутри описаны методы JavaScript API для программного запуска сессии через `startConversation()`, переопределение размеров через CSS-переменные в Shadow DOM и адаптивная вёрстка. Также есть примеры компонентов для React, Vue и Next.js.

Для закрытых сценариев обязательно нужен бэкенд, отдающий `signed-url`: стандартный виджет напрямую работает только с публичными агентами без авторизации.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/widget-embedding.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/widget-embedding.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/widget-embedding.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/widget-embedding.md

## Когда брать
- Добавить плавающую кнопку голосового бота ElevenLabs в HTML-разметку
- Настроить цвета градиента, иконку и размеры окна через Shadow DOM
- Реализовать авторизованный запуск голосового сеанса через `signed-url`
- Встроить компонент диалога в приложение на React или Vue

## Примеры запросов агенту
- Добавь на страницу виджет ElevenLabs с градиентом `#ff6b6b` и вызовом по собственной кнопке
- Покажи, как передать signed-url в elevenlabs-convai из ответа нашего API
- Сделай React-компонент для голосового агента с загрузкой скрипта через useEffect

## Похожие
- [agents](https://affpapa.org/nevibecode/skills/agents.md) — скилл · 14700 установок
- [flutter-add-widget-preview](https://affpapa.org/nevibecode/skills/flutter-add-widget-preview.md) — скилл · 40000 установок
- [platform-lightning-type-widget-coordinate](https://affpapa.org/nevibecode/skills/platform-lightning-type-widget-coordinate.md) — скилл · 3400 установок
- [text-to-speech](https://affpapa.org/nevibecode/skills/text-to-speech.md) — скилл · 22900 установок
- [voice-ai-development](https://affpapa.org/nevibecode/skills/sickn33-voice-ai-development.md) — скилл · 972 установки
- [pp-elevenlabs](https://affpapa.org/nevibecode/skills/pp-elevenlabs.md) — скилл · 165 установок

Из того же набора: [calesthio/openmontage](https://affpapa.org/nevibecode/by/calesthio/openmontage.md) — 101 карточка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
