Подключение голосового агента к телефонному вызову — это тот этап, который заставляет вас отвлечься от редактора кода. Вы настраиваете соединение в одной вкладке консоли и привязываете номер в другой. Затем вызов обрывается, вы получаете код завершения и начинаете гадать, в чем причина.

Сегодня мы выпускаем Plivo CLI — интерфейс командной строки для API Plivo, созданный для разработчиков, которые внедряют голосовых агентов, и для кодинг-агентов, работающих вместе с ними.

Существует два распространенных способа подключения голосового агента к телефонной сети, и CLI поддерживает оба:

Потоковая передача аудио (Audio Streaming): Ваш агент работает через WebSocket. Plivo передает ему аудиопоток вызова и, в рамках двунаправленного потока, воспроизводит аудио, которое он отправляет обратно.
SIP-транкинг: Ваш агент работает по протоколу SIP. Plivo направляет вызовы на него через транк.

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

Установка и вход

Один бинарный файл, никакой среды выполнения. macOS, Linux и Windows, с поддержкой Scoop и shell-установщиков, описанных в руководстве по установке. Вход в систему осуществляется через браузер, поэтому ваш пароль никогда не передается в CLI.

Потоковая передача аудио вызова вашему агенту

Протестируйте WebSocket-соединение перед привязкой телефонного номера, а затем принимайте реальные вызовы на локальном агенте.

Тест: команда plivo voice streams test отправляет аудио в формате Plivo и подсчитывает ответы. Живой вызов позволяет дополнительно проверить, корректно ли воспроизводится возвращаемое аудио.
Переадресация: команда plivo voice streams forward перенаправляет аудио входящего вызова на ваш ноутбук без необходимости в сторонних сервисах для создания туннелей. Используйте тестовое приложение.

Начните с руководства по Pipecat.

Подключение агента по SIP

Управляйте стороной Plivo вашего SIP-соединения прямо из терминала:

Подключение: создавайте транки, управляйте аутентификацией и привязывайте телефонные номера с помощью команд plivo sip и plivo numbers.
Инспекция: просматривайте записи SIP-вызовов для выяснения причин завершения и деталей передачи данных в случае сбоя вызова.

Настройте маршрутизацию к вашему агенту на платформе. Руководство по настройке LiveKit охватывает обе стороны.

Получайте ответы, не покидая терминал

Используйте plivo ask для вопросов о разработке на Plivo. Для потоковой передачи аудио или других вызовов Voice API команда diagnose объяснит, что произошло, укажет вероятную причину и подскажет, что нужно изменить.

Для SIP-вызовов просматривайте запись вызова с помощью plivo sip calls get.

Предоставьте контекст вашему кодинг-агенту

Встроенные навыки обучают вашего кодинг-агента использованию CLI, потоковой передачи аудио, SIP-транкинга и Voice XML. Они устанавливаются локально и не требуют сетевых запросов.

CLI также поддерживает вывод в формате JSON для команд API, предварительный просмотр через --dry-run и явное подтверждение для команд, связанных с расходами.

Начало работы

Выберите WebSocket или SIP-транкинг, а затем используйте CLI для подключения вашего агента.

Plivo CLI распространяется с открытым исходным кодом по лицензии Apache 2.0. Расскажите нам о своих впечатлениях с помощью plivo feedback или создайте тикет в репозитории.

Команда Plivo

Блог Plivo