AiHummer
Türkmençe
GirmekŞahsy kabinet
v1.3.x
{ }Swagger

Agentler we kişilikler

v1.3.x · täzelendi 2026-09-15

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.

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?