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

Бир агент бул 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 курал), сырсөз жазылган шифрленген күбөлүк сактагыч, профилге сакталбайт же сунушка киргизилбейт. Сырлар эч качан моделдин контекстине кирбейт.

Аткаруу саясаты: контекст, сессиялар жана туунду агенттер

1.3 версиясынан баштап агенттин аткаруу саясаты бар — башкаруу API-синдеги runtime_policy талаасы (түзүү жана жаңыртууда /v1/admin/agents). Бул "version": 1 менен катуу текшерилүүчү JSON объекти: бош {} демейки маанилерди кайтарат, жаңыртууда талааны калтырып кетүү мурунку саясатты сактайт, ал эми белгисиз талаалар жана уруксат берилген чектен тышкары маанилер четке кагылат. Саясат куралдарды бербейт жана укуктарды кеңейтпейт — ал бюджеттерди жана мөөнөттөрдү гана белгилейт. Агенттин клону жана ага кезекти өткөрүп берүү аны мурастайт.

context — тарых бюджети: max_tokens, reserve_tokens жана history_share суроо-талапка канча тарых түшөрүн аныктайт; max_history_messages билдирүүлөр терезесин, bootstrap_max_chars профиль блогунун өлчөмүн чектейт. Контекст так берилгенде эски билдирүүлөр учурдагы суроо-талап түзүлгөнгө чейин бөлүктөр менен кыскача мазмунга кысылат.
- pruning — эскирген курал натыйжаларын тазалоо: мөөнөтү боюнча (ttl_seconds), акыркы жоопторду коргоо менен (keep_last_assistants), жумшак кыркуу (soft_trim_ratio, head_chars, tail_chars) жана hard_clear_ratio ашканда placeholder тексти менен толук алмаштыруу. Колдонуучунун тексти, сүрөттөр жана базадагы толук тарых козголбойт.
- memory_flush — кысуудан мурун куралсыз агент максаттар, чечимдер жана бүтпөгөн иштер тууралуу кыска жазуу жазат (soft_threshold_tokens); ошол эле диалогдун акыркы үч жазуусу текшерилбеген маалымдама катары контекстке кошулат.
session — диалогдун жашоо цикли: idle_reset_minutes тыныгуудан кийин жаңы контекст баштайт (чийки тарых сакталат), index_prune_after_days жана index_max_entries эски диалогдорду өчүрбөстөн демейки тизмеден чыгарат. scope = per-peer (бардык каналдарда ырасталган колдонуучуга бир диалог) же per-channel-peer (ар бир каналга өзүнчө диалог).
children — туунду агенттер: max_depth (4кө чейин), max_concurrent (бир ишке киргизүү дарагына 8ге чейин), max_per_parent (5ке чейин), timeout_seconds (48 саатка чейин, бирок ата-энеден узак эмес) жана archive_after_minutes — аяктаган ишке киргизүүлөр демейки тизмеден качан чыгары. Маанилер бул агент үчүн глобалдык AIHUMMER_SUBAGENT_MAX_DEPTH жана AIHUMMER_SUBAGENT_TIMEOUT_SEC жөндөөлөрүн кайра аныктайт.
max_iterations (1–256) — көп тапшыруулуу текшерилген сценарийлер үчүн функция чакыруу циклинин кадам чеги.
app — AiHummer тиркемеси үчүн гана: reasoning_effort, service_tier жана кыска жооп режими direct_completion (auto же always; max_tokens 4096га чейин жана timeout_ms 60 000ге чейин).
interaction — сессиялар менен иштөөгө так уруксаттар: user_ids, session_agent_ids, spawn_agent_ids, session_visibility көрүнүшү (self, agent же granted), session_send, туунду чакыруулар үчүн курал тыюулары (child_tool_deny, child_leaf_tool_deny) жана elevated_telegram_user_ids — так жогорулатылган code_exec аткарууну суроого уруксат берилген user_ids ички топтому (жактыруулар айланып өтүлбөйт). Коюлма белгилер жана бүт ижарачыга уруксаттар жок.

Админ API

Агенттер жана алардын структураланган профилдери админ API аркылуу башкарылат, ал OIDC аркылуу кирүү менен корголуп, аудиттен өтөт:

Ресурс	Максат
`/v1/admin/agents`	Агенттерди тизмелөңүз, түзүңүз, жаңыртыңыз, жок кылыңыз (CRUD)
`/v1/admin/agents/.../profile`	Түзүмдөлгөн G3 профили (оныктоочу талаалар)
`/v1/admin/agents/.../sections`	Аталыштары бар сурамы бөлүктөрү
`/v1/admin/agents/.../skills`	Ар бир агенттин көндүмдөрү
`/v1/admin/agents/.../versions`	Версиянын тарыхы, кайтаруу жана көчүрмө

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

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