Dev48
ЯЗЫК
  • О нас
  • Услуги
  • Индустрии
  • Технологии
  • Статьи
  • Контакты
Забронировать звонок
    Главная/Статьи/Sozdanie govoryaschey tykvy na hellouin s pomoschyu ai agenta signalwire
Dev48
info@dev48.org+375 29 320-40-96WhatsApp@isky_by

© 2026 · Все права защищены.

Создание говорящей тыквы на Хэллоуин с помощью AI-агента SignalWire

Источник: Signalwire•16 ноября 2026 г. в 21:34

Создание говорящей тыквы на Хэллоуин с помощью AI-агента SignalWire

AI-агент SignalWire внутри тыквы на Хэллоуин

Статья

16 ноября 2026 г.

читать

AI-агент SignalWire внутри тыквы на Хэллоуин

Адам Келси

Исполнительный вице-президент по продуктам

Создайте бесплатно.

Создайте пространство и запустите свой первый поток вызовов за считанные минуты.

Голосовой ИИ

AI-агенты

Руководства для разработчиков

Трое детей подходят к дому в ночь на Хэллоуин. Пугало с горящей тыквой вместо головы наблюдает за их приближением.

«Ведьма», — говорит оно. — «Как смело. Как совершенно беспрецедентно».

Ведьма смеется. Вампир рядом с ней спрашивает тыкву, сколько ей лет. «Меня вырезали во вторник», — отвечает она и снова начинает игнорировать их так внимательно, как только может.

Тыква настоящая, и внутри у нее спрятан секрет: AI-агент SignalWire на видеозвонке. Компьютер внутри декорации поддерживает вызов всю ночь, используя веб-камеру в качестве глаз, а динамик — в качестве рта. Агент видит, кто перед ним, и общается с ними в рамках своей роли. Когда в группе есть маленький ребенок, он остается таким же величественным, как всегда, но никто из присутствующих не является объектом шутки.

Эта серия статей показывает, как я это создал. В отрывках каждого поста представлены идеи, а в репозитории ai-jackolantern находится полный рабочий код.

Что охватывает серия

Серия состоит из девяти частей, каждая из которых добавляет работающий элемент:

  • Система и вызов (этот пост).

Система и вызов (этот пост).

  • Агент: личность и три режима, как контексты и шаги.

Агент: личность и три режима, как контексты и шаги.

  • Инструменты: что ИИ вызывает на моем сервере и почему его материалы хранятся в коде.

Инструменты: что ИИ вызывает на моем сервере и почему его материалы хранятся в коде.

  • Зрение: позволяем агенту видеть и проверяем камеру перед любым важным решением.

Зрение: позволяем агенту видеть и проверяем камеру перед любым важным решением.

  • Сцена: обнаружение того, кто стоит перед тыквой, в браузере.

Сцена: обнаружение того, кто стоит перед тыквой, в браузере.

  • Голос: аудиоэффекты в браузере.

Голос: аудиоэффекты в браузере.

  • Темп и состояние: сервер ведет счет.

Темп и состояние: сервер ведет счет.

  • Оператор: человек с телефоном, который может перехватить управление у агента.

Оператор: человек с телефоном, который может перехватить управление у агента.

  • Тестирование и работа в течение всей ночи.

Тестирование и работа в течение всей ночи.

К концу этого поста в браузере будет запущен видеозвонок к AI-агенту SignalWire.

Компоненты

Тыква работает в четырех местах:

Компонент

Где работает

Задача

Страница тыквы

Компьютер внутри декорации

Поддерживает вызов, отправляет видео с камеры и звук с микрофона, воспроизводит голос через аудиоэффекты, определяет, кто находится на сцене

AI-агент

SignalWire

Слушает, смотрит, говорит и вызывает инструменты

Мой сервер

Любой хост с публичным HTTPS-адресом

Обслуживает конфигурацию агента и страницу, запускает инструменты, сохраняет состояние каждого визита

Телефонный пульт

Телефон оператора

Запускает и останавливает шоу, настраивает параметры, переключает режимы

Сервер представляет собой один процесс на Python, построенный на нашем Python SDK (signalwire-sdk). Он обслуживает агента, страницу тыквы и API страницы через один порт.

Как проходит вызов

Каждый раз, когда страница совершает вызов, он проходит через одни и те же этапы:

  • Страница запрашивает у моего сервера гостевой токен по адресу /eyes-token.

Страница запрашивает у моего сервера гостевой токен по адресу /eyes-token.

  • Страница набирает адрес агента с этим токеном по видеосвязи.

Страница набирает адрес агента с этим токеном по видеосвязи.

  • SignalWire получает конфигурацию агента с моего сервера по адресу /pumpkin. Конфигурация представлена в формате SWML — нашей разметке для потоков вызовов, которую SDK записывает из кода на Python.

SignalWire получает конфигурацию агента с моего сервера по адресу /pumpkin. Конфигурация представлена в формате SWML — нашей разметке для потоков вызовов, которую SDK записывает из кода на Python.

  • SignalWire запускает глагол ai из этого SWML: распознавание речи, модель, преобразование текста в речь и зрение.

SignalWire запускает глагол ai из этого SWML: распознавание речи, модель, преобразование текста в речь и зрение.

  • Когда модель вызывает инструмент, SignalWire отправляет запрос на /pumpkin/swaig на мой сервер, и мой код отвечает.

