Для расширения возможностей AI‑агентов и AI‑операций к ним нужно подключить инструменты, которые позволяют получать информацию из внешних источников, обрабатывать данные и совершать действия.
Важно: действия в статье описаны на основе функциональных возможностей редакции ELMA Cortex Enterprise. Если вы используете другие редакции, некоторые инструменты могут быть недоступны. Подробнее читайте в статье «Доступные редакции ELMA Cortex».
Добавить инструмент для AI-агента или AI-операции
Чтобы добавить инструмент:
- В настройках AI‑агента или AI‑операции перейдите на вкладку Инструменты.
- Нажмите кнопку + Инструмент. Если для AI‑агента или AI‑операции уже созданы инструменты, кнопка называется + Добавить инструменты.
- Выберите тип инструмента из списка, затем нажмите Далее, чтобы настроить его:
- MCP сервер — для AI‑агента или AI‑операции можно настроить дополнительные функции с помощью MCP‑сервера, например для обращения к сторонней системе. Например, вы можете настроить свои инструменты для взаимодействия с ELMA365, создав модуль, выполняющий роль MCP‑сервера.
В открывшемся окне задайте настройки:
- выберите тип сервера — SSE или Streamable;
- укажите адрес сервера;
- выберите тип авторизации. При использовании модуля ELMA365 как сервера MCP нужно настроить подключение к компании;
- добавьте заголовки HTTP с данными аутентификации или служебной информацией;
- Дата/Время — AI‑операция сможет получить текущую дату и время, например, чтобы показать заявки за определённый период;
- Умный поиск — подключите настроенный проект умного поиска, чтобы AI‑операция могла искать информацию по его базе данных;
- Содержимое по URL — AI‑операция получит доступ к чтению веб‑страниц, например, если нужно получить содержание страницы по ссылке. В открывшемся окне укажите:
- максимальную длину возвращаемого содержимого — если значение превышено, AI‑операция принимает решение о необходимости загружать следующую часть страницы;
- время, в течение которого операция ожидает загрузку страницы — позволяет ускорить подготовку ответа, если страница оказывается недоступна;
- список доменов — сайты, к которым AI‑операция сможет обращаться. Если оставить поле пустым, доступны любые сайты;
- ELMA365: Базовый набор — агенту или операции доступен набор преднастроенных инструментов для работы с ELMA365. С их помощью он может анализировать информацию из открытой карточки элемента приложения и его ленты, а также текст из файлов, описывать изображения, видеть данные текущего пользователя, выполнять действия с задачами и получать листы согласования и ознакомления.
В открывшемся окне:
- выберите подключение к компании ELMA365 — чтобы связать набор инструментов с компанией и определить для него права доступа на получение данных и совершение действий в системе;
- введите уникальный префикс для набора инструментов — чтобы AI‑агент или AI‑операция отличали наборы инструментов для работы с ELMA365 друг от друга и корректно к ним обращались;
- активируйте нужные инструменты — на вкладках Приложения, Файлы, Пользователи, Задачи и Документооборот включите те инструменты, которые актуальны для задач AI‑агента или AI‑операции. Например, инструменты для получения данных элемента приложения, текущего пользователя и т. д.;
- на вкладке Приложения настройте получение информации из ленты элемента приложения — загружайте содержимое сообщений или только их количество;
- на вкладках Приложения и Файлы ограничьте объём загружаемых данных из ленты элемента и из файла — если указанное значение превышено, AI‑агент или AI‑операция принимает решение о необходимости загружать следующую часть данных;
- на вкладке Файлы выберите отдельную языковую модель для описания изображений и при необходимости напишите дополнительные инструкции для формирования описаний;
- ELMA365: Конфигурация — AI-агент или AI‑операция сможет применять пользовательский набор инструментов ELMA365, который позволяет выполнять настроенные действия в рамках определённых приложений и бизнес‑процессов. Например, создавать записи в выбранных приложениях, назначать пользователям задачи и т. д.
В открывшемся окне:
- выберите набор инструментов — подключение к компании ELMA365 определится автоматически;
- укажите для набора инструментов уникальный префикс так же, как для типа ELMA365: Базовый набор;
- Файлы и изображения — набор инструментов позволяет агенту или операции создавать файлы в форматах .docx, .md и .txt, извлекать текст из документов и описывать изображения. В открывшемся окне:
- активируйте инструменты — включите инструменты, актуальные для задач AI‑агента или AI‑операции. Например, инструменты для генерации файлов, описания изображений и т. д.;
- ограничьте объём текста, получаемый из файла — если значение превышено, AI-агент или AI‑операция принимает решение о необходимости загрузить следующую часть документа;
- выберите языковую модель для описания изображений и при необходимости напишите дополнительные инструкции для формирования описаний;
- Агент — укажите дочернего AI-агента или AI‑операцию, к которым текущий компонент сможет обращаться для решения специализированных задач. В таком компоненте настроены более узкие функции, что позволяет получить точные результаты. В окне настройки опишите, в каких случаях использовать дочерний компонент.
Обратите внимание, когда AI-агент или AI‑операция используются как инструменты, они не получают доступ к контексту всей переписки и предыдущих ответов основного AI‑агента или AI‑операции. Действия выполняются на основе переданных данных, затем возвращается результат. Чтобы делегировать задачи с доступом к полному контексту беседы, используйте управляемых агентов.
- Нажмите Сохранить.
AI-агент или AI‑операция будет определять и использовать подходящие инструменты, чтобы сформировать ответ или совершить действие.
Настроить подключение к компании ELMA365
При добавлении инструментов, которые позволяют взаимодействовать с ELMA365, нужно настроить подключение к компании. Оно обеспечивает:
- обмен данными;
- проверку прав — компонент ELMA Cortex сможет получать данные, к которым у пользователя есть права на просмотр, а также совершать доступные сотруднику действия.
К таким типам инструментов относятся ELMA365: Базовый набор и ELMA365: Конфигурация. Также подключение нужно для типа MCP сервер, если в качестве сервера используется модуль в ELMA365.
Чтобы настроить подключение:
- При добавлении инструмента под полем Подключение нажмите Настроить подключения.
- В правом нижнем углу нажмите + Добавить подключение.
- Заполните поля:
- Название — введите имя подключения;
- Адрес ELMA365 — вставьте адрес вашей компании ELMA365;
- Тип авторизации — выберите способ авторизации для инструмента:
- API ключ — вставьте в появившееся поле токен, созданный в ELMA365. Все действия в рамках инструмента будут выполняться с правами пользователя, указанного при настройке токена, например администратора;
- OAuth 2.0 — укажите клиент OAuth 2.0 для авторизации пользователей, например, созданный при первичной настройке модуля интеграции с ELMA Cortex. Действия будут выполняться с правами текущего пользователя. Для использования чата с AI‑агентом пользователь должен разрешить доступ к своим данным.
- Нажмите Проверить подключение, чтобы убедиться в правильности настроек.
- Нажмите Добавить.
Подключение можно будет выбрать при добавлении или редактировании инструментов для AI‑агентов и AI‑операций.