Подключение голосового агента к телефонному вызову — это тот этап, который заставляет вас отвлечься от редактора кода. Вы настраиваете соединение в одной вкладке консоли и привязываете номер в другой. Затем вызов обрывается, вы получаете код завершения и начинаете гадать, в чем причина.
Сегодня мы выпускаем 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
