Агенты — AiHummer Документация

Агенты — это ваши ИИ-сотрудники. На этом экране вы создаёте их, задаёте профиль, поведение, модель, навыки и то, что им разрешено делать. Экран привязан к рабочему пространству. Агенты показаны плитками: иконка, имя, модель (или «модель по умолчанию»), статус, превью системного промпта, кнопки «Профиль» и «Удалить».

Создайте первого ИИ-сотрудника за 3 шага

Если вы делаете это впервые, достаточно трёх шагов — тонкая настройка нужна не сразу:

Откройте экран «Агенты» и нажмите «+ Создать».
Задайте имя (например, «Ассистент поддержки») и системный промпт — короткое описание роли: кто этот сотрудник, чем помогает и как общается.
Нажмите «Сохранить». Модель можно оставить пустой — тогда используется модель по умолчанию из цепочки провайдеров.

Что вы увидите: новый агент появится плиткой в списке с превью системного промпта. Проверить его можно сразу, не подключая канал: на странице «Сессии» нажмите «+ Новая сессия» и напишите ему.

[!TIP] Пока не подключена реальная модель, ответы приходят из детерминированной тестовой модели (mock) — она подтверждает, что агент создан и маршрут работает, но не показывает качество будущих ответов. Подключить провайдера (OpenAI, Anthropic, YandexGPT, GigaChat, Codex и др.) — на странице Модели.

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

Кнопка «+ Создать» открывает модальное окно с базовыми полями:

Имя — обязательное, отображается в списках и каналах.
Аватар — загрузка или выбор фото (изображения).
Системный промпт — текст, задающий роль и правила поведения.
Модель — идентификатор модели; если оставить пустым, используется модель по умолчанию из цепочки провайдеров.

Этого достаточно, чтобы создать агента и проверить маршрут через тестовую модель; для рабочих ответов подключите модель-провайдера. Тонкую настройку делают в профиле.

Профиль агента

Кнопка «Профиль» открывает редактор с независимо сохраняемыми блоками.

Профиль

Короткое и полное имя, роль, форма обращения к пользователю, настроение, пол (не задан / м / ж / другое), характер (текст — тон общения), личные телефон и адрес электронной почты. Эти поля формируют профиль сотрудника и то, как он представляется в каналах.

Почтовый ящик

Появляется, когда задан личный адрес почты агента: параметры IMAP и SMTP (хост, порт, логин, пароль). Пароли записываются только на запись и не читаются обратно. Так агент может работать с собственной почтой.

Секции поведения

Набор сворачиваемых разделов, каждый с чекбоксом «включить» и текстом: Известное о собеседнике, Правила, Безопасность, Возможности, Политика памяти, Стиль отказа, Формат ответа, Эскалация и Ограничения профиля. Именно здесь, а не отдельными «галочками прав», описывается желаемое поведение агента в разделах Безопасность, Возможности и Правила. Эти инструкции влияют на поведение модели, но технические права ограничиваются доступными инструментами, RBAC и одобрениями.

Общие блоки

Можно привязать к агенту общие блоки из каталога рабочего пространства (единые правила компании) — см. Навыки и промпты. У блока показана метка чувствительности.

Навыки

Собственные навыки агента (создание/редактирование/удаление: имя, описание, тело, включённость, порядок; системный идентификатор slug генерируется сервером) плюс привязка общих навыков рабочего пространства.

Как задать права и модель

Права/полномочия: инструкции в разделах Безопасность, Возможности и Правила влияют на поведение модели, а технические полномочия задаются набором доступных инструментов, RBAC и одобрениями. Рискованные действия проходят через Одобрения и Правила модерации.
Модель можно указать при создании (свободный ввод) или оставить пустой для модели по умолчанию; какие модели вообще разрешены — на экране Инструкции → доступные модели.

Если не получилось

Агент отвечает одинаково/шаблонно — вероятно, ещё работает тестовая модель (mock). Подключите реального провайдера на странице Модели.
Не вижу агента в канале — создать агента мало; его нужно привязать к каналу в блоке «Привязки» на экране Каналы.
Указал модель, но агент выдаёт ошибку — возможно, эта модель не входит в список разрешённых или у провайдера не прошла проверка подключения; проверьте Модели и доступные модели.
Хочу ограничить, что агенту можно — опишите поведение в разделах Безопасность, Возможности и Правила профиля агента, а технические ограничения задайте набором инструментов, ролями и Одобрениями.

Советы

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

Что дальше

Оркестрация — связать несколько агентов в граф.
Навыки и промпты — переиспользуемые блоки.
Модели — провайдеры и приоритет.