ИИ-агенты

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

ИИ-агент может:

• планировать свои действия;
• разбивать задачу на этапы;
• получать и обрабатывать данные в системе;
• выполнять действия, например, выполнять поиск по базе данных, создавать вложения или вызывать внешние сервисы.

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

Чтобы добавить ИИ-агента в рабочий процесс, используйте действие рабочего процесса AI Agent.

Компоненты ИИ-агента

• Нексус – точка подключения, через которую работает агент.

• Адаптер – набор методов, которые агент может вызывать. В адаптере можно также указать список доступных для него серверов MCP. В этом случае их методы (инструменты) будут доступны всем ИИ-агентам, которые используют этот адаптер. Список инструментов MCP может изменяться вручную администратором или автоматически в зависимости от их доступности на сервере MCP и индивидуальных настроек в Ainergy.

• Стратегия – вариант поведения нейросети для решения поставленной задачи.

  • One-Shot – выполнение поставленной задачи за один шаг без итераций. При использовании этой стратегии ИИ-агент отвечает на начальную команду или вызывает необходимый метод, после чего его задача завершена.
  • Re.Act – предполагает самостоятельные промежуточные шаги агента, в том числе итерации, для достижения поставленной задачи в необходимом объеме. Например, после получения начальной команды агент строит рассуждение, может вызвать метод, тогда результат вызова будет отправлен в нейросеть для дальнейшей обработки. Когда информации достаточно, он отвечает и завершает сессию. Для использования этой стратегии необходимо задать максимальное количество итераций, чтобы предотвратить зацикливание.

• Инструкция – текст инструкции, который определяет поведение агента. Инструкция должна задавать последовательность шагов, которые агент выполняет для решения задачи.

Создание ИИ-агента

---

tip

Требуемая роль: ain_admin.

Рекомендуем предварительно убедиться, что:

• необходимый нексус доступен;
• создан адаптер и добавлены его методы.
• (опционально) созданы записи серверов MCP и их инструментов, которые необходимы для обращения новому ИИ-агенту.

Чтобы создать ИИ-агента, выполните следующие действия:

1. В навигаторе перейдите в Ainergy → AI Agents → AI Agent.
2. Нажмите Создать и заполните поля новой формы.
3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
4. Добавьте ИИ-агента в действие AI Agent рабочего процесса.

Поля формы AI Agent

Поле	Обязательно	Описание
Name	Да	Укажите имя агента. Используйте уникальное и понятное имя.
System name	Да	Укажите системное имя.
Adapter	Да	Укажите адаптер, методы которого будут доступны агенту.
Nexus	Да	Укажите нексус, к которому обращается ИИ-агент.
Strategy	Да	Выберите стратегию ии-агента для решения поставленной задачи. Доступные опции: One-Shot – решение задачи в один шаг: поиск ответа или вызов метода Re.Act – для выполнения задачи используется "размышление" нейросети и допускаются многократные итерации обработки входящих данных для получения оптимального ответа.
Max iterations	Да	Укажите максимальное разрешенное количество итераций. Поле доступно, если выбрана стратегия Re.Act.
Instructions	Да	Добавьте инструкцию для текущего ИИ-агента.

Связанные списки

• AI Agent Session – журнал действий агента.
• Adapter Methods – список доступных методов из таблицы AI Method (ain_ai_method)
• Adapter MCP Tools – список инструментов MCP из таблицы Инструменты MCP (ain_mcp_tool).

Пример ИИ-агента

Поле	Значение
Name	Отчет по инцидентам
System name	incident-report-agent
Adapter	Отчет по инцидентам
Nexus	QWEN Next
Strategy	Re.Act
Max iterations	5
Instructions	При получении команды "за работу" запросите у пользователя начальную и конечную даты для периода отчета. Затем извлеките данные об инцидентах за указанный период, сформируйте краткий отчет на русском языке и отправьте его по электронной почте.

Адаптер Отчет по инцидентам содержит следующие методы:

• send_email – отправка письма на электронную почту.
• get_incident_data – получение данных об инцидентах за период.

note

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

Читайте подробнее в статье Сервер MCP.

Сессия агента

---

Сессия агента – это история действий агента. Записи всех сессий агента хранятся в связанном списке AI Agent Session. Там же вы можете посмотреть их статус.

Сессия начинается с запуска агента и заканчивается в следующих случаях:

• для стратегии One-Shot – после ответа или вызова метода;

• для стратегии Re.Act: когда нейросеть получает достаточно информации или ее невозможно получить доступными средствами;

  • когда достигнуто максимальное количество итераций или возникает ошибка, сессия завершается со статусом Ошибка.