Агенттер мен тұлғалар — 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`	Нұсқалар тарихы, кері қайтару және клондау

Келесі қайда

Агенттер қалай кезекті жүргізетінін және көмекшілерді қалай шығаратындығын түсініңіз Оркестрлеу және қосалқы агенттер.
Көріңіз, қалай кіріп жатқан хабар белгілі бір агентке жетеді Маршрутизация.
Агенттеріңізге ұзақ мерзімді есте сақтау қабілетін беріңіз Естелік (Эйнштейн).