Создание агента
В этом разделе описано, как создать нового текстового агента и настроить все его параметры.
Создание нового агента
- Перейдите в раздел Текстовые агенты > Агенты.
- Нажмите кнопку Новый агент в правом верхнем углу.
- Откроется страница создания агента с панелью настроек справа.
Чат для тестирования агента станет доступен после сохранения. На этапе создания левая панель отображает placeholder с соответствующим сообщением.
Обязательные поля
Для создания агента необходимо заполнить как минимум два поля:
Имя
Название агента. Отображается в списке агентов, в чате и при выборе коллег для мульти-агентной архитектуры. Можно изменить, кликнув на имя в заголовке страницы.
Инструкции
Системный промпт агента — главный текст, определяющий его поведение. Пишется в текстовом поле раздела «Инструкции». Для удобства редактирования больших промптов используйте кнопку раскрытия (иконка в правом верхнем углу секции), которая откроет модальное окно на полный экран.
Подробнее об инструкциях — в разделе Системные промпты.
Все поля конфигурации
Описание
Текстовое поле под инструкциями. Описывает, что делает агент. Это поле особенно важно для агентов с ролью «Специалист» — оркестратор использует описание, чтобы определить, кому передать запрос.
Роль
Выпадающий список с тремя вариантами:
| Роль | Описание |
|---|---|
| Самостоятельный | Работает автономно (по умолчанию) |
| Оркестратор | Координирует команду агентов |
| Специалист | Выполняет специализированные задачи в составе команды |
При выборе роли «Оркестратор» или «Специалист» появляется дополнительное поле Коллеги для выбора агентов-партнёров.
Подробнее — в разделе Мульти-агентная архитектура.
Модель
Выбор LLM-модели из выпадающего списка. Модели сгруппированы по провайдерам (OpenAI, Anthropic, Groq, Yandex, GigaChat). Значение по умолчанию — openai/gpt-4o-mini.
Рядом с селектором модели находятся настройки:
- Температура — от 0 до 2 (по умолчанию 0.7).
- Макс. токенов — от 256 до 32 000 (по умолчанию 2048).
Для работы агента необходимо наличие активных API-ключей. Если ключи не настроены, вместо селектора модели отображается предупреждение с кнопкой перехода к настройке ключей.
Подробнее — в разделе Выбор LLM-модели.
Настройки диалога
Раскрывающаяся секция Диалог содержит:
| Параметр | Описание | По умолчанию |
|---|---|---|
| Режим диалога | Завершать агента после каждого ответа. Если включён, агент отвечает на одно сообщение и останавливается | Выключен |
| История чата | Передавать историю предыдущих сообщений в LLM | Включена |
| Ограничить историю | Максимальное число последних сообщений. Пусто = передавать всё | Не ограничено |
Настройки базы знаний (RAG)
Раскрывающаяся секция База знаний (RAG):
| Параметр | Описание | По умолчанию |
|---|---|---|
| Поиск по документам | Включить поиск по загруженным документам организации через RAG | Выключен |
| OpenAI Vector Store | ID хранилищ OpenAI (формат vs_...). Можно указать несколько через запятую | Пусто |
Настройки памяти
Раскрывающаяся секция Долгосрочная память:
| Параметр | Описание | По умолчанию |
|---|---|---|
| Включить память | Агент сможет запоминать информацию между диалогами | Выключена |
| Диалог (thread) | Память в рамках текущего разговора | Включена |
| Пользователь (user) | Личная память пользователя, доступная во всех разговорах | Выключена |
| Проект (project) | Память, доступная команде проекта | Выключена |
| Организация (organization) | Память, доступная всей организации | Выключена |
Подробнее — в разделе Память агента.
Веб-браузер
Раскрывающаяся секция Веб-браузер:
При включении агент получает возможность открывать веб-сайты, кликать по элементам, заполнять формы и извлекать данные с веб-страниц.
Инструменты
Агенту можно подключить несколько типов инструментов:
- Функции — пользовательские функции, созданные в разделе «Функции» проекта.
- Процессы — workflows, которые агент может запускать как инструменты.
- MCP-серверы — подключённые MCP-серверы с возможностью выбора конкретных инструментов.
- Коллеги — другие агенты (для ролей Оркестратор/Специалист).
Подробнее — в разделе Инструменты и функции.
Формат ответа
Выпадающий список с двумя вариантами:
| Формат | Описание |
|---|---|
| Text | Обычный текстовый ответ (по умолчанию) |
| JSON | Структурированный ответ по JSON Schema |
При выборе формата JSON появляется кнопка Настроить JSON Schema, открывающая боковую панель с редактором схемы.
Сохранение
- Нажмите кнопку Создать для сохранения нового агента.
- После создания вы будете перенаправлены на страницу редактирования, где станет доступен чат для тестирования.
Редактирование
При редактировании существующего агента:
- Изменения сохраняются автоматически через несколько секунд после внесения (auto-save).
- Время последнего автосохранения отображается в заголовке рядом с зелёной галочкой.
- Можно также сохранить вручную, нажав кнопку Сохранить.
- Кнопка Системный промпт в заголовке ведёт на страницу управления шаблонами промптов.
Дублирование агента
Для быстрого создания агента на основе существующего:
- Откройте список агентов.
- Правой кнопкой мыши нажмите на агента.
- Выберите Дублировать в контекстном меню.
Будет создана копия агента со всеми настройками.
Тестирование в чате
После создания агента в левой панели появляется встроенный чат:
- Отправляйте сообщения для проверки ответов агента.
- Наблюдайте за вызовами инструментов в реальном времени.
- Используйте панель Переменные (раскрывается над полем ввода) для передачи тестовых переменных.
- Кнопка очистки сбрасывает историю чата.
Переменные в чате сохраняются в localStorage браузера, так что при возвращении к агенту вам не придётся вводить их заново.