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

> [HTML Version](cortex-connect-tools.html)

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

**Важно**: действия в статье описаны на основе функциональных возможностей редакции **ELMA Cortex Enterprise**. Если вы используете другие редакции, некоторые инструменты могут быть недоступны. Подробнее читайте в статье [«Доступные редакции ELMA Cortex»](cortex-editions.md).

## Добавить инструмент для AI-агента или AI-операции

Чтобы добавить инструмент:

1. В [настройках AI‑агента](cortex-configure-agent.md) или [AI‑операции](configure-ai-action.md) перейдите на вкладку **Инструменты**.

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

3. Выберите тип инструмента из списка, затем нажмите **Далее**, чтобы настроить его:

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

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

	- выберите тип сервера — **SSE** или **Streamable**;

	- укажите адрес сервера;

	- выберите тип авторизации. При использовании модуля ELMA365 как сервера MCP нужно настроить [подключение к компании](#add-system-connections);

	- добавьте заголовки HTTP с данными аутентификации или служебной информацией;

- **Дата/Время **— AI‑операция сможет получить текущую дату и время, например, чтобы показать заявки за определённый период;

- **Умный поиск **— подключите настроенный проект умного поиска, чтобы AI‑операция могла искать информацию по его базе данных;

- **Содержимое по URL **— AI‑операция получит доступ к чтению веб‑страниц, например, если нужно получить содержание страницы по ссылке. В открывшемся окне укажите:

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

	- время, в течение которого операция ожидает загрузку страницы — позволяет ускорить подготовку ответа, если страница оказывается недоступна;

	- список доменов — сайты, к которым AI‑операция сможет обращаться. Если оставить поле пустым, доступны любые сайты;

- **ELMA365: Базовый набор** — агенту или операции доступен набор преднастроенных инструментов для работы с ELMA365. С их помощью он может анализировать информацию из открытой карточки элемента приложения и его ленты, а также текст из файлов, описывать изображения, видеть данные текущего пользователя, выполнять действия с задачами и получать листы согласования и ознакомления.

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

	- выберите [подключение к компании ELMA365](#add-system-connections) — чтобы связать набор инструментов с компанией и определить для него права доступа на получение данных и совершение действий в системе;

	- введите уникальный префикс для набора инструментов — чтобы AI‑агент или AI‑операция отличали наборы инструментов для работы с ELMA365 друг от друга и корректно к ним обращались;

	- активируйте нужные инструменты — на вкладках **Приложения**, **Файлы**, **Пользователи**, **Задачи** и **Документооборот** включите те инструменты, которые актуальны для задач AI‑агента или AI‑операции. Например, инструменты для получения данных элемента приложения, текущего пользователя и т. д.;

	- на вкладке **Приложения** настройте получение информации из ленты элемента приложения — загружайте содержимое сообщений или только их количество;

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

	- на вкладке **Файлы** выберите отдельную языковую модель для описания изображений и при необходимости напишите дополнительные инструкции для формирования описаний;

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

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

	- выберите набор инструментов — [подключение к компании ELMA365](#add-system-connections) определится автоматически;

	- укажите для набора инструментов уникальный префикс так же, как для типа **ELMA365: Базовый набор**;

- **Файлы и изображения** — набор инструментов позволяет агенту или операции создавать файлы в форматах **.docx**, **.md** и **.txt**, извлекать текст из документов и описывать изображения. В открывшемся окне:

	- активируйте инструменты — включите инструменты, актуальные для задач AI‑агента или AI‑операции. Например, инструменты для генерации файлов, описания изображений и т. д.; 

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

	- выберите языковую модель для описания изображений и при необходимости напишите дополнительные инструкции для формирования описаний;

- **Агент **— укажите дочернего AI-агента или AI‑операцию, к которым текущий компонент сможет обращаться для решения специализированных задач. В таком компоненте настроены более узкие функции, что позволяет получить точные результаты. В окне настройки опишите, в каких случаях использовать дочерний компонент.

Обратите внимание, когда AI-агент или AI‑операция используются как инструменты, они не получают доступ к контексту всей переписки и предыдущих ответов основного AI‑агента или AI‑операции. Действия выполняются на основе переданных данных, затем возвращается результат. Чтобы делегировать задачи с доступом к полному контексту беседы, используйте [управляемых агентов](cortex-configure-agent.md#child-agents).

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

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

### Настроить подключение к компании ELMA365

При добавлении инструментов, которые позволяют взаимодействовать с ELMA365, нужно настроить подключение к компании. Оно обеспечивает:

- обмен данными;

- проверку прав — компонент **ELMA Cortex** сможет получать данные, к которым у пользователя есть права на просмотр, а также совершать доступные сотруднику действия.

К таким типам инструментов относятся **ELMA365: Базовый набор** и **ELMA365: Конфигурация**. Также подключение нужно для типа **MCP сервер**, если в качестве сервера используется модуль в ELMA365.

Чтобы настроить подключение:

1. При добавлении инструмента под полем **Подключение** нажмите **Настроить подключения**.

2. В правом нижнем углу нажмите **+ Добавить подключение**.

3. Заполните поля:

- **Название **— введите имя подключения;

- **Адрес ELMA365 **— вставьте адрес вашей компании ELMA365;

- **Тип авторизации** — выберите способ авторизации для инструмента:

	- **API ключ** — вставьте в появившееся поле [токен](360016488452.md), созданный в ELMA365. Все действия в рамках инструмента будут выполняться с правами пользователя, указанного при настройке токена, например администратора;

	- **OAuth 2.0** — укажите клиент OAuth 2.0 для авторизации пользователей, например, созданный при [первичной настройке модуля интеграции с ELMA Cortex](cortex-integration-solution.md#configure-oauth). Действия будут выполняться с правами текущего пользователя. Для использования чата с AI‑агентом пользователь должен разрешить доступ к своим данным.

4. Нажмите **Проверить подключение**, чтобы убедиться в правильности настроек.

5. Нажмите **Добавить**.

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