AiHummer
Аԥсшәа
Аиалаҵара
v1.0.x
{ }Swagger

Агентцәеи персонақәеи

v1.0.x · ирҿыцуп 2026-06-26

Агент ауп AiHummer аиҿцәажәара аԥхьа иаргылогьы. Агент зегьы иамоуп персона, ихатә модель, аструктуратә промпт насгьы аиҿкаара инструментқәа (skills), насгьы уи иаԥсахуа зегьы аверсиа иаԥҵоуп. Агентцәа рхылаԥшра иҟоуп веб-админ UI аҟынтәи насгьы админ API аҟны /v1/admin/agents/* ала.

Ари адаҟьа иануп агент изаԥҵоу, аструктуратә «G3» промпт шиаԥҵо, насгьы агент шахьыхатә профиль шшәарҭарас аԥсахуа.

Агент регистр

Регистр ауп агентцәа рыхатә CRUD каталог. Агент зегьы азы шәара иашьшәалоит аиԥшра, персона, ианазылыхуа амодель насгьы ишамоу инструментқәа. Гейтвеи мультитенант азы, агентцәа инхоит воркспеис аҩныҵҟа насгьы изолиовуп аҽатәи тенант адырҩәӡара еиԥш.

  • Персона — агент ибжьыи иуааи, систематә промпт аҟны иҵмыжа, кеш-зхәабоу ахар аҟны иаԥҵоу.
  • Агент зегьы рымодель — агент зегьы изыхатәу амодель ма провайдер ианазылыхыр алшоит, убри азы зхарҭәаау агенти зхараоу агенти воркспеис аҟны еицынхар алшоит.
  • Инструментқәа (Skills) — агент зегьы рыхатәи реицырку инструментқәеи «Skills» блок промпт аҟны иаԥырҵоит; урҭ алшарақәа рдыр­галоит, ауасхатәырқәа акәым.

[!NOTE] Агент зегьы рымодель ароутинг иаҵанакуам. Модель-тиер ароутинг (simple / standard / complex) аиҿцәажәара азы амодель класс алнахуеит, аха агент зегьы рымодель агент ихатә default ауп. Уаԥхьа Ароутинг.

Аверсиақәа, ароллбеки клонеи

Агент аԥсахра зегьы хадоу аверсиа ҳасабла иаанкылоуп. Ари агент аиҿкаара аудит злазуа насгьы иргьежьуа иаҟаҵоит: иаԥсаху иузыԥхьаӡар алшоит, аԥхьатәи аверсиахь уааиргьежьыр алшоит, ма агент уклониларц еиԥш иҿыцраны ауп. Аверсиеи апрофиль ресурсқәеи инхоит /v1/admin/agents/* аҵаҟа (профиль, секциақәа, инструментқәа, аверсиақәа).

[!TIP] Аусура иалоу агент клониил даҽа персона ма промпт ду аԥсахраҟынӡа. Аҿыцу ахырхарҭа мҩас имырҭылар, иблоу ароллбек закәызаалакь ауп иаанмыжьу.

Аструктуратә «G3» промпт

Акоуп ишкьыԥхьаау систематә промпт акәымкәа, AiHummer иахәоит аструктуратә агент профиль (аҩныҵҟатәла «G3»). Аиԥшра аҭакқәа рахь ишоит атекст аҩныҵҟа изыкьыԥхьаау акәымкәа, насгьы аиҩшоу апромпт даҽа хыԥхьаӡара змоу секциақәа насгьы аонбординг блок аҟынтәи иаԥҵоуп. Аорхестратор урҭ систематә промпт ахарқәа рахь ирныжьуеит, аӡбахаԥшоу ахәҭақәа (аиԥшра, персона, секциақәа) кеш-зхәабо префикс аҟны еиқәырханы насгьы аиҭакыртә дыррақәа уахьа аҵаҟа иацҵоит.

Аструктура апрофиль еиҳа уадаҩымкәа аҭак-аҭак иаԥсахуа, аверсиақәа реиҩшара ибзианы изыԥшааша, насгьы иршаԥхьаӡахо иаҟаҵоит — иҵамыжаны промпт чарәы ыҟаӡам.

G3 profile
├── identity fields   (decomposed: name, role, ...)
├── sections          (named, ordered prompt blocks)
└── onboarding        (first-run guidance)

Аха-зхаҭеиԥшра аппрув-гейт ашьҭахь

Агент ихатә профиль аԥсахра иашьҭалар алшоит аха-зхаҭеиԥшра инструментқәа ала — ҳәарас, асекциа аиҭашьақәыргылараз ма аонбординг аиҭарҿыцраз. Ари ишьшәалаз ихылаԥшу ауп:

  • Аха-зхаԥсахрақәа аппрув-гейт иахысуеит: ишьшәалоу аԥсахра ианҵоуп насгьы уи аус ауҟаларц аԥхьа ауаа дицазҩаразароуп. Иргамыжьу аԥсахра аус нагӡахаӡом.
  • Аԥсахра аҿыцу аверсиа ҳасабла иаанкылоуп, убри азы аха-зхаԥсахра, закәызаалакь напала аԥсахрагьы реиԥш, аудит злоуу насгьы иргьежьуа ауп.

[!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 Аверсиа ҭоурых, ароллбеки клонеи

Ахьынӡашәцо