Gapy we öwrüliň motory — AiHummer Resminamalar

AiHummeriň ýüregi ýeke gapy hyzmaty. Ol şol bir wagtda barlag tekjesi (admin API, sazlamalar, kanal simleşdiriş, bazar) we motory öwürmek (jogap berýän funksiýany çagyrýan sikl). Şonuň üçin adaty ýerleştiriş diňe şol bir hyzmat we PostgreSQL-dan ybarat — ýörite işçi gatlagyny işletmelisiňiz däldir.

Bir hyzmat, iki rol

Gapy diňleýär jemgyýetçilik port :8780 adi boýunça, dolandyrylýan AIHUMMER_GATEWAY_ADDR — bu port ähli daşarky traffigi taşýar (API, juplama, WS/SSE, gelýän webhooklar, app/pocket proksi we saglyk barlaglary). Admin Web UI şu ýerde işleýär ayry, hususy diňleýji (başlangyç) :8781, AIHUMMER_WEBUI_ADDR), kök ýoly boýunça hyzmat edildi / we hasaplananda diňe içerki interfeýs bilen baglanyşykly bolmaly. Her iki ýagdaýda hem proses hemişe şol bir ýeke-täk hyzmatdyr.

# 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)

Şu ýeke-täk berk garaşlylyk PostgreSQL. Postgres agentler, sazlamalar, gepleşikler, ýatlama, eltme ýagdaýy we barlag üçin ýeke-täk dogruluk çeşmesidir. Başga ähli zatlar — meýletin hyzmatlar, wektor saklaýjy we model üpjün edijiler — diňe siz ony sazlanda birikdirilýär.

[!NOTE] Maglumatlar binasyz gapy girişine başlanýar diňe saglyk re mode: ol jogap berýär GET /healthz şonuň üçin orkestrator ýa-da ýük deňleýji prosesiň bardygyny görüp biler diri, ýöne nobat ýetmez. GET /readyz PostgreSQL barlaýar we gaýdyp gelýär 503 mälimatlar binasy elýeterli bolmadyk wagty.

Başlananda näme bolýar

Başlangyçda geçelge birnäçe ädimleri berk tertipde ýerine ýetirýär:

mälimler bazasyna baglanyşyk hovuzyny açýar,
Postgres maslahat kilidiniň öňünde garaşýan islendik migrasiýalary ulanýar,
konfigurasiýany çözýär (maglumatlar bazasy baha → gurşaw üýtgeýji → gurnalan) standart), we
hyzmatlary birikdirýär — router, orkestrator, kanallar, gurallar, ýat, elhak — işleýän gapyçadan içeri.

Möhümligi netijesi şundan ybarat Soňky aýratynlyklaryň köpüsi sazlamalar düwmesi arkaly saýlanyp bilinýär. Konfigirasiýa edilmedik bir mümkinçilik ýalňyz işjeňleşdirilmeýär, bu bolsa standart işläp çykarmany kiçi we çaklamaly saklaýar. Siziň zatlary web dolandyryş interfeýsi arkaly ýa-da bilen açýarsyňyz AIHUMMER_* üýtgeýji, we geçelge olary indiki işe başlanda çözüw berýär (ýa-da, ony goldaýan dolandyryş düwmeleri üçin gyzgyn ýagdaýda).

Öwrülişin motory

Habar öň girişiň golaýyna ýetýän mahaly, öwrüliş motory iş başyna geçýär. Ol işleýär funksiýa çagyrýan sikl: modela ulgam çagyryşy we gepleşik berilýär, ol guraly çagyrmak (ýa-da kömekçi agentleri döretmek) mümkin, her bir guralyň netijesi yzyna berilýär, we bu proses model soňky jogap alana çenli dowam edýär. Şol jogap soňra eltip bermek gatlagyna berilýär.

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

Çünki öwürme her girizilen maglumatyň näme ýerden gelýändigine determinstik häsiýete eýedir, jogaplar söhbetdeşligiň taryhyndan we gurallar netijelerinden çözülýär — hiç haçan ynamsyz teksti görkezmeleriň içine goýmak arkaly däl. Bu häsiýet aşakdaky görkezme gatlamagyny hem howpsuz, hem hem çalt edýär.

Çeňňekli, keşi goldaýan ulgam görkezmesi

Sistemanyň çagyryşy bir bölek däl. Ol gatlaklar bilen jemlenýär, edil şol tertipde düzülýär, şonuň üçin durnukly bölekler ilkinji bolup gelýär we üýtgeşik bölekler soňunda gelýär. Bu möhüm, sebäbi model üpjün edijiler prompty onuň prefiksi boýunça kesgitleýär: promptyň başy bait-bait görnüşde meňzeş bolany müddetçe, kesgitlenen prefix ulanylýar we diňe soňky bölegi täzeden işlenýär.

Sebit	Gatlaklar (tartyp boýunça)	Üýtgeşmeler…
Durnukly öňki goşmaça (keshlenip bilinýän)	esasy şahsyýet + gural/ýatlamagyň gollanmasy → ýaşaýjy → persona → başarnyklar	syýasy — wekili/kirýewçisi boýunça
Durnuksyz dykin (iň soňuna goşuldy)	başlamak ýagdaýy → ýatlama nyrhlamak → ýaşan senesi	her ädimde

Durnukly prefiks agentiň kimdigini kesgitleýän ähli zady taşýar: gurnalan şahsyýet we gurallaryň we ýadyň nähili işleýändigini görkezýän gollanma, soňra ýaşaýan gatlak, agentiň şahsyýeti we görkezilen başarnyklar bloku. Şeýlelik bilen, şol beýleki agentiň yzygiderli iki nobat arasyndaky hiç bir zat üýtgeýärok, şonuň üçin gaýtadan ulanylyp bilinýän keslän prefiks emele gelýär.

Durnuksyz dyz goşulýar soňra durnukly prefiksi takyklykda, şonuň üçin kesh işjeňligini hiç haçan ýitirmez: onboard medeniýeti, bu belli söhbet üçin suwy baýramçylyk ýaly ýadyrylýan ýatlama we häzirki senesi her öwrümde üýtgäp durýar, ýöne olar ahyrynda ýerleşýänligi üçin diňe goşýan zatlarynyň bahasyny alýar.

[!TIP] Bu tertipleme, häzirki senesi ýaly göni maglumatlaryň bardygynyň sebäbidir her öwrümde ähli şahsyýeti täzeden kodlamaga tölemän. Sakla durnukly gatlaklarda her agent üçin ýörite mazmun (persona, ussatlyklar) we rugsat ber motor üýtgeşik guşa eýe.

Indi nire?

Ýaşaýjylaryň nähili sepilendirilenine serediň Çoxugurlylyk we idempotentlik.
Jogaplaryň nähili gaýtarylýandygyny öwreniň Ygtybarly eltme we gaýtaryp alma.
Isleg boýunça mümkinçilikler hökmünde işleýär Sidecarlar.