Nodul LogoNodul

Основы проектирования агентов

Обзор

ИИ-агенты Nodul работают на основе встроенного LLM и управляются двумя ключевыми компонентами, которые вы контролируете:

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

На этой странице объясняется, как эффективно проектировать эти компоненты для создания надёжных, целенаправленных агентов.

brave_JMGq4SJCaa.png

Как это работает

Каждый раз, когда узел ИИ-агента получает сообщение, он:

  1. Читает инструкции.
  2. Анализирует входные данные.
  3. Решает, вызвать инструмент или сгенерировать прямой ответ.
  4. Выполняет логику в соответствии с вашей настройкой.

Качество этого процесса зависит от того, насколько чётко вы структурируете инструкции и инструменты агента.

brave_CoiQwPMI3S.png

Инструкции

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

WDADesktopService_6szsCoof3M.png

Рекомендации

  • Явно указывайте разрешённые и запрещённые действия.
  • Включайте запасную логику для отсутствующих данных.
  • Сосредотачивайте инструкции на одном сценарии.
  • Используйте простой, прямой язык.
  • Чётко описывайте назначение каждого инструмента — агент опирается на эти описания при выборе инструмента для вызова.
  • Избегайте размытых названий или описаний инструментов — вместо «получить инфо» пишите «получить текущую погоду» или «получить курс валют».

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

Инструменты

Инструменты — это внешние действия, которые может выполнять агент. В Nodul это подключённые узлы — такие как HTTP-запросы, Notion или Google Sheets.

brave_ZHO76IKiB7.png

Лучшие практики

  • Используйте описательные имена: create_invoice, send_email
  • Не подключайте слишком много инструментов к одному агенту
  • Проектируйте каждый инструмент для выполнения одной задачи
  • Тестируйте инструменты отдельно перед подключением

brave_uskvi2zwEO.png

{{fromAIAgent("email"; "Адрес электронной почты клиента")}}