Агентҳо ва шахсиятиҳо

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

Як **афсари махсус** ин воҳидест, ки AiHummer пеш аз оғози гуфтугӯ қарор медиҳад. Ҳар агент шахсият, модели хоси худ, промпти сохташуда ва маҷмӯаи малакаҳо дорад ва ҳар гуна тағирот ба он бо версия қайд мешавад. Агентҳо аз интерфейси идоракунии веб ва тавассути API-и идоракунӣ идора карда мешаванд. `/v1/admin/agents/*`. Ин саҳифа дар бораи он ки агент аз чӣ иборат аст, чӣ тавр фармони сохторёфтаи "G3" ҷамъбаст мешавад ва чӣ гуна агент метавонад ба таври бехатар профили худро таҳрир кунад. ## Рӯйхати агентҳо Реестр як каталоги пурраи CRUD барои агентҳо мебошад. Барои ҳар агент шумо шахсият, персонаж, моделеро, ки он кор мекунад ва малакаҳое, ки метавонад истифода барад, муайян мекунед. Зеро дарвозаи он чандмуътамон аст, агентҳо дар дохили фазои корӣ зиндагӣ мекунанд ва монанди дигар маълумоти иҷоранишуда ҷудо шудаанд. - **Шахсия** — садо ва рафтори агент, ки ба як устувор табдил ёфтааст, қабати дӯстона ба кэш дар фармони система. - **Модели ҳар агент** — ҳар агент метавонад модели худ ва провайдери худро таъин кунад, пас як Агенти арзон ва агенти асосӣ метавонанд дар ҳамон фазои корӣ ҳамзистӣ кунанд. - **Малакаҳо** — маҳорати ҳар агент ва маҳорати муштарак блоки «Маҳорат»-ро ба қатъ; онҳо қобилиятҳоро тасвир мекунанд, на вазнҳоро. > [!NOTE] > Модели ҳар як агент аз самтгирӣ мустақил аст. Самтгирии сатҳи модел (содда / > стандартӣ / мураккаб) барои як гардиш синфи моделро интихоб мекунад, дар ҳоле ки барои ҳар як агент > модел нишонаи пешфарзии худи агент мебошад. Нигоҳ кунед > [Маршрутизатсия](/tg/v1.0/concepts/routing). ## Нусхаҳо, бозгашт ва такрор Ҳар як тағйири муҳим ба агент ҳамчун **навсозӣ**Ин танзими агентро қобили санҷиш ва баргардонидан мегардонад: шумо метавонед тафовути тағйироти онро баррасӣ кунед, **баргардондан** ба нусхаи пешина, ё **клон** як агент барои истифодаи он ҳамчун нуқтаи ибтидоӣ барои нав. Захираҳои версия ва профил зери `/v1/admin/agents/*` (профил, қисмҳо, малакаҳо, версияҳо) > [!TIP] > Ҷасади агенти корӣ пеш аз тағир додани шахсияти бузург ё дастури нав такрор кунед. Агар нави > агар самт набарояд, нусхаи аслӣ ҳанӯз як бозгашт дур аст. ## Фармони сохташудаи "G3" Ба ҷои як пешниҳоди ягонаи матни озод, AiHummer **профили сохторёфтаи агентро** истифода мебарад (дар дохил «G3» ном дорад). **Ҳувият ба майдонҳо тақсим шудааст**, на ин ки дар наср пинҳон бошад; қисми боқимондаи дастур аз **бахшҳои** номдор ва як монеаи **омӯзиш ва мутобиқсозӣ** сохта мешавад. Созанда онҳоро ба системаи қабатии фармон мутобиқ мекунад, қисмҳои устуворро (ҳувият, шахсият, бахшҳо) дар префикси кешшаванда нигоҳ медорад ва маълумоти тағйирёбандаро дар охир илова мекунад. Ин сохтор профилро осон мекунад, ки поле бо поле таҳрир карда шавад, фарқи байни версияҳоро осон муайян мекунад ва пешбинишаванда бошад — ҳеҷ гуна омехтаи пинҳоншуда вуҷуд надорад. ```text G3 profile ├── identity fields (decomposed: name, role, ...) ├── sections (named, ordered prompt blocks) └── onboarding (first-run guidance) ``` ## Худи таҳриркунӣ дар паси дарвозаи тасдиқ Имкони иҷозат додан ба як агент вуҷуд дорад **пайронии шахсии худро таҳрир кунед** истифодаи воситаҳои худтамизкунӣ — масалан барои такмил додани як бахш ё навсозии роҳнамоӣ. Ин бо хушунат муҳофизат шудааст: - Таҳрирҳои худӣ тавассути **дарвозаи тасдиқ**: тағйири пешниҳодшуда сабт мешавад ва пеш аз он ки амалӣ шавад, бояд аз ҷониби инсон тасдиқ шавад. Тағйири радшуда ҳеҷ гоҳ мутаппиқ шуд. - Ин тағйир ҳамчун нави баён мешавад **навсозӣ**, аз ин рӯ худидоракунии таҳрир метавонад тавассути назорат санҷида шавад ва ба ҳамон андоза баргардонидашаванда мисли ҳар гуна таҳрири дастӣ. > [!WARNING] > Худмуҳарриркунӣ қудратманд аст. Онро паси дари тасдиқ нигоҳ доред, то агент натавонад. > беэътимодӣ шиносномаи худро дубора нависед. Таҳрирҳои пешниҳоднамудаи худро ба ҳамон тарзе баррасӣ кунед > Ҳар гуна тағйири бартарӣ баррасӣ кунед. ### Рамзҳои почта ба осорхона мераванд Агар конфигуратсияи агент аз маълумоти вуруд ба почта иборат бошад (баро `mail` асбоб), рамзгузорӣ ба **анбори эъломияҳои рамзшуда**, на дар профил нигоҳ дошта шудааст ва на ба порсолат табдил дода мешавад. Сирҳо ҳеҷгоҳ ба контексти модел ворид намешаванд. ## Сиёсати иҷро: контекст, сессияҳо ва агентҳои фарзанд Аз версияи 1.3 агент **сиёсати иҷро** дорад — майдони `runtime_policy` дар API-и идоракунӣ (`/v1/admin/agents` ҳангоми эҷод ва навсозӣ). Ин объекти JSON-и ба таври қатъӣ тафтишшаванда бо `"version": 1` аст: `{}`-и холӣ қиматҳои пешфарзро бармегардонад, партофтани майдон ҳангоми навсозӣ сиёсати пешинаро нигоҳ медорад, майдонҳои номаълум ва қиматҳои берун аз ҳудуди иҷозатшуда рад мешаванд. Сиёсат абзорҳо намедиҳад ва ҳуқуқҳоро васеъ намекунад — он танҳо буҷаҳо ва мӯҳлатҳоро муайян мекунад. Клони агент ва супоридани навбат ба ӯ онро мерос мегиранд. - **`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`) ва ивазкунии пурра бо матни `placeholder` ҳангоми зиёд шудан аз `hard_clear_ratio`. Матни корбар, тасвирҳо ва таърихи пурра дар пойгоҳи додаҳо даст нарасида мемонанд. - **`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` — зермаҷмӯаи `user_ids`, ки ба он иҷрои ба таври возеҳ баландшудаи `code_exec` иҷозат дода шудааст (тасдиқҳо гирд гашта намешаванд). Аломатҳои ҷойивазкунӣ ва иҷозатҳо барои тамоми иҷорагир нестанд. ## API-и маъмур Агентҳо ва профилҳои сохтмоншудаи онҳо тавассути API-администратор, ки бо OIDC маҳдуд ва санҷида мешавад, идора карда мешаванд: | Манбаъ | Мақсад | |---|---| | `/v1/admin/agents` | Рӯйхат, эҷод, навсозӣ, нест кардани агентҳо (CRUD) | | `/v1/admin/agents/.../profile` | Профили сохташудаи G3 (майдонҳои шиноснома) | | `/v1/admin/agents/.../sections` | Бобҳои таъиншудаи дастурхон | | `/v1/admin/agents/.../skills` | Малакаҳои ҳар як агент | | `/v1/admin/agents/.../versions` | Тарихи версия, барқароркунӣ ва нусха | ## Баъд ба куҷо - Фаҳмидан, ки агентҳо чӣ гуна гардондани давр ва ба вуҷуд овардани ёрдамчиёнро иҷро мекунанд [Оркестратсия ва зер-агентҳо](/tg/v1.0/concepts/orchestration-subagents). - Бубинед, ки паёми воридшаванда чӣ гуна ба агентии мушаххас мерасад [Маршрутизатсия](/tg/v1.0/concepts/routing). - Ба агенти худ хотираи дарозмуддат диҳед бо [Хотира (Эйнштейн)](/tg/v1.0/concepts/memory-einstein).