AiHummer
Кыргызча▾
КирүүЖеке кабинет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Негизги түшүнүктөр/Агенттер жана персоналар

Агенттер жана персоналар

v1.0.x · жаңыланды 2026-06-26

Бир агент бул AiHummer сүйлөшүүнүн алдында коюган бирдик. Ар бир агенттин өзүнүн персонасы, модели, структураланган сурамдары жана көндүмдөрү бар, жана ага жасалган ар бир өзгөртүү версияланат. Агенттер веб-админ UI аркылуу жана администрация API аркылуу башкарылат /v1/admin/agents/*.

Бул барак агенттин эмнеден турганын, түзүлүшү бар ‘G3’ тапшырмасы кантип түзүлгөнүн жана агент өзүнүн профилин коопсуз түрдө кантип түзөтө аларын камтыйт.

Агенттердин каттоосу

Реестр агенттердин толук CRUD каталогу болуп саналат. Ар бир агент үчүн сиз аныктооч, персона, иштейт деп турган модель жана колдоно турган жөндөмдөрүн аныктайсыз. Шлюз көппайдалануучу болгондуктан, агенттер жумушчу мейкиндикте жашайт жана башка арендаттардын маалыматтары сыяктуу бөлүнүп турат.

  • Персона — агенттин үнү жана мүнөзү, туруктуу абалга которулган, жүйө сурамындагы кэшке ыңгайлуу катмар.
  • Ар бир агент үчүн модель — ар бир агент өзүнүн моделин жана провайдерин белгилей алат, ошондуктан Арзан агент менен флагман агент бир эле жумушчу мейкиндикте кош жашай алышат.
  • Көркөмдүктөр — агентке өзүнчө жана жалпы көндүмдөр «Көндүмдөр» блокту түзөт сүрөттөп берүү; алар салмактарды эмес, мүмкүнчүлүктөрдү сүрөттөшөт.

[!NOTE] Ар бир агент үчүн модель багыттоодон көз карандысыз. Модель катмарлары боюнча багыттоо (жай / стандарт / комплекс) кезекти үчүн модель классын тандайт, ал эми ар бир агент үчүн модель агенттин өзүнүн демейки параметри болуп саналат. Караңыз Маршрутизация.

Версиялар, артка кайтаруу жана көчүрмө жасоо

Агенттеги ар бир маанилүү өзгөрүү катары кармалып алынат версия. Бул агенттин конфигурациясын текшерүүгө жана кайтарууга мүмкүн кылат: эмнелер өзгөргөнүн карап чыга аласыз, артка кайтаруу мурунку версиясына же клондоо оны жаңы нерсени баштоо үчүн баштапкы пункт катары колдонуу үчүн агент. Версия жана профиль ресурстары түндүктө жашайт /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 Версиянын тарыхы, кайтаруу жана көчүрмө

Келерки кайда