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

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

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

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

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

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

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

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

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

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

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

Библиотека готовых агентов

Рядом с «+ Создать» есть кнопка «Библиотека агентов»: она открывает каталог заготовок для 70 отраслей в девяти группах — здоровье и забота, учёба, услуги и красота, торговля, недвижимость и дом, внутри компании, профессии и производство, для себя, крупный бизнес. Перечень отраслей тот же, что на сайте AiHummer, а не второй список. Тексты заготовок есть на русском и английском: при другом языке интерфейса подставляется английский вариант.

Выберите отрасль (есть поиск по названию) и задачу: «Ответы и консультации», «Сбор и подготовка запроса» или «Анализ и сводки». Название агента подставится само, его можно изменить.
Отметьте состав — что именно добавить. Каждый компонент раскрывается и показывает точный текст до добавления:
- Профиль агента — короткое и полное имя, роль, характер, настроение и форма обращения в отдельных полях;
- Инструкции и границы задачи — секции «Правила», «Безопасность», «Политика памяти», «Формат ответов» и «Эскалация»;
- Поиск знаний и памяти — профиль инструментов только на чтение (search_knowledge, memory_search, memory_get); без него у агента остаются обычные права нового агента;
- навык под задачу — «Ответ с проверкой источников», «Подготовка запроса» или «Сводка и проверка»;
- Шаблон передачи человеку — редактируемый промпт в общей библиотеке промптов; по умолчанию не отмечен.
Если компонент зависит от другого, панель попросит отметить и его.
Нажмите «Добавить агента». Заготовка не содержит фактов о вашей компании: документы и знания вы подключаете после добавления, а все поля правятся в обычных разделах профиля агента.

Повторная отправка той же формы после ошибки не создаёт частичного дубля: агент, навыки и промпт добавляются одной операцией. Лимит агентов тарифа проверяется так же, как при ручном создании.

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

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

Профиль

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

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

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

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

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

Общие блоки

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

Навыки

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

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

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

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

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

Советы

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

Что дальше

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