Bir agent bu AiHummer söhbetiň öňüsyrasynda goýýan birlikdir. Her agentiň bir personasy, öz modeli, gurluşly soragy we ukyby bar, hem-de onuň ähli üýtgeşmeleri wersiýaly bolýar. Agentler web admin UI arkaly we admin API arkaly dolandyrylýar. /v1/admin/agents/*.
Bu sahypa agentiň nämeden düzülýändigini, gurluşlandyrylan “G3” teklibiň nähili gurnalandygyny we agentiň öz profilini töwekgelçilige düşmezden nähili üýtgedip biljekdigini aňladýar.
Agent registri
Registr bir agentleriň doly CRUD katalogydyr. Her bir agent üçin siz şahsyýeti, personajy, işletýän modeli we ulanýan başarnyklaryny kesgitlýärsiňiz. Giriş gapagy köptaraplaýyn bolany üçin agentler iş giňişliginiň içinde ýaşaýarlar we beýleki jaý eýesi maglumatlary ýaly izolýasiýa edilýär.
Şahsyýet — agentiň sesi we hereketi, durnukly ýerine çykarylan,
sistemanyň isleginiň keş üçin amatly gatlagy.
Agent başyna model — her agent öz modelini we üpjün edijisini bellemeli bolup biler, şonuň üçin
Arzan agent bilen esasy agent bir zähmet meýdançasynda bile ýaşap biler.
Başarnyklar — her agentiň öňünden we umumy başarnyklary “Başarnyklar” blokyny şeýlebir edýär
täswir; olar agramlary däl, mümkinçiligi öwreýärler.
[!NOTE]
Agent-hasaplyk model ugrukdyrma garaşsyzdyr. Model-tier ugrukdyrmasy (ýönekeý /
standart / çylşyrymly) bir öwrüliň modeli synpyny saýlaýar, agentiň her biri wagtynda
model agentiň öziniň standarty. Garaşyň
Ugratma.
Wersiýalar, yzyna gaýtaryş we köçürme
Agentde edilen her bir manyly üýtgeşme aşa ýagdaýda alynýar wersiýa. Bu agentiň konfigurasiýasynyň barlanmagyna we yzyna gaýtarmaga mümkinçilik berýär: näme üýtgändigini gözden geçirip bilersiňiz, yzyna almak äwwelki wersiýasyna, ýa-da klon täze birini başlamak üçin başlangyç nokady hökmünde ony ulanmak üçin agent. Wersiýa we profil serişdeleri aşakda ýerleşýär /v1/admin/agents/* (profil, bölümler, başarnyklar, wersiýalar).
[!TIP]
Uly şahsyýet ýa-da sorag täzeden ýazylmazdan öň işläp duran agentiň klonyny dörediň. Täze
ugur işlemeýän bolsa, asyly heniz-de bir yzyna dolanmak aralygyndadyr.
Gurlan ‘G3’ teklibi
Bir sany beýlek öňünden ýazylan tekst ýagdaýyndaky ulgam ýerine, AiHummer peýdalanýar gurlan agent profil (içginlikde “G3”). Şahsyýet sahalara bölünýär prozada gömülmekden has, we promptyň galan bölegi atlandyrylanlardan gurluşyldy bölümler we-de bir iş başladyş blok. Orkestrator bularny gatlakly ulgam çagyryşyna öwürýär, durnukly bölekleri (identifikasiýa, persona, bölümçeler) kesgitlenip bilinýän prefikse saklaýar we üýtgeýän maglumatlary ahyryna goşýar.
Bu gurluş profilini meýdan-meýdan redaktirlemäge, wersiýalar arasynda tapawutlamagy aňsatlaşdyrýar we çyzgy görnüşde aňsatlyk bilen görkezmegiň yzygiderliligini üpjün edýär — gizlin haýal sorag ýok.
Tassyklama gapysynyň yzýany öz öňünden redaktirlemek
Bir agente rugsat berilip bilner öz profilini düzeltmek özüni redaktirleýän gurallary ulanmak — meselem, bir bölegi kämilleşdirmek ýa-da onuň işe başlatma bölümçesini täzelemek üçin. Bu bilen aňsatlyk bilen goralýar:
Özüni redaktirlemekler arkaly barýar tassyklama gapy: teklip edilen üýtgeşiklik ýazga alyndy we
netijeli bolmazdan öň adam tarapyndan tassyk edilmeli. Ret edilen üýtgeşme hiç haçan
ulanyldy.
Üýtgeşiklik täze bir zat hökmünde beýnelýär wersiýa, şonuň üçin öz-özüni düzmek hem barlanýar
hemme el bilen üýtgeme ýaly gaýtarylýan.
[!WARNING]
Öz öňünden redaktirlemek güýçli. Muny tassyklama gapysynyň yzynda sakla, şonda agent ony bilmez
özüniň identitetini sessiz-ýuwaşlyk bilen täzeden ýazýar. Tejribeli üýtgetmeleri şol bir usulda gözden geçiriň
islenýän islendik aýratyn üýtgeşmeleri gözden geçiriň.
Poçta açarlary gapyga barýar
Eger agentiň konfigurasiýasyna mail giriş maglumatlary girizilen bolsa (üçin mail gural), açar sözi ýazylýar şifrlendirilen şahsyýet gutusy, profilde saklanmaýar ýa-da sorala görkezilmeýär. Gizlinler hemişe modeliň kontekstine girmeýär.
Ýerine ýetiriş syýasaty: kontekst, sessiýalar we çaga agentler
1.3 wersiýasyndan agentiň ýerine ýetiriş syýasaty bar — dolandyryş
API-sindäki runtime_policy meýdany (döretmekde we täzelemekde
/v1/admin/agents). Bu "version": 1 bilen berk barlanýan JSON obýekti: boş
{} adaty bahalary gaýtarýar, täzelemekde meýdany goýbermek öňki syýasaty
saklaýar, näbelli meýdanlar we rugsat berlen çäklerden daşary bahalar bolsa
ret edilýär. Syýasat gural bermeýär we hukuklary giňeltmeýär — ol diňe
býujetleri we möhletleri kesgitleýär. Agentiň klony we oňa nobaty geçirmek
ony miras alýar.
context — taryh býujeti: max_tokens, reserve_tokens we
history_share soraga näçe taryhyň düşjekdigini kesgitleýär;
max_history_messages habar penjiresini, bootstrap_max_chars profil
blokynyň ölçegini çäklendirýär. Kontekst aýdyň kesgitlenende köne habarlar
häzirki sorag ýygnalmazdan öň bölek-bölek gysgaça mazmuna gysylýar.
pruning — könelen gural netijelerini arassalamak: möhlet boýunça
(ttl_seconds), soňky jogaplary gorap (keep_last_assistants), ýumşak
kesmek (soft_trim_ratio, head_chars, tail_chars) we
hard_clear_ratio geçilende placeholder teksti bilen doly çalyşmak.
Ulanyjynyň tekstine, suratlara we bazadaky doly taryha degilmeýär.
memory_flush — gysmakdan öň guralsyz agent maksatlar, kararlar we
tamamlanmadyk işler hakynda gysga bellik ýazýar (soft_threshold_tokens);
şol dialogyň soňky üç belligi barlanmadyk maglumat hökmünde kontekste
goşulýar.
session — dialogyň ömri: idle_reset_minutes arakesmeden soň täze
kontekst başlaýar (çig taryh saklanýar), index_prune_after_days we
index_max_entries köne dialoglary pozman adaty sanawdan aýyrýar. scope
= per-peer (ähli kanallarda tassyklanan ulanyjy üçin bir dialog) ýa-da
per-channel-peer (her kanal üçin aýratyn dialog).
children — çaga agentler: max_depth (4-e çenli), max_concurrent
(bir işe girizme agajyna 8-e çenli), max_per_parent (5-e çenli),
timeout_seconds (48 sagada çenli, ýöne ene-atadan uzyn däl) we
archive_after_minutes — tamamlanan işe girizmeleriň adaty sanawdan haçan
çykjakdygy. Bahalar bu agent üçin global AIHUMMER_SUBAGENT_MAX_DEPTH we
AIHUMMER_SUBAGENT_TIMEOUT_SEC-i täzeden kesgitleýär.
max_iterations (1–256) — köp tabşyrmaly barlanan ssenariýler üçin
funksiýa çagyryş sikliniň ädim çägi.
app — diňe AiHummer programmasy üçin: reasoning_effort,
service_tier we gysga jogap režimi direct_completion (auto ýa-da
always; max_tokens 4096-a çenli we timeout_ms 60 000-e çenli).
interaction — sessiýalar bilen işlemek üçin aýdyň rugsatlar:
user_ids, session_agent_ids, spawn_agent_ids, session_visibility
görünişi (self, agent ýa-da granted), session_send, çaga
çagyryşlar üçin gural gadaganlyklary (child_tool_deny,
child_leaf_tool_deny) we elevated_telegram_user_ids — aýdyň
ýokarlandyrylan code_exec işe girizmesini sorap bilýän user_ids kiçi
toplumy (tassyklamalar aýlanyp geçilmeýär). Joker nyşanlar we bütin kärendeçi
üçin rugsatlar ýok.
Administrator API
Agentler we olaryň gurluşly profilleri admin API-niň aşagynda dolandyrylýar, bu API OIDC bilen gaplanypdyr we barlagdan geçirilýär:
Bir **agent** bu AiHummer söhbetiň öňüsyrasynda goýýan birlikdir. Her agentiň bir personasy, öz modeli, gurluşly soragy we ukyby bar, hem-de onuň ähli üýtgeşmeleri wersiýaly bolýar. Agentler web admin UI arkaly we admin API arkaly dolandyrylýar. `/v1/admin/agents/*`.
Bu sahypa agentiň nämeden düzülýändigini, gurluşlandyrylan "G3" teklibiň nähili gurnalandygyny we agentiň öz profilini töwekgelçilige düşmezden nähili üýtgedip biljekdigini aňladýar.
## Agent registri
Registr bir agentleriň doly CRUD katalogydyr. Her bir agent üçin siz şahsyýeti, personajy, işletýän modeli we ulanýan başarnyklaryny kesgitlýärsiňiz. Giriş gapagy köptaraplaýyn bolany üçin agentler iş giňişliginiň içinde ýaşaýarlar we beýleki jaý eýesi maglumatlary ýaly izolýasiýa edilýär.
- **Şahsyýet** — agentiň sesi we hereketi, durnukly ýerine çykarylan,
sistemanyň isleginiň keş üçin amatly gatlagy.
- **Agent başyna model** — her agent öz modelini we üpjün edijisini bellemeli bolup biler, şonuň üçin
Arzan agent bilen esasy agent bir zähmet meýdançasynda bile ýaşap biler.
- **Başarnyklar** — her agentiň öňünden we umumy başarnyklary “Başarnyklar” blokyny şeýlebir edýär
täswir; olar agramlary däl, mümkinçiligi öwreýärler.
> [!NOTE]
> Agent-hasaplyk model ugrukdyrma garaşsyzdyr. Model-tier ugrukdyrmasy (ýönekeý /
> standart / çylşyrymly) bir öwrüliň modeli synpyny saýlaýar, agentiň her biri wagtynda
> model agentiň öziniň standarty. Garaşyň
> [Ugratma](/tk/v1.0/concepts/routing).
## Wersiýalar, yzyna gaýtaryş we köçürme
Agentde edilen her bir manyly üýtgeşme aşa ýagdaýda alynýar **wersiýa**. Bu agentiň konfigurasiýasynyň barlanmagyna we yzyna gaýtarmaga mümkinçilik berýär: näme üýtgändigini gözden geçirip bilersiňiz, **yzyna almak** äwwelki wersiýasyna, ýa-da **klon** täze birini başlamak üçin başlangyç nokady hökmünde ony ulanmak üçin agent. Wersiýa we profil serişdeleri aşakda ýerleşýär `/v1/admin/agents/*` (profil, bölümler, başarnyklar, wersiýalar).
> [!TIP]
> Uly şahsyýet ýa-da sorag täzeden ýazylmazdan öň işläp duran agentiň klonyny dörediň. Täze
> ugur işlemeýän bolsa, asyly heniz-de bir yzyna dolanmak aralygyndadyr.
## Gurlan 'G3' teklibi
Bir sany beýlek öňünden ýazylan tekst ýagdaýyndaky ulgam ýerine, AiHummer peýdalanýar **gurlan agent profil** (içginlikde "G3"). Şahsyýet **sahalara bölünýär** prozada gömülmekden has, we promptyň galan bölegi atlandyrylanlardan gurluşyldy **bölümler** we-de bir **iş başladyş** blok. Orkestrator bularny gatlakly ulgam çagyryşyna öwürýär, durnukly bölekleri (identifikasiýa, persona, bölümçeler) kesgitlenip bilinýän prefikse saklaýar we üýtgeýän maglumatlary ahyryna goşýar.
Bu gurluş profilini meýdan-meýdan redaktirlemäge, wersiýalar arasynda tapawutlamagy aňsatlaşdyrýar we çyzgy görnüşde aňsatlyk bilen görkezmegiň yzygiderliligini üpjün edýär — gizlin haýal sorag ýok.
```text
G3 profile
├── identity fields (decomposed: name, role, ...)
├── sections (named, ordered prompt blocks)
└── onboarding (first-run guidance)
```
## Tassyklama gapysynyň yzýany öz öňünden redaktirlemek
Bir agente rugsat berilip bilner **öz profilini düzeltmek** özüni redaktirleýän gurallary ulanmak — meselem, bir bölegi kämilleşdirmek ýa-da onuň işe başlatma bölümçesini täzelemek üçin. Bu bilen aňsatlyk bilen goralýar:
- Özüni redaktirlemekler arkaly barýar **tassyklama gapy**: teklip edilen üýtgeşiklik ýazga alyndy we
netijeli bolmazdan öň adam tarapyndan tassyk edilmeli. Ret edilen üýtgeşme hiç haçan
ulanyldy.
- Üýtgeşiklik täze bir zat hökmünde beýnelýär **wersiýa**, şonuň üçin öz-özüni düzmek hem barlanýar
hemme el bilen üýtgeme ýaly gaýtarylýan.
> [!WARNING]
> Öz öňünden redaktirlemek güýçli. Muny tassyklama gapysynyň yzynda sakla, şonda agent ony bilmez
> özüniň identitetini sessiz-ýuwaşlyk bilen täzeden ýazýar. Tejribeli üýtgetmeleri şol bir usulda gözden geçiriň
> islenýän islendik aýratyn üýtgeşmeleri gözden geçiriň.
### Poçta açarlary gapyga barýar
Eger agentiň konfigurasiýasyna mail giriş maglumatlary girizilen bolsa (üçin `mail` gural), açar sözi ýazylýar **şifrlendirilen şahsyýet gutusy**, profilde saklanmaýar ýa-da sorala görkezilmeýär. Gizlinler hemişe modeliň kontekstine girmeýär.
## Ýerine ýetiriş syýasaty: kontekst, sessiýalar we çaga agentler
1.3 wersiýasyndan agentiň **ýerine ýetiriş syýasaty** bar — dolandyryş
API-sindäki `runtime_policy` meýdany (döretmekde we täzelemekde
`/v1/admin/agents`). Bu `"version": 1` bilen berk barlanýan JSON obýekti: boş
`{}` adaty bahalary gaýtarýar, täzelemekde meýdany goýbermek öňki syýasaty
saklaýar, näbelli meýdanlar we rugsat berlen çäklerden daşary bahalar bolsa
ret edilýär. Syýasat gural bermeýär we hukuklary giňeltmeýär — ol diňe
býujetleri we möhletleri kesgitleýär. Agentiň klony we oňa nobaty geçirmek
ony miras alýar.
- **`context`** — taryh býujeti: `max_tokens`, `reserve_tokens` we
`history_share` soraga näçe taryhyň düşjekdigini kesgitleýär;
`max_history_messages` habar penjiresini, `bootstrap_max_chars` profil
blokynyň ölçegini çäklendirýär. Kontekst aýdyň kesgitlenende köne habarlar
häzirki sorag ýygnalmazdan öň bölek-bölek gysgaça mazmuna gysylýar.
- **`pruning`** — könelen gural netijelerini arassalamak: möhlet boýunça
(`ttl_seconds`), soňky jogaplary gorap (`keep_last_assistants`), ýumşak
kesmek (`soft_trim_ratio`, `head_chars`, `tail_chars`) we
`hard_clear_ratio` geçilende `placeholder` teksti bilen doly çalyşmak.
Ulanyjynyň tekstine, suratlara we bazadaky doly taryha degilmeýär.
- **`memory_flush`** — gysmakdan öň guralsyz agent maksatlar, kararlar we
tamamlanmadyk işler hakynda gysga bellik ýazýar (`soft_threshold_tokens`);
şol dialogyň soňky üç belligi barlanmadyk maglumat hökmünde kontekste
goşulýar.
- **`session`** — dialogyň ömri: `idle_reset_minutes` arakesmeden soň täze
kontekst başlaýar (çig taryh saklanýar), `index_prune_after_days` we
`index_max_entries` köne dialoglary pozman adaty sanawdan aýyrýar. `scope`
= `per-peer` (ähli kanallarda tassyklanan ulanyjy üçin bir dialog) ýa-da
`per-channel-peer` (her kanal üçin aýratyn dialog).
- **`children`** — çaga agentler: `max_depth` (4-e çenli), `max_concurrent`
(bir işe girizme agajyna 8-e çenli), `max_per_parent` (5-e çenli),
`timeout_seconds` (48 sagada çenli, ýöne ene-atadan uzyn däl) we
`archive_after_minutes` — tamamlanan işe girizmeleriň adaty sanawdan haçan
çykjakdygy. Bahalar bu agent üçin global `AIHUMMER_SUBAGENT_MAX_DEPTH` we
`AIHUMMER_SUBAGENT_TIMEOUT_SEC`-i täzeden kesgitleýär.
- **`max_iterations`** (1–256) — köp tabşyrmaly barlanan ssenariýler üçin
funksiýa çagyryş sikliniň ädim çägi.
- **`app`** — diňe AiHummer programmasy üçin: `reasoning_effort`,
`service_tier` we gysga jogap režimi `direct_completion` (`auto` ýa-da
`always`; `max_tokens` 4096-a çenli we `timeout_ms` 60 000-e çenli).
- **`interaction`** — sessiýalar bilen işlemek üçin aýdyň rugsatlar:
`user_ids`, `session_agent_ids`, `spawn_agent_ids`, `session_visibility`
görünişi (`self`, `agent` ýa-da `granted`), `session_send`, çaga
çagyryşlar üçin gural gadaganlyklary (`child_tool_deny`,
`child_leaf_tool_deny`) we `elevated_telegram_user_ids` — aýdyň
ýokarlandyrylan `code_exec` işe girizmesini sorap bilýän `user_ids` kiçi
toplumy (tassyklamalar aýlanyp geçilmeýär). Joker nyşanlar we bütin kärendeçi
üçin rugsatlar ýok.
## Administrator API
Agentler we olaryň gurluşly profilleri admin API-niň aşagynda dolandyrylýar, bu API OIDC bilen gaplanypdyr we barlagdan geçirilýär:
| Görnüş | Maksat |
|---|---|
| `/v1/admin/agents` | Agentleri sanawlamak, döretmek, täzeläp düzmek, öçürmek (CRUD) |
| `/v1/admin/agents/.../profile` | Gurama salnan G3 profili (şahsyýet meýdançalary) |
| `/v1/admin/agents/.../sections` | Atlandyrylan çagyryş bölümleri |
| `/v1/admin/agents/.../skills` | Agent başyna ukyplar |
| `/v1/admin/agents/.../versions` | Wersiýa taryhy, yzyna gaýtarma we köçürme |
## Indi nire?
- Agentleriň bir nobaty nähili işledýändigini we kömekçi döredenini düşünmek
[Orkestrläşdiriş we kömekçi agentler](/tk/v1.0/concepts/orchestration-subagents).
- Garaň, gelýän habaryň öňden bellenilen agentiňize nähili ýetýändigine
[Ugratma](/tk/v1.0/concepts/routing).
- Agentleriňize uzak möhletli ýat beriň
[Ýady (Einstein)](/tk/v1.0/concepts/memory-einstein).