Дарвозаву муҳаррики гардиш — AiHummer Ҳуҷҷатнигорӣ

Дили AiHummer ин аст як хидмати дарвоза. Ин ҳамзамон нисфи назорат (API маъмур, танзимот, симкаши канал, бозор) ва моторро гардондан (давраи фармоннамоии функсия, ки ҷавоб медиҳад). Пас, як насби типикӣ танҳо ҳамон як хизматрасонӣ ба плюс PostgreSQL мебошад — шумо ба иҷрои сатҳи коргар ҷудогонае ниёз надоред.

Як хизмат, ду нақш

Дарвозаи дар гӯш кардани оммавӣ бандар :8780 бо тавзеҳ, таҳти назорат қарор гирифта AIHUMMER_GATEWAY_ADDR — ин порт тамоми равандҳои беруна (API, ҷуфтсозӣ, WS/SSE, вебхукуҳои воридшаванда, проксӣи барнома/ҷайб ва санҷишҳои саломатӣ) -ро мегирад. Интерфейси вебии идоракунанда дар ҷудо, хусусӣ шинаванда (поёнӣ :8781, AIHUMMER_WEBUI_ADDR), дар роҳи реша хизмат кард / ва беҳтараш ба интерфейси дохилӣ маҳдуд аст. Ҳар ду ҳолат, ҷараён ҳамеша ҳамон як хидмат мебошад.

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

Он танҳо вобастагии вазнин PostgreSQL мебошадPostgres манбаи ягонаи ҳақиқат барои агентҳо, танзимот, сӯҳбатҳо, хотира, ҳолати таҳвил ва аудит мебошад. Ҳамаи чизҳои дигар — хидматҳои ихтиёрӣ, анбори векторӣ ва таъминкунандагони модел — танҳо вақте пайваст карда мешаванд, ки шумо онҳоро танзим мекунед.

[!NOTE] Бе пойгоҳи додаҳо дарвоза оғоз намешавад ҳолати танҳо саломатӣин ҷавоб медиҳад GET /healthz то як оркестратор ё борбалансер метавонад бубинад, ки раванд чист зинда, аммо он навбат намегирад. GET /readyz санҷишҳои PostgreSQL ва бармегардад 503 дар ҳоле ки пойгоҳи додаҳо дастрас нест.

Чӣ дар оғози кор рӯй медиҳад

Дар оғозгоҳ шлюз чанд қадамро дар тартиби қатъӣ иҷро мекунад:

пӯшиши пайвастшавии пойгоҳи додаҳоро мекушояд,
ҳар гуна муҳоҷиратеро, ки мунтазир будаанд, таҳти қулфи машваратии Postgres иҷро мекунад,
конфигуратсияро ҳал мекунад ( арзиши пойгоҳи додаҳо → тағйирёбандаи муҳит → сохтори дохилӣ) пешфарз), ва
хизматрасониҳоро пайваст мекунад — роутер, оркестратор, каналҳо, абзорҳо, хотира, тавсия — ба дарвозае, ки ҳоло кор мекунад.

Паёмади муҳими он ин аст, ки аксари хусусиятҳо тавассути калиди танзимот интихоб карда мешавандҚобилиятие, ки танзим нашудааст, танҳо фаъол намешавад, ки ин андозаи вақти иҷрои пешфарзро хурд ва пешгӯшаванда нигоҳ медорад. Шумо чизҳоро аз интерфейси маъмурии веб ё бо истифода аз AIHUMMER_* тағйирёбанда ва дарвоза онҳоеро дар оғози навбатӣ (ё гарм, барои тугмаҳое, ки онро дастгирӣ мекунанд) ҳал мекунад.

Мотори гардиш

Вақте паём ба дарвоза мерасад, муҳаррики гардиш назоратро ба даст мегирад. Он ҷараён мегирад давраи даъвати функсияБа модел системаи дастур ва гуфтугӯ дода мешавад, он метавонад аз воситаҳо истифода кунад (ё агентҳои хурд эҷод кунад), натиҷаи ҳар восита баргардонида мешавад ва давра давом меёбад то он даме ки модел ҷавоби ниҳоӣ медиҳад. Он ҷавоб сипас ба қабати таҳвил супорида мешавад.

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

Азбаски давра дар бораи аз куҷо омадани ҳар як воридот детерминистӣ мебошад, посухҳо аз таърихи суҳбат ва натиҷаҳои абзор ҳал карда мешаванд — ҳеҷ гоҳ бо ворид кардани матни боварӣ надошташуда дар дастурҳо. Ин хусусиятест, ки қабати Prompt-и зери он ҳам бехатар ва ҳам тез мебошад.

Фармони системаи қабатӣ, мувофиқи кэши дӯст

Промпти системӣ як қисми ягона нест. Он дар қабатҳо ҷамъ омадааст, ҳадафмандона ба тартиб гузошта шудааст то ки Қисмҳои устувор аввал омада, қисмҳои тағйирпазир охир меояндИн муҳим аст, зеро таъминкунандагони моделҳо як пешниҳоди ибтидоиро бо префиксаш нигоҳ медоранд: то даме ки оғози пешниҳоди ибтидоӣ комилан бо байт ба байт ҳамон бошад, префикси нигаҳдоришуда такрор мешавад ва танҳо қисмати охирӣ дубора коркард мешавад.

Минтақа	Қабатҳо (ба тартиб)	Тағйирот
Пешвойи устувор (кишиданашаванда)	ҳувияти асосӣ + асбоб/роҳнамои хотира → иҷоранишин → шахсияти шахс → малакаҳо	кам — барои агент/нафақахӯ
Думи номустаҳкам (замимаи охирин)	ҳолати оғоз → обёрии хотира → санаи зинда	ҳар гардиш

Префикси устувор ҳамаро, ки муайян мекунад ки агент кист, дар бар мегирад: шахсияти дохилшаванда ва роҳнамои кор бо воситаҳо ва хотира, сипас қабати истиқоматӣ, шахсияти агент ва блоки маҳорати иҷрошуда. Ҳеч кадоме аз ин миёни ду гардиши пайиҳамии ҳамон агент тағйир намеёбад, пас он як префикси кэшшудаи такроршавандаро ташкил медиҳад.

Думи номуқаррар зам дода шудааст. пас аз асосии устувор дақиқ, то ки ҳеҷ гоҳ кэшро нодуруст накунад: ҳолати шурӯъ, хотираи барои ин гуфтугӯи махсус омодашуда ва санаи ҷорӣ ҳама навбат ба навбат тағйир меёбанд, аммо азбаски онҳо дар охир қарор доранд, танҳо хароҷоте, ки илова мекунанд, доранд.

[!TIP] Ин тартиб сабаби он аст, ки маълумоти зинда монанди санаи имрӯз метавонад мавҷуд бошад. ҳар гардиш бе пардохт барои дубора рамзгузорӣ кардани тамоми шиноснома ҳар бор. Давом диҳед мазмуни фармоишӣ барои ҳар агент дар қабатҳои устувор (шахсияти шахс, малакаҳо) ва бигузоред мотор ба думи ноустувор тааллуқ дорад

Баъд ба куҷо

Бинед, ки чӣ гуна иҷоранишинҳо танҳо шудаанд Чандқабата ва идемпотентӣ.
Фаромӯш накунед, ки посухҳо чӣ гуна баргардонида мешаванд Расонидани боэътимод ва барқарорсозӣ.
Имкониятҳои ихтиёрӣ ҳамчун иҷро мешаванд Сайдкарҳо.