Agentlər və personajlar — AiHummer Sənədlər

Bir agent AiHummer-in bir söhbətin önünə qoyduğu vahiddir. Hər bir agentin bir şəxsiyyəti, öz modeli, strukturlaşdırılmış təklifi və bacarıqlar dəsti var və ona edilən hər dəyişiklik versiyalanır. Agentlər veb idarəçi istifadəçi interfeysindən və admin API vasitəsilə idarə olunur. /v1/admin/agents/*.

Bu səhifə agentin nədən ibarət olduğunu, strukturlaşdırılmış “G3” sorğusunun necə yığıldığını və agentin öz profilini necə təhlükəsiz şəkildə redaktə edə biləcəyini əhatə edir.

Agent reyestri

Qeydiyyat agentlərin tam CRUD kataloqudur. Hər bir agent üçün siz bir şəxsiyyət, bir persona, işlədiyi model və istifadə edə biləcəyi bacarıqları təyin edirsiniz. Qapı çoxtenantlı olduğundan, agentlər iş sahəsi içində yerləşir və digər tenant məlumatları kimi izolyasiya olunurlar.

Persona — agentin səsi və davranışı, sabit bir vəziyyətə çevrilmiş, sistem sorğusunun keş-yönümlü təbəqəsi.
Hər-agent modeli — hər bir agent öz modelini və təminatçısını təyin edə bilər, beləliklə Ucuz agent və bayraq agent eyni iş mühitində mövcud ola bilər.
Bacarıqlar — hər-agent və paylaşılan bacarıqlar “Bacarıqlar” blokunu buna çevirir sürətli; onlar qabiliyyətləri təsvir edir, ağırlıqları yox.

[!NOTE] Hər agent üçün model marşrutlamadan asılı deyil. Model səviyyəli marşrutlama (sadə / standart / mürəkkəb) bir dövr üçün bir model sinfi seçir, agent başına isə model agentin özünün standartıdır. Bax Marşrutlaşdırma.

Versiyalar, geri qayıtma və klon

Bir agentdəki hər mənalı dəyişiklik kimi qeyd olunur versiya. Bu, agentin konfiqurasiyasını yoxlanıla bilən və geri alına bilən edir: nə dəyişdiyini nəzərdən keçirə bilərsiniz, geri qaytarmaq əvvəlki versiyaya, və ya klon onu yeni bir başlanğıc nöqtəsi olaraq istifadə etmək üçün agent. Versiya və profil resursları altında yerləşir /v1/admin/agents/* (profil, bölmələr, bacarıqlar, versiyalar).

[!TIP] Böyük bir şəxsiyyət və ya əmr yenidən yazmadan əvvəl işləyən agenti klonlayın. Əgər yeni istiqamət nəticə verməsə də, orijinal hələ də bir geri addım uzaqdadır.

Strukturlaşdırılmış “G3” təlimatı

Tək bir sərbəst mətnli sistem əmrinin əvəzinə, AiHummer istifadə edir strukturlaşdırılmış agent profili (daxili olaraq “G3”). Şəxsiyyət sahələrə bölünmüş proza içində basdırılmamaq, və təlimin qalan hissəsi adlandırılmışdan qurulub bölmələr artı bir işə adaptasiya prosesi blok. Orkestrator bunları təbəqəli sistem göstərişinə çevirir, sabit hissələri (şəxsiyyət, persona, bölmələr) keşlənə bilən ön sözdə saxlayır və dəyişkən məlumatı sona əlavə edir.

Bu struktur profili sahə-sahə asanlıqla redaktə etməyə, versiyalar arasında fərqləri asanlıqla görməyə və tərtibata görə proqnozlaşdırıla bilən etməyə imkan verir — gizli prompt qarışığı yoxdur.

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

Təsdiq qapısının arxasında özünü redaktə etmək

Bir agentə icazə verilə bilər öz profilini redaktə et özünü redaktə alətindən istifadə etmək — məsələn, bir bölməni təkmilləşdirmək və ya onun onboardingini yeniləmək üçün. Bu qəsdən qorunur:

Öz-özünə düzəlişlər bu vasitədən keçir təsdiq qapısı: təklif olunan dəyişiklik qeydə alınır və təsirə başlamazdan əvvəl insan tərəfindən təsdiqlənməlidir. Rədd edilən dəyişiklik heç vaxt tətbiq edildi.
Dəyişiklik yeni olaraq qeydə alınır versiya, buna görə öz-özünü redaktə etmək də yoxlanıla biləndir və hər hansı əl ilə düzəliş qədər geri çevrilə bilən.

[!WARNING] Özünü-redaktə etmək güclüdür. Onu təsdiq qapısının arxasında saxlayın ki, agent edə bilməsin öz şəxsiyyətini səssizcə yenidən yazır. Təklif olunan öz redaktələrini eyni şəkildə nəzərdən keçir hər hansı üstünlük verilmiş dəyişikliyi nəzərdən keçirin.

Poçt şifrələri dəfterxanaya gedir

Əgər agentin konfiqurasiyasına poçt məlumatları daxildirsə (üçün mail alət), şifrə yazılır şifrələnmiş etimadnamə anbarı, profilə qeyd olunmur və ya prompta daxil edilmir. Sirlər heç vaxt model kontekstinə daxil edilmir.

İcra siyasəti: kontekst, sessiyalar və törəmə agentlər

1.3 versiyasından agentin icra siyasəti var — idarəetmə API-sində runtime_policy sahəsi (yaratma və yeniləmə zamanı /v1/admin/agents). Bu, "version": 1 ilə ciddi yoxlanılan JSON obyektidir: boş {} standart dəyərləri qaytarır, yeniləmə zamanı sahənin buraxılması əvvəlki siyasəti saxlayır, naməlum sahələr və icazə verilən hədlərdən kənar dəyərlər isə rədd edilir. Siyasət alət vermir və hüquqları genişləndirmir — yalnız büdcələri və müddətləri təyin edir. Agentin klonu və ona növbənin ötürülməsi onu miras alır.

context — tarixçə büdcəsi: max_tokens, reserve_tokens və history_share sorğuya nə qədər tarixçənin düşəcəyini müəyyən edir; max_history_messages mesaj pəncərəsini, bootstrap_max_chars profil blokunun ölçüsünü məhdudlaşdırır. Kontekst açıq şəkildə təyin olunduqda köhnə mesajlar cari sorğu yığılmazdan əvvəl hissə-hissə xülasəyə sıxılır.
- pruning — köhnəlmiş alət nəticələrinin təmizlənməsi: müddətə görə (ttl_seconds), son cavabları qorumaqla (keep_last_assistants), yumşaq kəsmə (soft_trim_ratio, head_chars, tail_chars) və hard_clear_ratio aşıldıqda placeholder mətni ilə tam əvəzləmə. İstifadəçi mətninə, şəkillərə və bazadakı tam tarixçəyə toxunulmur.
- memory_flush — sıxılmadan əvvəl alətsiz agent məqsədlər, qərarlar və yarımçıq işlər haqqında qısa qeyd yazır (soft_threshold_tokens); eyni dialoqun son üç qeydi yoxlanılmamış arayış kimi kontekstə qarışdırılır.
session — dialoqun həyat dövrü: idle_reset_minutes fasilədən sonra yeni kontekst başladır (xam tarixçə saxlanılır), index_prune_after_days və index_max_entries köhnə dialoqları silmədən standart siyahıdan çıxarır. scope = per-peer (bütün kanallarda təsdiqlənmiş istifadəçi üçün bir dialoq) və ya per-channel-peer (hər kanal üçün ayrı dialoq).
children — törəmə agentlər: max_depth (4-ə qədər), max_concurrent (bir işə salma ağacına 8-ə qədər), max_per_parent (5-ə qədər), timeout_seconds (48 saata qədər, lakin valideyndən uzun olmayaraq) və archive_after_minutes — tamamlanmış işə salmaların standart siyahıdan nə vaxt çıxacağı. Dəyərlər bu agent üçün qlobal AIHUMMER_SUBAGENT_MAX_DEPTH və AIHUMMER_SUBAGENT_TIMEOUT_SEC parametrlərini əvəz edir.
max_iterations (1–256) — çoxlu həvalələri olan yoxlanılmış ssenarilər üçün funksiya çağırışı dövrünün addım limiti.
app — yalnız AiHummer tətbiqi üçün: reasoning_effort, service_tier və qısa cavab rejimi direct_completion (auto və ya always; max_tokens 4096-ya qədər və timeout_ms 60 000-ə qədər).
interaction — sessiyalarla iş üçün açıq icazələr: user_ids, session_agent_ids, spawn_agent_ids, session_visibility görünürlüyü (self, agent və ya granted), session_send, törəmə çağırışlar üçün alət qadağaları (child_tool_deny, child_leaf_tool_deny) və elevated_telegram_user_ids — açıq şəkildə yüksəldilmiş code_exec icrasını tələb edə bilən user_ids alt çoxluğu (təsdiqlər keçilmir). Joker simvollar və bütün icarəçi üçün icazələr yoxdur.

Admin API

Agentlər və onların strukturlaşdırılmış profilləri admin API altında idarə olunur, bu API OIDC vasitəsilə qorunur və yoxlanılır:

Resurs	Məqsəd
`/v1/admin/agents`	Agentləri siyahıya almaq, yaratmaq, yeniləmək, silmək (CRUD)
`/v1/admin/agents/.../profile`	Strukturlaşdırılmış G3 profili (şəxsiyyət sahələri)
`/v1/admin/agents/.../sections`	Adlandırılmış sorğu bölmələri
`/v1/admin/agents/.../skills`	Hər agentin bacarıqları
`/v1/admin/agents/.../versions`	Versiya tarixi, geri qaytarma və klonlama

Növbəti haradır

Agentlərin bir turu necə idarə etdiyini və köməkçiləri necə yaratdığını anlayın Orkestrasiya və sub-agentlər.
Gələn mesajın necə müəyyən bir agentə çatdığını görün Marşrutlaşdırma.
Agentlərinizə uzunmüddətli yaddaş verin Yaddaş (Eynşteyn).