Şlüz və dönüş mühərriki — AiHummer Sənədlər

AiHummer-in ürəyi tək bir keçid xidməti. Bu eyni zamanda idarəetmə təyyarəsi (admin API, ayarlar, kanal əlaqələndirməsi, bazar yeri) və mühərriki fırlatmaq (cavab verən funksiya çağırış döngəsi). Tipik yerləşdirmə buna görə sadəcə o bir xidmət və PostgreSQL-dir — işlətməli olduğunuz ayrıca işçi səviyyəsi yoxdur.

Bir xidmət, iki rol

Şlüz bu ünvanı dinləyir ictimai liman :8780 səhvən, nəzarət olunan tərəfindən AIHUMMER_GATEWAY_ADDR — bu port bütün xarici trafiki daşıyır (API, qoşulma, WS/SSE, daxil olan webhooklar, tətbiq/cib proksi və sağlamlıq yoxlamaları). İdarəetmə Veb İstifadəçi İnterfeysi işləyir ayrı, şəxsi dinləyici (əvvəlcədən təyin olunmuş) :8781, AIHUMMER_WEBUI_ADDR), kök yolunda xidmət göstərilir / və ideal olaraq yalnız daxili interfeysə bağlıdır. Hər iki halda, proses həmişə eyni tək xidmətdir.

# gateway.env — the only required setting
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
# Admin Web UI after start at http://localhost:8781/ (the private Web UI listener)

O tək ciddi asılılıq PostgreSQL-dir. Postgres agentlər, parametrlər, söhbətlər, yaddaş, çatdırılma vəziyyəti və audit üçün tək həqiqət mənbəyidir. Digər hər şey — əlavə xidmətlər, vektor mağazası və model təminatçıları — yalnız onu konfiqurasiya etdiyiniz zaman qoşulur.

[!NOTE] Məlumat bazası olmadan giriş qapısı işə düşür yalnız sağlamlıq rejimi: cavab verir GET /healthz beləliklə, orkestrator və ya yük balanslayıcı prosesin görməsini təmin edə bilər canlı, amma faydalı olmayacaq. GET /readyz PostgreSQL-i yoxlayır və qaytarır 503 verilənlər bazasına çatmaq mümkün olmadıqda.

Başlanğıcda nə olur

Başlanğıcda qapı bir neçə addımı ciddi bir sıra ilə yerinə yetirir:

verilənlər bazası bağlantı hovuzunu açır,
Postgres məsləhət kilidi altında hər hansı gözləyən miqrasiyaları tətbiq edir,
konfiqurasiyanı həll edir (verilənlər bazası dəyəri → ətraf mühit dəyişəni → daxili) sayılan), və
xidmətləri birləşdirir — yönləndirici, orkestrator, kanallar, alətlər, yaddaş, çatdırılma — işlək qapıya.

Vacib nəticə odur ki əksər xüsusiyyətlər parametrlər düyməsi vasitəsilə seçilə bilər. Konfiqurasiya edilməmiş bir qabiliyyət sadəcə aktivləşdirilməyib, bu da standart işləmə vaxtını kiçik və proqnozlaşdırıla bilən saxlayır. Siz veb idarəetmə İST və ya bir vasitəsi ilə şeyləri açırsınız AIHUMMER_* dəyişən, və qapı onları növbəti başladıqda (və ya onu dəstəkləyən düymələr üçün isti halda) həll edir.

Dönmə mühərriki

Mesaj qapıya çatanda, çevrilmə mühərriki işə düşür. O, işləyir funksiya çağırış döngəsi: modelə sistem təlimatı və söhbət verilir, o alətləri çağıra bilər (və ya alt-agentlər yarada bilər), hər bir alət nəticəsi geri verilir və dövr davam edir ta ki, model son cavab verənə qədər. O cavab sonra çatdırılma qatına verilir.

inbound message
   └─▶ turn engine
         ├─ assemble layered system prompt
         ├─ call model ──▶ tool calls / sub-agents ──▶ tool results ─┐
         │       ▲                                                    │
         │       └────────────────────────────────────────────────-─┘
         └─ final answer ─▶ reliable delivery ─▶ originating channel

Çünki dövr hər girişin haradan gəldiyi barədə deterministdir, cavablar söhbət tarixçəsindən və alət nəticələrindən həll olunur — heç vaxt etibarsız mətni təlimatlara əlavə etməklə deyil. Bu xüsusiyyət aşağıdakı prompt təbəqələməsini həm təhlükəsiz, həm də sürətli edir.

Təbəqələşdirilmiş, kesh-ə uyğun sistem sorğusu

Sistem təlimatı tək bir vahid deyil. O, qatlar şəklində yığılır, bilərəkdən belə sıra ilə tərtib olunur ki, sabit hissələr əvvəl gəlir və dəyişkən hissələr sonra gəlir. Bu önəmlidir, çünki model təminatçıları promptu onun başlanğıcı ilə ön-yaşayırlar: promptun başlanğıcı baytdan-bayta eynidirsə, ön-yaşanmış başlanğıc yenidən istifadə olunur və yalnız son hissə təkrar emal edilir.

Zona	Təbəqələr (sıra ilə)	Dəyişikliklər…
Sabit prefiks (keşlənə bilən)	əsas identiklik + alət/yaddaş bələdçisi → kirayəçi → şəxsiyyət → bacarıqlar	nadir hallarda — agent/icarəyə götürən başına
Sərt quyruq (sonuna əlavə olunub)	işə salma vəziyyəti → yaddaşın suvarılması → canlı tarix	hər dönmə

Sabit ön söz, agentin kim olduğunu müəyyən edən hər şeyi daşıyır: daxili kimlik və alətlərin və yaddaşın necə işlədiyini göstərən bələdçi, sonra kirayəçi təbəqəsi, agentin personajı və göstərilən bacarıqlar bloku. Bunların heç biri eyni agentin iki ardıcıl çevrilməsində dəyişmir, buna görə də təkrar istifadə edilə bilən keşlenmiş ön söz əmələ gətirir.

Dalğalı quyruq əlavə olunur sonra sabit prefiks tam belə ki, o heç vaxt keşi etibarsız etmir: onboarding vəziyyəti, bu konkret söhbət üçün yaddaş doldurulmuşdur və cari tarix hər dönüşdə dəyişir, amma onlar sonda yerləşdiyi üçün yalnız əlavə etdikləri qədər xərc çəkir.

[!TIP] Bu sıralama, bu günün tarixi kimi canlı məlumatların ola biləcəyinin səbəbidir hər dəfə bütün şəxsiyyəti yenidən kodlaşdırmaq üçün ödəniş etmədən hər dönüş. Saxla stabil təbəqələrdə (persona, bacarıqlar) hər agent üçün xüsusi məzmun və icazə ver mühərrik dəyişkən quyruğa sahibdir.

Növbəti haradır

Kirayəçilərin necə izolyasiya olunduğunu görün Çoxtenantlilik və idempotentlik.
Cavabların necə qaytarıldığını öyrənin Etibarlı çatdırılma və bərpa.
Seçimli imkanlar kimi işləyir Yan arabalar.