Урок из полного доступа, первые уроки курса бесплатно Официальный курс ElevenLabs Cookbook на русском
Урок 04 · Текст · ~5 мин

Разговорный агент: серверная часть

Урок 4 из 21 курса «ElevenLabs: примеры»: официальный курс ElevenLabs Cookbook (Илевен Лабс) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Прежде чем писать какой-либо код, вызовите навык /agents, чтобы изучить правильные шаблоны ElevenLabs SDK.

  • Добавьте зависимости @elevenlabs/react и @elevenlabs/elevenlabs-js.

Защищенный маршрут, который создает или загружает голосового агента. Никогда не раскрывайте ELEVENLABS_API_KEY клиенту.

  • POST создает нового голосового агента с разумными значениями по умолчанию (имя, системный prompt, первое сообщение, голос TTS). Используйте шаблон CLI voice-only в качестве эталона для структуры агента.
  • GET загружает существующего агента по agentId.
  • Настройте как voice-first: настоящий голос TTS и модель, текстовый режим отключен, текстовый ввод виджета отключен.
  • Для англоязычных агентов (language: "en") используйте tts.modelId: "eleven_flash_v2". Не используйте eleven_flash_v2_5 для агентов только на английском языке, иначе создание агента может завершиться ошибкой валидации.
  • Включите клиентские события, необходимые для рендеринга стенограммы и аудио.
  • Возвращайте { agentId, agentName }.

Защищенный GET endpoint, который возвращает свежий токен беседы для заданного agentId. Никогда не раскрывайте ELEVENLABS_API_KEY клиенту.

Минимальная страница голосового агента Next.js.

  • Используйте ConversationProvider из @elevenlabs/react.
  • Используйте гранулярные хуки беседы useConversationControls и useConversationStatus.
  • Покажите кнопку Create Agent и редактируемый ввод agent-id. Автоматически заполняйте при создании; разрешите вставлять другой id для его загрузки.
  • Начинайте голосовые сессии со свежим токеном из /api/conversation-token. Запросите доступ к микрофону перед началом.
  • Полагайтесь на вывод типа соединения SDK при запуске сессии; не прописывайте жестко connectionType: "webrtc", если нет особой причины.
  • Покажите переключатель Старт/Стоп, статус соединения и текущую стенограмму беседы (добавляйте сообщения, не заменяйте).
  • Обрабатывайте ошибки корректно и разрешайте переподключение. Сохраняйте UI простым и voice-first.

План урока

  1. 1. package.json
  2. 2. app/api/agent/route.ts
  3. 3. app/api/conversation-token/route.ts
  4. 4. app/page.tsx

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы ElevenLabs 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от ElevenLabs (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды