Создать и настроить AI-операцию

Перед созданием AI‑операций убедитесь, что вы подключили в ELMA Cortex провайдеров языковых моделей.

Для настройки AI‑операции выполните в ELMA Cortex следующие шаги:

1. Добавьте AI‑операцию.
2. Задайте основные настройки — выберите языковую модель, составьте инструкцию (промпт) для обработки задач и укажите формат входных и выходных данных. Также укажите среду выполнения AI‑операции — OpenAI или ReAct. Она определяет особенности работы с инструментами.
3. Подключите инструменты — вы можете настроить для AI‑операции дополнительные функции. Они определяют, какие данные она сможет получать, какие действия ей доступны в ELMA365 и т. д. Также можно подключить в качестве инструментов дочерние компоненты ELMA Cortex, чтобы настроить маршрутизацию сложных задач.
4. Подключите управляемых агентов — при необходимости укажите дочерних AI‑агентов со специализированными функциями, которым AI‑операция сможет передавать задачи вместе со всем контекстом их выполнения. Это второй способ маршрутизации задач в AI‑операции.
5. Задайте API-ключ для вызова AI‑операции в скриптах — опционально настройте возможность обращаться к AI‑операции с помощью API из скриптов ELMA365 и внешних систем.

После завершения настройки выполните отладку AI‑операции и настройте её вызов в ELMA365.

Шаг 1. Добавить AI-операцию

1. В левом меню ELMA Cortex перейдите на страницу AI‑Операции.
2. Нажмите кнопку Добавить AI-Операцию.
3. В открывшемся окне введите название операции.
4. Нажмите Создать.

Шаг 2. Задать основные настройки AI-операции

На вкладке Настройки установите основные параметры:

1. Заполните поля в разделе Генерация ответа:

• Инструкции — составьте промпт, описывающий действия AI‑операции и желаемый результат;
• LLM модель — выберите языковую модель, которая будет использоваться для генерации ответов. Список доступных вариантов зависит от подключённых провайдеров больших языковых моделей.

В этом поле также доступны параметры, которые позволяют дополнительно настроить предсказуемость и разнообразие в ответах AI‑операции. Рекомендуем полностью завершить настройку и проверить работу AI‑операции с параметрами, установленными по умолчанию, затем изменять их под свои задачи при неудовлетворительных результатах. Это делается так же, как настройка параметров генерации ответа для AI‑агента;

• Тип рантайма — выберите среду выполнения AI‑операции — OpenAI или ReAct. Она определяет принцип вызова инструментов. Убедитесь, что среда выполнения поддерживается для выбранной языковой модели:
  • OpenAI — для применения инструментов используется вызов функций. Модель получает описание доступных инструментов и отправляет структурированный запрос на их использование. Это надёжный способ, который подходит для большинства задач;
  • ReAct — на каждом шаге выполнения задачи языковая модель предоставляет текстовое рассуждение о том, какие действия собирается совершить, затем в виде текста указывает, какой инструмент использовать.

2. В разделе Параметры AI-Операции укажите формат входных данных и ответа языковой модели. Для них доступны одинаковые опции, которые можно сочетать в зависимости от ваших задач:

3. Если для входных данных или ответа вы выбрали опцию Строгая схема JSON, задайте структуру данных. Вы можете:

• написать JSON-схему в появившемся поле;
• добавить поля в JSON-схему с помощью визуального редактора. В редакторе доступны все основные возможности JSON.

Обратите внимание, разные языковые модели поддерживают разные стандарты JSON. Чтобы определить, какие функции вы можете использовать, обратитесь к документации модели.

4. Заполните поля в разделе Среда выполнения:

• Режим API — при выборе среды выполнения OpenAI укажите режим взаимодействия с языковой моделью — Chat Completions API или Responses API. Рекомендуем использовать режим Responses API, так как он более актуален. Убедитесь, что он поддерживается провайдером выбранной языковой модели;

• Максимальное количество итераций агента — доступное число циклов обработки запроса перед предоставлением ответа. Каждый цикл включает обращение к языковой модели, возможный вызов инструментов и работу с результатами. Высокие значения повышают точность ответов, но при этом расходуется больше токенов;
• Максимальный размер ответа инструмента (в токенах) — максимальное количество токенов в ответе от инструмента, которые используются для формирования ответа AI‑операции. Установка ограничения позволяет сократить затраты токенов;
• Включить параллельный вызов инструментов — при выполнении запроса AI‑операция по умолчанию вызывает инструменты последовательно. Этот способ более стабилен. Включите параллельный вызов, чтобы работа разных инструментов запускалась одновременно. Это позволяет сократить время ответа AI‑операции. Опция доступна только для среды выполнения OpenAI;
• Включить stream режим — установите настройку в зависимости от доступности stream-режима в используемой языковой модели.

5. Нажмите Сохранить.

Настроить JSON-схему в визуальном редакторе

Вы можете определить структуру входных данных или ответа AI‑операции с помощью визуального редактора:

1. После выбора опции Строгая схема JSON нажмите под полем Настроить схему.
2. В открывшемся окне нажмите слева кнопку + Добавить поле.
   
3. Заполните свойства поля.
   

• Имя поля — введите название поля в JSON‑объекте;
• Описание — опишите содержание поля;
• Обязательное поле — отметьте опцию, если поле не должно быть пустым. Обратите внимание, если вы отмечаете поле обязательным в схеме входных данных, при передаче пустого значения работа AI‑операции завершится с ошибкой;
• Тип поля — укажите тип данных:
  • Текст — текстовая информация, такая как имя клиента или описание проблемы из обращения. Этот тип также используется для записи даты и времени, адреса электронной почты, денежных единиц с указанием валюты и т. п.;
  • Число — целое число или десятичная дробь;
  • Да/Нет — значение true или false;
  • Группа — используется для объединения нескольких полей, связанных по смыслу. Например, всех полей элемента приложения ELMA365;
  • Список — набор однотипных значений, например, дат, сумм и т. п.;
  • Файл — документ из ELMA365. Обратите внимание, с помощью такого поля можно передать только один файл. Для работы с несколькими файлами используйте тип Список.

4. Нажмите в правом нижнем углу Добавить поле.
5. Настройте возможные значения поля, нажав слева от него значок стрелки. Доступные опции зависят от типа поля:
   

• Текст — вы можете:
  • указать минимальную и максимальную длину значения;
  • определить формат — задать шаблон в виде регулярного выражения или выбрать вариант из списка. Учитывайте, какую из этих опций поддерживает ваша языковая модель. Если для входных данных значение в поле не соответствуют выбранному формату, произойдёт ошибка;
  • задать разрешённые значения — если значения должны выбираться из ограниченного списка, укажите допустимые варианты. Для этого введите текст каждого из них и нажмите Добавить;
• Число — вы можете:
  • указать минимальное и максимальное значение — включительно или исключая введённое число;
  • ввести число, которому значение должно быть кратно;
  • задать разрешённые значения — составить список вариантов так же, как для поля типа Текст;
• Да/Нет — вы можете сделать значение true или false недопустимым. Например, в этом поле ставится отметка об удалении обращения, а AI‑операция должна работать только с элементами, которые не удалены. Тогда возможен вариант false или пустое значение. Когда в этом поле передаётся значение true, происходит ошибка;
• Объект (соответствует типу Группа) — добавьте поля, которые нужно объединить в одну группу, например свойства элемента приложения ELMA365. Для этого в левом нижнем углу нажмите Добавить поле и задайте настройки;
• Список — вы можете:
  • указать минимальное и максимальное число значений в списке;
  • сделать уникальность элементов обязательной — чтобы в списке не повторялись одинаковые значения;
  • задать тип элемента — установить тип данных, которому соответствуют значения в списке. Доступны те же типы, что и для полей в JSON‑схеме;
• Файл — поле этого типа настроить нельзя.

6. После добавления всех полей вы можете загрузить JSON‑схему AI‑операции на компьютер, например, чтобы настроить заполнение входных данных. Для этого нажмите в правом верхнем углу значок скачивания .

Обратите внимание, при размещении AI‑операции в процессах или интерфейсах вы сможете вместо заполнения JSON‑схемы сопоставить её поля со свойствами из контекста процесса, приложения и т. д.

7. Нажмите Сохранить.

Шаг 3. Подключить к AI-операции инструменты

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

Для добавления инструмента:

1. На вкладке Инструменты нажмите кнопку + Инструмент. Если для AI‑операции уже созданы инструменты, кнопка называется + Добавить инструменты.
2. Выберите тип инструмента из списка, затем нажмите Далее, чтобы настроить его:

• MCP сервер — для AI‑операции можно настроить дополнительные функции с помощью MCP‑сервера, например для обращения к сторонней системе. Например, вы можете настроить свои инструменты для взаимодействия с ELMA365, создав модуль, выполняющий роль MCP‑сервера.

В открывшемся окне настройте инструмент:

• выберите тип сервера — SSE или Streamable;
• укажите адрес сервера;
• выберите тип авторизации. При использовании модуля ELMA365 как сервера MCP нужно настроить подключение к компании;
• добавьте заголовки HTTP с данными аутентификации или служебной информацией;
• Дата/Время — AI‑операция сможет получить текущую дату и время, например, чтобы показать заявки за определённый период;
• Умный поиск — подключите настроенный проект умного поиска, чтобы AI‑операция могла искать информацию по его базе данных;
• Содержимое по URL — AI‑операция получит доступ к чтению веб‑страниц, например, если нужно получить содержание страницы по ссылке. В открывшемся окне укажите:
  • максимальную длину возвращаемого содержимого — если значение превышено, AI‑операция принимает решение о необходимости загружать следующую часть страницы;
  • время, в течение которого операция ожидает загрузку страницы — позволяет ускорить подготовку ответа, если страница оказывается недоступна;
  • список доменов — сайты, к которым AI‑операция сможет обращаться. Если оставить поле пустым, доступны любые сайты;
• ELMA365: Базовый набор — AI‑операция может использовать преднастроенные инструменты для работы с ELMA365. Они позволяют получать данные текущего пользователя и информацию из полей и ассоциированной ленты элемента приложения, открытого в данный момент. Также они используются для анализа текста из файлов и описания изображений.

В окне настройки:

• выберите подключение к компании ELMA365 — чтобы связать инструмент с компанией и определить для него права доступа;
• введите уникальный префикс для этого набора инструментов — если вы добавите другой набор инструментов для работы с ELMA365, разные префиксы позволят AI-операции корректно обращаться к инструментам со схожими названиями;
• настройте получение информации из ассоциированной ленты элемента приложения — можно загружать содержимое сообщений или только их количество. Вы также можете позволить AI‑операции принимать решение самостоятельно и получать содержимое ленты, когда это необходимо для выполнения задачи;
• ограничьте объём информации, которая загружается из ассоциированной ленты элемента и из файла — если указанное значение превышено, AI‑операция принимает решение о необходимости загружать следующую часть данных;
• выберите отдельную языковую модель для описания изображений;
• ELMA365: Конфигурация — AI-операция сможет применять пользовательский набор инструментов ELMA365, который позволяет выполнять настроенные действия в рамках определённых приложений и бизнес‑процессов. Например, создавать записи в выбранных приложениях, назначать пользователям задачи и т. д.

В открывшемся окне:

• выберите набор инструментов — подключение к компании ELMA365 определится автоматически из его настроек;
• укажите для набора инструментов уникальный префикс так же, как для типа ELMA365: Базовый набор;
• Файлы и изображения — инструмент позволяет AI‑операции извлекать текст из документов и описывать изображения. В открывшемся окне:
  • ограничьте объём текста, получаемый из файла — если значение превышено, AI-агент принимает решение о необходимости загрузить следующую часть документа;
  • выберите языковую модель для описания изображений;
