AiHummer
Azərbaycanca▾
Daxil ol
v1.0.x▾
v1.0.xstable
{ }Swagger
Əsas anlayışlar/Agentlər və personalar

Agentlər və personalar

v1.0.x · yeniləndi 2026-06-26

Agent AiHummer-in söhbətin qarşısına qoyduğu vahiddir. Hər agentin personası, öz modeli, strukturlaşdırılmış promptu və bacarıqlar dəsti var və ona edilən hər dəyişiklik versiyalaşdırılır. Agentlər veb admin UI-dən və /v1/admin/agents/* altındakı admin API vasitəsilə idarə olunur.

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

Agent reyestri

Reyestr agentlərin tam CRUD kataloqudur. Hər agent üçün siz bir kimlik, persona, üzərində işlədiyi model və istifadə edə biləcəyi bacarıqları müəyyən edirsiniz. Gateway çoxkiracılı olduğundan, agentlər iş sahəsi (workspace) daxilində yaşayır və istənilən digər kirayəçi məlumatı kimi izolyasiya olunur.

  • Persona — agentin səsi və davranışı, sistem promptunun sabit, keş üçün əlverişli qatına render edilir.
  • Hər agent üçün model — hər agent öz modelini və provayderini sabitləyə bilər, beləliklə ucuz agent və flaqman agent eyni iş sahəsində birlikdə mövcud ola bilər.
  • Bacarıqlar — hər agent üçün və ortaq bacarıqlar prompta “Skills” bloku render edir; onlar imkanları təsvir edir, çəkiləri yox.

[!NOTE] Hər agent üçün model marşrutlaşdırmadan müstəqildir. Model səviyyəsi marşrutlaşdırması (simple / standard / complex) növbə üçün model sinfini seçir, hər agent üçün model isə agentin öz defoltudur. Baxın: Marşrutlaşdırma.

Versiyalar, geri qaytarma və klonlama

Agentə edilən hər mənalı dəyişiklik versiya kimi tutulur. Bu, agent konfiqurasiyasını audit edilə bilən və geri qaytarıla bilən edir: nəyin dəyişdiyini nəzərdən keçirə, əvvəlki versiyaya geri qayıda və ya yenisi üçün başlanğıc nöqtəsi kimi istifadə etmək üçün agenti klonlaya bilərsiniz. Versiya və profil resursları /v1/admin/agents/* altında yaşayır (profil, bölmələr, bacarıqlar, versiyalar).

[!TIP] Böyük persona və ya prompt yenidən yazımından əvvəl işləyən agenti klonlayın. Yeni istiqamət baş tutmasa, orijinal hələ də bir geri qaytarma uzaqlıqdadır.

Strukturlaşdırılmış “G3” prompt

Tək sərbəst mətnli sistem promptu əvəzinə AiHummer strukturlaşdırılmış agent profili (daxili adı “G3”) istifadə edir. Kimlik prozada gizlədilmək əvəzinə sahələrə ayrılır və promptun qalan hissəsi adlandırılmış bölmələrdən plus bir onboarding blokundan qurulur. Orkestrator bunları qatlı sistem promptuna render edir, sabit hissələri (kimlik, persona, bölmələr) keşlənə bilən prefiksdə saxlayır və dəyişkən məlumatı sona əlavə edir.

Bu struktur profili sahə-sahə redaktə etməyi asanlaşdırır, versiyalar arasında fərqləndirməni asanlaşdırır və renderi proqnozlaşdırıla bilən edir — gizli prompt qarışığı yoxdur.

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

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

Agentə öz-özünü redaktə alətlərindən istifadə edərək öz profilini redaktə etməyə icazə verilə bilər — məsələn bir bölməni cilalamaq və ya onboarding-ini yeniləmək üçün. Bu, qəsdən mühafizə olunur:

  • Öz-özünü redaktələr təsdiq qapısından keçir: təklif edilən dəyişiklik qeydə alınır və qüvvəyə minməzdən əvvəl insan tərəfindən təsdiqlənməlidir. Rədd edilən dəyişiklik heç vaxt tətbiq olunmur.
  • Dəyişiklik yeni versiya kimi tutulur, beləliklə öz-özünə redaktə istənilən əl ilə redaktə qədər audit edilə bilən və geri qaytarıla biləndir.

[!WARNING] Öz-özünü redaktə güclüdür. Agentin öz kimliyini səssizcə yenidən yaza bilməməsi üçün onu təsdiq qapısı arxasında saxlayın. Təklif edilən öz-özünü redaktələri istənilən imtiyazlı dəyişikliyi nəzərdən keçirdiyiniz kimi nəzərdən keçirin.

Poçt parolları seyfə gedir

Əgər agentin konfiqurasiyasına poçt etibarnamələri daxildirsə (mail aləti üçün), parol profildə saxlanmır və ya prompta render edilmir, şifrələnmiş etibarnamə seyfinə yazılır. Sirlər heç vaxt model kontekstinə daxil olmur.

Admin API

Agentlər və onların strukturlaşdırılmış profilləri OIDC-qapalı və audit edilən admin API altında idarə olunur:

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 (kimlik sahələri)
/v1/admin/agents/.../sections Adlandırılmış prompt bölmələri
/v1/admin/agents/.../skills Hər agent üçün bacarıqlar
/v1/admin/agents/.../versions Versiya tarixçəsi, geri qaytarma və klonlama

Sonra haraya