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

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

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

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

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

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

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

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

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

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

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

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

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

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

Самоправка за гейтом одобрения

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

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

[!WARNING] Самоправка — мощный механизм. Держите её за гейтом одобрения, чтобы агент не мог молча переписать собственную идентичность. Просматривайте предложенные самоправки так же, как любое привилегированное изменение.

Пароли почты уходят в vault

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

Админ-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).