Документация / Операционный агент

Операционный агент: шаги

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

Последнее обновление:

Палитра слева в конструкторе группирует шаги: Запись, Понимание, Отчёты, Доставка, Хранилище и Поток. Нажмите на шаг на доске, чтобы настроить его в инспекторе; инспектор также перечисляет, что шаг производит для следующих шагов. Редко нужные настройки свёрнуты в раздел Дополнительные параметры.

Запись#

Скачать запись загружает запись звонка во временную папку, которая удаляется по окончании запуска; ничего не сохраняется. По умолчанию шаг берёт ссылку на запись из триггера. Максимальный размер (МБ) ограничивает скачивание (по умолчанию 200 МБ). Шаг производит file, filename, bytes и content_type.

Понимание#

Расшифровать превращает запись в текст.

  • Язык речи: код, например el или en; если оставить пустым, язык определяется автоматически.
  • Также на языках: дополнительные языки; переводы находятся в {{transcribe.translations}}.
  • Разделить говорящих: делит текст на реплики, {{transcribe.segments}} (говорящий, начало и конец в секундах, текст).
  • Назвать говорящих: numbers (1, 2) или agent_customer: каждая реплика помечается agent (ваша сторона звонка) или customer, что ИИ определяет по разговору и направлению звонка. Голос, который он не может отнести к стороне, сохраняет свой номер, а {{transcribe.speakers_note}} объясняет почему.

Шаг производит text, language, duration_sec, translations, segments, speakers и speakers_note.

Сводка пишет краткое содержание расшифровки или любого текста: кратко, подробно или списком, на выбранном вами языке, с необязательными дополнительными указаниями. Шаг производит text.

Отчёты#

Отчёт по вопросам отвечает на ваши заранее подготовленные вопросы по расшифровке (например, Сделал ли клиент заказ?) и строит онлайн-отчёт и книгу Excel, по желанию вместе с расшифровкой. Запуск показывает каждый ответ и место в звонке, где он был найден. Шаг производит title, answers и книгу для шага отправки письма.

Доставка#

Отправить письмо отправляет сообщение с подставленными значениями потока.

  • Кому, Копия, Скрытая копия, Ответить на и Имя отправителя.
  • Шаблон письма: один из фирменных макетов вашей учётной записи или никакого, чтобы отправить сообщение как есть (см. Шаблоны писем).
  • Формат: обычный текст или HTML (к HTML также добавляется текстовая копия).
  • Добавьте расшифровку в текст сообщения, приложите её файлом .txt, приложите отчёт Excel.

Вебхук вызывает ваш URL в этой точке потока: метод (POST, PUT, PATCH, GET, DELETE), параметры запроса, заголовки, аутентификация (bearer token, basic, API-ключ) и тело в формате JSON, формы или текста, причём в каждое значение подставляются данные потока. С Секретом подписи каждый вызов подписывается, чтобы ваш адрес мог проверить, что он пришёл от нас. Ваш адрес подтверждает получение ответом 2xx; любой другой ответ считается неудачной попыткой и повторяется. Шаг производит status, response и json (разобранный ответ) для следующих шагов.

Чтобы отправить в CRM расшифровку, разделённую по говорящим, укажите в теле "transcript": {"text": "{{transcribe.text}}", "segments": "{{transcribe.segments}}"}.

Оба шага доставки можно просмотреть и проверить по отдельности: см. Проектирование и тестирование.

Хранилище#

S3 и AWS S3 работают с бакетами, файлами и папками в вашем собственном хранилище: загрузить запись или расшифровку, скопировать, получить список, скачать или удалить. См. Хранилище (S3).

Поток#

  • Условие сравнивает значение (равно, не равно, содержит, больше, меньше, пусто, не пусто) и продолжает по ветке да или нет.
  • Диспетчер отправляет данные сразу нескольким получателям: другим операционным агентам проекта, каждый из которых делает свою работу, и адресам вебхуков. Получатели, которые уже успешно приняли данные, при повторе не получают их снова.
  • Вызвать другого агента запускает одного другого операционного агента проекта с данными из этого потока и по умолчанию ждёт его результата (status, output).

Ветки успеха и ошибки#

Стрелка может выходить из шага при успехе или при ошибке. Ветка ошибки позволяет сообщить кому-нибудь, когда шаг сдаётся, например отправить письмо команде, если ваша CRM отклонила расшифровку. В настройках повторов шага выберите, переходить ли на ветку ошибки после исчерпания повторов или при первой же ошибке.

Консоль

Эти страницы доступны только для чтения. Тестовый звонок, ключи API и актуальный справочник API находятся в консоли, где выполнен вход в ваш аккаунт.

Открыть консоль