Документация / Операционный агент
Операционный агент: шаги
Все действия, которые можно поставить на доску: от скачивания и расшифровки записи до писем, вебхуков, условий и передачи работы другим агентам.
Последнее обновление:
Палитра слева в конструкторе группирует шаги: Запись, Понимание, Отчёты, Доставка, Хранилище и Поток. Нажмите на шаг на доске, чтобы настроить его в инспекторе; инспектор также перечисляет, что шаг производит для следующих шагов. Редко нужные настройки свёрнуты в раздел Дополнительные параметры.
Запись#
Скачать запись загружает запись звонка во временную папку, которая удаляется по окончании запуска; ничего не сохраняется. По умолчанию шаг берёт ссылку на запись из триггера. Максимальный размер (МБ) ограничивает скачивание (по умолчанию 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 отклонила расшифровку. В настройках повторов шага выберите, переходить ли на ветку ошибки после исчерпания повторов или при первой же ошибке.