Запросить ИИ (Ask AI)

Блок сценария Запросить ИИ (Ask AI) используется для извлечения данных и создания контента с помощью ИИ в рабочих процессах (Workflows), сценариях электронной почты и задач. Он отправляет ваши инструкции большой языковой модели поставщика ИИ. ИИ обрабатывает инструкции и возвращает структурированные данные, которые сохраняются в переменные для дальнейшего использования в сценарии.

Чтобы передать ИИ информацию, необходимо явно включить ее в параметр Инструкция для ИИ с помощью соответствующих переменных сценария. Содержимое письма или задачи не отправляется автоматически, поэтому вы полностью контролируете сведения, которые получает ИИ.

Чтобы ИИ обработал письмо, включите переменную $(item.body) непосредственно в инструкции. Пример см. в описании параметра Инструкция для ИИ.

С помощью функций email_remove_quoted_content_html или email_remove_quoted_content_plaintext можно удалить цитируемые ответы из содержимого письма перед отправкой ИИ.

Типичные задачи блока Запросить ИИ (Ask AI):

  • Автоматизация ответов.
  • Извлечение ключевых сведений, например номеров заказов и намерения клиента, для дальнейшей логики сценария.
  • Подготовка черновиков последующих писем или сообщений для проверки оператором.
  • Определение категорий обращений для автоматической маршрутизации.

Настройки блока Ask AI

Блок Запросить ИИ (Ask AI) обрабатывает взаимодействия в следующем порядке:

  1. Выполнение: при выполнении блока Ask AI сценарий подготавливает запрос к выбранному поставщику ИИ.
  2. Формирование запроса: блок создает единый запрос, включающий:
    • Содержимое поля Инструкция для ИИ с подстановкой текущих значений всех переменных сценария.
    • Встроенные инструкции, требующие от ИИ вернуть ответ в корректном формате JSON. Структура JSON динамически задается полями, настроенными в параметре Данные для извлечения.
  3. Обработка ИИ: запрос отправляется в API поставщика ИИ. Блок ожидает ответ в течение времени, заданного параметром Тайм-аут ответа ИИ.
  4. Обработка ответа:
    • Успешно: если поставщик ИИ возвращает корректный ответ JSON до истечения тайм-аута, блок разбирает его и заполняет переменные сценария, заданные в параметре Данные для извлечения, значениями из JSON. Затем выполнение переходит к следующему блоку сценария.
    • Ошибка: если поставщик ИИ возвращает ошибку, например ошибку аутентификации или недопустимого запроса, блок заполняет переменные $(aiErrorCode) и $(aiErrorBody) и переходит по выходу Ошибка.
    • Тайм-аут: если поставщик ИИ не отвечает за заданное время, блок переходит по выходу Тайм-аут.

Настройки

Текст заголовка

Название экземпляра блока в сценарии. Поле необязательное.

Поставщик ИИ

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

  • << Default >>: используется учетная запись ИИ, настроенная поставщиком услуг в составе выбранного пакета ИИ (AI Package). Если контакт-центру не назначен пакет, при выборе этого варианта появится ошибка. В таком случае обратитесь к поставщику услуг.
  • Также можно выбрать любую учетную запись интеграции с поставщиком ИИ, настроенную в контакт-центре.

Инструкция для ИИ

Это обязательное текстовое поле с четкими и конкретными инструкциями для ИИ. Используйте переменные сценария для включения динамических данных, например текста письма или описания заявки.

В поле серым цветом показан текст-подсказка с примером структуры инструкции. Он исчезает, как только вы начинаете ввод.

Пример инструкций:

Analyze the incoming email from the customer. 
Provide the following:
* The reason for contact
* A brief summary of the issue
* If an order ID is mentioned, extract it; otherwise, return 'false' for the order_id variable. 

Email content: 

```
$(item.body)
```

Данные для извлечения

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

Нажмите Добавить выходные данные (add Output Data), чтобы открыть окно настройки каждого извлекаемого элемента данных:

  • Имя переменной: имя переменной сценария, в которой будут храниться извлеченные данные, например order_id.
  • Описание данных: описание извлекаемых данных на естественном языке. Оно помогает ИИ понять, что искать, например: «Идентификатор заказа клиента, упомянутый в письме».
  • Пример значения: необязательный пример значения, который помогает ИИ понять задачу.

Задайте данные, которые нужно извлечь согласно инструкциям.

Тайм-аут ответа ИИ

Максимальное время в секундах, в течение которого система ожидает ответа ИИ, прежде чем перейти по выходу Тайм-аут. Допустимы значения от 1 до 300 секунд; значение по умолчанию — 100.

Температура модели

Управляет творческой вариативностью ответа ИИ. Подробное описание см. в разделе Температура модели блока ИИ-агент.

Выходы

Ошибка

Этот условный выход используется при ошибке запроса к поставщику ИИ. Ветвь выхода должна корректно обрабатывать такие ошибки.

Тайм-аут

Этот условный выход используется, если поставщик ИИ не ответил за время, заданное параметром Тайм-аут ответа ИИ. Для обработки тайм-аутов необходимо создать ветвь от этого выхода.

Переменные

Переменные расхода токенов

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

Переменные ошибок

Используются те же переменные ошибок, что и в блоке сценария ИИ-агент.