• Агент — чтобы получать более точные результаты, вы можете добавить дочернего AI-агента или AI‑операцию для маршрутизации задач. Тогда при выполнении отдельных этапов работы текущая AI‑операция сможет вызывать дочерний компонент, в котором настроены более специализированные функции. В окне настройки опишите, в каких случаях дочерний компонент следует использовать.

При подключении AI‑операции в качестве инструмента учитывается настроенный для неё формат входных данных. Если для дочерней операции нужен другой формат, родительская AI‑операция преобразует передаваемую информацию в текст или JSON‑объект.

Обратите внимание, когда AI-агент или AI‑операция используются как инструменты, они не получают доступ к контексту выполнения родительской AI‑операции. Действия выполняются на основе переданных данных, затем возвращается результат. Чтобы делегировать задачи с доступом к полному контексту работы AI‑операции, используйте управляемых агентов.

3. Нажмите Сохранить.

AI-операция будет определять и использовать подходящие инструменты, чтобы сформировать ответ или совершить действие.

Шаг 4. Подключить к AI-операции управляемых агентов

Добавление управляемых AI‑агентов — один из способов маршрутизации задач, доступных для AI‑операции. Операция сможет передавать управляемому дочернему агенту этапы работы, на которых он специализируется, что обеспечивает более точные результаты.

В отличие от AI‑агентов, которые используются как инструменты, управляемые агенты получают весь контекст выполнения операции при делегировании задачи. Управляемый агент делает свою часть работы и передаёт результат AI‑операции.

Для подключения дочернего AI‑агента:

1. На вкладке Управляемые агенты нажмите кнопку + Добавить.
2. В открывшемся окне выберите настроенного AI‑агента и напишите инструкцию по передаче задач.
3. Нажмите Сохранить.

Шаг 5. Задать API-ключ для вызова AI‑операции в скриптах

Вы можете обращаться к AI‑операции с помощью API в скриптах ELMA365 или из сторонних систем.

Для этого на вкладке API-ключи настройте авторизацию запросов к AI‑операции, нажав + Добавить ключ, указав его название и выбрав в поле Доступ значение Чат.

После этого вы можете вызывать AI‑операцию в скрипте, используя его API-ключ и идентификатор из поля ID агента для API.

Документация по публичному API ELMA Cortex доступна по адресу вида https://<домен_ELMA_Cortex>/api/pub/v1/docs.

Настройка AI‑операции завершена. Вы сможете найти её на странице AI‑операций.

Действия на странице AI-операций

Чтобы увидеть список созданных операций, в левом меню ELMA Cortex перейдите на страницу AI‑Операции. Здесь можно:

• найти AI‑операцию по названию — для этого начните вводить её имя в строке поиска в правом верхнем углу;
• открыть страницу AI‑операции — нажмите на карточку операции, чтобы изменить её настройки;
• отключить AI‑операцию — нажмите на переключатель напротив названия AI‑операции, чтобы она стала временно недоступна для использования. Если она уже применяется в ELMA365 или является инструментом для других компонентов ELMA Cortex, для корректной работы замените её на другую операцию;
• управлять AI‑операцией, нажав напротив неё значок трёх точек и выбрав опцию:
  • Редактировать — изменить название AI‑операции в ELMA Cortex и при её размещении в ELMA365;
  • Удалить — удалить AI‑операцию из ELMA Cortex. Восстановить компонент нельзя.

Была ли статья полезной?

Спасибо за ваш отзыв!

×

Ваш отзыв успешно отправлен!

Спасибо за обратную связь.

×

Уточните, почему:

Рекомендации не помоглиТекст трудно понятьНет ответа на мой вопросСодержание статьи не соответствует заголовкуДругая причина

×

Расскажите, что вам не понравилось в статье:

ДаНет

Выберите вариантРекомендации не помоглиТекст трудно понятьНет ответа на мой вопросСодержание статьи не соответствует заголовкуДругая причина