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

Агент — бул AiHummer’дин маекке коё турган бирдиги. Ар бир агенттин персонасы, өзүнүн модели, структуралык промпту жана көндүмдөр топтому бар, ал эми ага болгон ар бир өзгөрүү версияланат. Агенттер веб админ UI аркылуу жана /v1/admin/agents/* астындагы админ API аркылуу башкарылат.

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

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

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

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

[!NOTE] Ар бир агентке тиешелүү модель багыттоодон көз карандысыз. Модель-деңгээлдик багыттоо (simple / standard / complex) бир кезек үчүн модель классын тандайт, ал эми ар бир агентке тиешелүү модель — агенттин өзүнүн демейки модели. Карагыла: Багыттоо.

Версиялар, артка кайтаруу жана клондоо

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

Кийинки кадам

Агент кантип кезекти иштетип, жардамчыларды чакыраарын Оркестрация жана суб-агенттер бетинен түшүнгүлө.
Кирген билдирүү белгилүү бир агентке кантип жетээрин Багыттоо бетинен карагыла.
Агенттериңизге узак мөөнөттүү эс берүү үчүн Эс (Einstein) бетин карагыла.