Когда модель вызывает инструмент, SignalWire отправляет запрос на /pumpkin/swaig на мой сервер, и мой код отвечает.

Настройка SignalWire из кода

Страница набирает адрес, который принадлежит ресурсу в моем пространстве SignalWire. Мой сервер создает этот ресурс при запуске, поэтому новое развертывание не требует настройки в панели управления. Ресурс представляет собой вебхук SWML, что означает, что SignalWire получает инструкции для вызова по URL при поступлении звонка. Код настройки находит ресурс по имени, создает его, если он отсутствует, и исправляет его URL, если он указывает куда-то еще. Двойной запуск ничего не меняет.

URL агента содержит имя пользователя и пароль для базовой аутентификации, поэтому только SignalWire может получить конфигурацию. Я вывожу пароль из токена API с помощью HMAC, поэтому он остается неизменным после каждой перезагрузки. Это означает, что текущий вызов продолжает работать, когда сервер перезагружается.

Файл .env сервера содержит SIGNALWIRE_SPACE, SIGNALWIRE_PROJECT_ID и SIGNALWIRE_API_TOKEN, а также SWML_PROXY_URL_BASE — публичный HTTPS-адрес сервера, чтобы SignalWire знал, где искать агента.

Создание гостевого токена

Любой может прочитать содержимое страницы в браузере, поэтому страница никогда не получает учетные данные проекта. Вместо этого мой сервер создает для нее гостевой токен, который может набрать один адрес и истекает через два часа.

Ответ также указывает странице набрать видеоканал адреса, чтобы агент мог видеть. Маршрут токена защищен паролем (EYES_PASSWORD), поскольку каждый токен может инициировать платный вызов.

Вызов из браузера

Страница использует наш Browser SDK v4 (@signalwire/js), который принимает поставщика токенов — объект с методами authenticate() и refresh(). Мой поставщик делает запрос к /eyes-token, и SDK вызывает refresh() до истечения срока действия токена, поэтому один вызов может пережить множество токенов.

При вызове передается обработанный поток с микрофона страницы и камера, которую я открываю в разрешении 640 на 480 при 10 кадрах в секунду. Этого достаточно для модели зрения, и это снижает нагрузку на скрытый компьютер. У тыквы нет экрана, поэтому она получает только аудио.

Поддержание вызова всю ночь

Вызов, который длится часами, время от времени будет обрываться, поэтому страница набирает номер в цикле, если вызов прерывается. Вызов, который длился не менее 30 секунд, повторяется сразу. Тот, который сразу завершился неудачей, делает паузу от 5 до 60 секунд, чтобы сломанный агент не зацикливал процесс. Если вызов не начался в течение 30 секунд, страница пересоздает клиент SDK на месте. Перезагрузка потребовала бы еще одного клика на странице, прежде чем Chrome начнет воспроизводить аудио.

Ловушки, которых следует избегать

Не размещайте учетные данные проекта на странице. Любой может открыть исходный код страницы. Конечно, вы единственный, кто запускает страницу, и никто другой не знает URL, но вырабатывайте хорошие привычки с самого начала. Создавайте короткоживущий гостевой токен на своем сервере, ограниченный одним адресом, который может вызвать страница, и установите пароль на маршрут токена.

Не передавайте в SDK только обработанное аудио. Как только вы передаете inputAudioStream, SDK отправляет только те потоки, которые вы ему даете, и игнорирует настройки устройства. Передавайте камеру также как inputVideoStream, иначе вызов уйдет без видео, и агент будет слеп.

Далее в этой серии

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

← Все статьи

О чём эта статья

Ещё в разделе «Телеком и сети»

Все →
Вероятность слияния Tesla и SpaceX к апрелю 2027 года превысила 60%Пресса
SpaceX

Вероятность слияния Tesla и SpaceX к апрелю 2027 года превысила 60%

Альтернатива Lumen Voice: без потери гудка
Infobip

Альтернатива Lumen Voice: без потери гудка

Что может делать ИИ-агент в Bird: CLI, MCP, регистрация через терминал и контроль расходов
MessageBird

Что может делать ИИ-агент в Bird: CLI, MCP, регистрация через терминал и контроль расходов

Vonage Video API 2.36: логика повторных попыток, наблюдаемость и поддержка iOS 27
Vonage API Platform

Vonage Video API 2.36: логика повторных попыток, наблюдаемость и поддержка iOS 27

Поиск номеров теперь доступен пользователям суборганизаций
Telnyx

Поиск номеров теперь доступен пользователям суборганизаций

От B20 до Брюсселя: сети, масштаб и определенность для конкурентоспособного ИИ
Telefónica

От B20 до Брюсселя: сети, масштаб и определенность для конкурентоспособного ИИ

Ещё от Signalwire

Голосовой ИИ взрослеет
Signalwire

Голосовой ИИ взрослеет

Что ваш ИИ-агент никогда не должен слышать: номера карт и CVV
Signalwire

Что ваш ИИ-агент никогда не должен слышать: номера карт и CVV

Создание голосового ИИ-агента, который следует коду, а не промптам
Signalwire

Создание голосового ИИ-агента, который следует коду, а не промптам

Что такое «Prompt and Pray»?
Signalwire

Что такое «Prompt and Pray»?

Итоги ClueCon 2026
Signalwire

Итоги ClueCon 2026

Борьба со спуфингом Caller ID с помощью STIR/SHAKEN
Signalwire

Борьба со спуфингом Caller ID с помощью STIR/SHAKEN