Шарты жана кыймылдаткыч — AiHummer Документация

AiHummerдин жүрөгү бирдиктүү шлюз кызматы. Ал ошол эле учурда башкаруу жаздыкчасы (админ API, настройкалар, каналдык туташтыруулар, базар) жана двигательди күйгүзүү (жоопту чыгарган функция чакыруу цикли). Демек, типтүү жайгаштыруу – бул бир кызмат жана PostgreSQL гана — сиз иштетишиңиз керек болгон өзүнчө жумушчу катмар жок.

Бир кызмат, эки роль

Шлюз уга жатат жалпы порт :8780 демейки боюнча, башкарылат AIHUMMER_GATEWAY_ADDR — бул порт бардык тышкы трафикти ташыйт (API, жуптоштурууга, WS/SSE, кирүү вебхуктары, тиркеме/чантаж прокси жана саламаттыкты текшерүү). Админ Веб UI иштейт ажыратылган, жекеме-жеке тынын алуучу (дефолт) :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 кеңештик кулпусу алдында кезекте турган бардык миграцияларды колдонулат,
конфигурацияны чечет (маалымат базасынын мааниси → айлана-чөйрө өзгөрмөсү → түзүлгөн) адаттагы), жана
кызматтарды туташтырат — маршрутизатор, оркестратор, каналдар, куралдар, эс жеткирүү — иштеп жаткан шлюзга.

Мындан маанилүү кесепет көпчүлүк өзгөчөлүктөр жөндөөлөрдүн ачкычын колдонуу менен ишке ашат. Конфигурацияланбаган мүмкүнчүлүк жөн гана иштетилбейт, бул демейки деңгээлдеги аткарууну чакан жана алдын ала болжолдоого мүмкүн болгондуруу менен сактайт. Сиз аны веб-админ UI аркылуу же менен күйгүзөсүз AIHUMMER_* өзгөрмө, жана шлюз аларды кийинки жүктөөнүн учурунда чечет (же колдоо көрсөткөн бурамалар үчүн ысып турганда).

Бурмалоочу кыймылдаткыч

Месседж шлюзга жеткенде, бурулуш кыймылдаткычы ишке кирет. Ал иштейт функция чакыруусу цикли: модельге система суроо-талап жана сүйлөшүү берилет, ал куралдарды чакырышы мүмкүн (же суб-агенттерди жаратат), ар бир куралдын жыйынтыгы кайра берилет, жана цикл модель акыркы жоопту чыгарганга чейин уланат. Бул жооп андан кийин жеткирүү катмарын өткөрүлөт.

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

Цикл ар бир кирүү кайдан келгени жөнүндө детерминисттик болгондуктан, жооптор сүйлөшүү тарыхынан жана куралдардын натыйжаларынан чечилет — эч качан ишенимсиз текстти көрсөтмөлөргө кошуу менен эмес. Бул мүнөздөмө төмөндөгү сунуштун катмарлашын коопсуз жана ылдам кылат.

Катмарлуу, кэшке ыңгайлуу система буйругу

Система суранычы бирден-бирдик эмес. Ал катмарлары менен жыйынтыкталат, атайын тартипте уюштурулган туруктуу бөлүктөр биринчи келет, ал эми өзгөрмөлүү бөлүктөр акырында келет. Бул маанилүү, анткени модель провайдерлери промптту анын префикси менен кэшируют: промпттун башы байт боюнча так ошол эле өзгөрбөгөнлүгүнө чейин, кэште сакталган префикс колдонулат жана болгону соңку бөлүгү кайра иштелет.

Аймак	Катмарлар (тартылган тартипте)	Өзгөрүүлөр…
Туруктуу префикс (кэштелүүчү)	негизги идентификация + курал/эс тутум жарлыгы → ижарачы → персона → көндүмдөр	сирек — агент/ижарачы боюнча
Тартылуу куйрукту (акыркысына кошулду)	ишке киргизүү абалы → эс тутумду суутуу → түз күн	ар бир бурулушта

Туруктуу префикс агенттин ким экенин аныктайт: орнотулган идентификация жана куралдар менен эс тутумдун кантип иштээрин көрсөтүү, андан кийин турак катмар, агенттин персонасы жана иштелип чыккан көндүмдөр блогу. Булардын бири да бир агенттин эки катар чуркоосу арасында өзгөрбөйт, ошондуктан ал кайра колдонууга ыңгайлашкан кэш префиксин түзөт.

Оочукту жоон менен кошумчаланган кейин туруктуу префикс так ушундайча, анткени ал эч качан кэшты жараксыз кылбайт: өздүк абал, ушул конкреттүү сүйлөшүү үчүн суусундукка толтурулган эс тутум жана учурдагы дата ар бир айланууда өзгөрөт, бирок алар аягында тургандыктан, болгону кошконун гана чыгарып жиберет.

[!TIP] Бул тартип жандуу маалыматтар, мисалы бүгүнкү дата, болушу мүмкүн экендигинин себеби болуп саналат ар бир жолу бүтүндүгүн кайра коддоого акча төлөбөстөн буроо жасоо. Сакта туруктуу катмарлардагы ар тараптуу агент үчүн мазмунду (персона, көндүмдөр) жана берүүгө машина өзгөрмөлү жоонду ээлейт.

Келерки кайда

Ижарачылар кантип өзүнчө кармалып жатканын караңыз Көп колдонуучулук & идемпотенттик.
Жооптор кантип кайтарыларын үйрөнүңүз Ишенимдүү жеткирүү жана калыбына келтирүү.
Милдеттүү эмес мүмкүнчүлүктөр катары ишке киргизилет Сайдкарлар.