SGR Агент
Описание

SGR Агент — это интеллектуальный узел системы, реализующий логику «схемно-управляемого рассуждения» (Schema-Guided Reasoning). Компонент позволяет гибко настраивать поведение LLM через YAML-конфигурации, обеспечивая строгую структуру анализа и классификации входящих запросов.
Агент работает как промежуточный слой между сырыми данными пользователя и логикой выполнения действий, используя ролевую модель и пошаговые инструкции для достижения высокой точности ответов.
Основные параметры
| Параметр | Описание |
|---|---|
| Наименование элемента | Техническое имя компонента для логирования. |
| Сообщение пользователя | Поле из State, содержащее запрос. Можно указать несколько через запятую для проверки по приоритету. |
| Роль | Определение персоны агента (System Prompt Persona). |
| Инструкции | Свод правил и алгоритмов поведения агента. |
| Добавить к system message | Поля State, вшиваемые в системное сообщение. |
| Добавить к user message | Поля pipeline state, добавляемые к каждому запросу итерации. |
| История чата | Переключатель передачи истории диалога в контекст LLM. |
| SGR Схема | Центральный узел настройки YAML, определяющий структуру наблюдения, рассуждения и терминальных действий. Именно здесь задается логика reasoning_field. |
| State | Входной порт для получения состояния от предыдущего компонента в цепочке. |
| Инструменты | Позволяет подключить внешние функции через Tool (Stateful) или использовать устаревшие определения SGR Tool Def (Legacy). |
| Макс. итераций | Лимит цикла SGR. Определяет, сколько раз агент может «подумать» или обратиться к инструментам перед выдачей финального ответа. |
| Температура | Регулирует вариативность ответов. Значение 0.0 делает агента детерминированным (строгим), 1.0 — творческим. |
| Сохранить результат как… | Определяет имя ключа в State, куда будет записан объект ответа. Если оставить поле пустым, результат не будет зафиксирован в памяти. |
| Ответ → State | Механизм «подъема» (hoisting) вложенных данных. Позволяет переместить конкретное поле из глубокой структуры JSON-ответа напрямую в корень (root) State. Формат: ‘path:field’. |
Выходные данные
Компонент SGR Агент формирует выходной порт, который содержит два основных типа данных для передачи следующим узлам сценария:
- Updated State: полный объект состояния (State), дополненный ответом агента. Включает в себя основную переменную ответа и все поля, которые были перенесены в корень через настройку Ответ → State.
- Message: специализированный объект сообщения, содержащий финальный текстовый ответ агента. Предназначен для быстрой передачи в компоненты отправки сообщений (Slack, Telegram и др.) без необходимости ручного извлечения текста из структуры данных.