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

Агент — это единица, которую AiHummer ставит перед разговором. У каждого агента есть профиль (технический профиль агента; «характер» — только про тон общения), своя модель, структурированный промпт и набор навыков, и любое изменение агента версионируется. Агенты управляются из веб-интерфейса и через админ-API по пути /v1/admin/agents/*.

Важно разделять текстовые инструкции и реальные права: промпт описывает желаемое поведение, но технические полномочия задаются доступными инструментами, ролями и обязательными одобрениями.

На этой странице — из чего состоит агент, как собирается структурированный промпт «G3» и как агент может безопасно редактировать свой собственный профиль.

Реестр агентов

Реестр — это полноценный CRUD-каталог агентов. Для каждого агента вы задаёте идентичность, профиль, модель, на которой он работает, и навыки, которыми он может пользоваться. Поскольку шлюз мультиарендный, агенты живут внутри рабочего пространства (workspace) и изолированы, как и любые другие данные арендатора.

Профиль — голос и поведение агента, отрисовываемые в стабильный, дружелюбный к кэшу слой системного промпта.
Своя модель на агента — каждый агент может закрепить собственную модель и провайдера, так что дешёвый и флагманский агенты уживаются в одном рабочем пространстве.
Навыки — персональные и общие навыки отрисовывают блок «Навыки» в промпт; они описывают возможности, а не веса модели.

[!NOTE] Своя модель агента не зависит от маршрутизации. Маршрутизация по уровню модели (simple / standard / complex) выбирает класс модели для обработки запроса, а своя модель агента — это его собственное значение по умолчанию. См. Маршрутизацию.

Версии, откат и клонирование

Каждое значимое изменение агента фиксируется как версия. Это делает конфигурацию агента аудируемой и обратимой: можно посмотреть, что изменилось, откатиться к более ранней версии или клонировать агента, чтобы использовать его как заготовку для нового. Ресурсы версий и профиля находятся под /v1/admin/agents/* (профиль, секции, навыки, версии).

[!TIP] Клонируйте рабочего агента перед большой переработкой профиля или промпта. Если новое направление не оправдается, оригинал в одном откате от вас.

Структурированный промпт «G3»

Вместо одного свободного системного промпта AiHummer использует структурированный профиль агента (внутреннее имя — «G3»). Профиль разложен на поля, а не зашита в прозу, а остальная часть промпта строится из именованных секций плюс блока первоначальной настройки. Оркестратор отрисовывает это в слоистый системный промпт, удерживая стабильные части (идентичность, профиль, секции) в кэшируемом префиксе и добавляя изменчивые данные в конце.

Такая структура упрощает правку профиля поле за полем, упрощает дифф между версиями и делает отрисовку предсказуемой — никакого скрытого «промпт-супа».

Профиль G3
├── поля идентичности  (разложены: имя, роль, ...)
├── секции             (именованные, упорядоченные блоки промпта)
└── первоначальная настройка (подсказки для первого запуска)

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

Агенту можно разрешить редактировать собственный профиль с помощью инструментов самоправки — например, чтобы уточнить секцию или обновить блок первоначальной настройки. Это намеренно ограничено:

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

[!WARNING] Что произойдёт: агент сможет переписать собственную идентичность без контроля. При каком условии: если разрешить самоправку без обязательного одобрения. Как исправить: держите самоправку под обязательным одобрением и просматривайте предложенные изменения так же, как любое привилегированное изменение.

Пароли почты уходят в хранилище секретов

Если в конфигурации агента есть почтовые учётные данные (для инструмента mail), пароль записывается в зашифрованное хранилище секретов, а не хранится в профиле и не отрисовывается в промпт. Секреты не передаются в контекст модели.

Админ-API

Агенты и их структурированные профили управляются через админ-API, который закрыт OIDC и аудируется:

Ресурс	Назначение
`/v1/admin/agents`	Список, создание, изменение, удаление агентов (CRUD)
`/v1/admin/agents/.../profile`	Структурированный профиль G3 (поля идентичности)
`/v1/admin/agents/.../sections`	Именованные секции промпта
`/v1/admin/agents/.../skills`	Навыки конкретного агента
`/v1/admin/agents/.../versions`	История версий, откат и клонирование

Куда дальше

Как агент обрабатывает запрос и порождает помощников — в разделе Оркестрация и суб-агенты.
Как входящее сообщение доходит до конкретного агента — в разделе Маршрутизация.
Дайте агентам долговременную память — Память (Einstein).