Хаалга ба эргэлтийн хөдөлгүүр

AiHummer-ийн зүрх нь нэг л нэг үүдний үйлчилгээ. Энэ нь нэгэн зэрэг мөн удирдлагын тэнхим (админ API, тохиргоо, сувгийн холболт, зах зээл) ба мотороо асаах (хариу үүсгэдэг функц дуудалтын давталт). Тиймээс ердийн байрлуулалт нь зөвхөн тэр нэг үйлчилгээ ба PostgreSQL — ажиллуулах шаардлагатай тусдаа ажилтан давхарга байхгүй.

Нэг үйлчилгээ, хоёр үүрэг

Гүүрний порт нь дараах дээр сонсож байна нийтийн порт :8780 анхдагчаар, хянагддаг AIHUMMER_GATEWAY_ADDR — энэ порт нь бүх гадаад траффикийг авч явдаг (API, хослол, WS/SSE, орж ирэх вебхуук, апп/покет прокси ба эрүүл мэндийн шалгалтууд). Админ Web 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

Цикл нь оролт бүр хаанаас ирснийг тодорхойлдог учраас хариултууд нь ярианы түүх болон хэрэгслийн үр дүнгээс шийдэгддэг — зааварт итгэлгүй текстийг хийлгээгүйгээр. Энэ шинж чанар нь доорх prompt давхаргыг аюулгүй ба хурдан болгодог.

Давхаргатай, кэшийг дэмжсэн системийн сануулга

Системийн командыг нэг бүтцээр хийхгүй. Энэ нь давхаргуудаар угсрагдсан бөгөөд зориудаар дараалалласан байдаг, ингэснээр тогтвортой хэсгүүд хамгийн түрүүнд ирдэг ба тогтворгүй хэсгүүд эцэст ирдэг. Энэ нь чухал юм, учир нь загвар нийлүүлэгчид өгөгдөл дамжуулалтын эх хэсгийг кэшлэж хадгалдаг: эхний хэсэг нь нэг байтаар нэг ижил байвал кэшлэгдсэн эх хэсгийг дахин ашигладаг бөгөөд зөвхөн сүүл хэсгийг дахин боловсруулдаг.

Бүс	Давхаргууд (дарааллын дагуу)	Өөрчлөлтүүд…
Тогтвортой угтвар (кешлэх боломжтой)	суурь таних тэмдэг + багаж/санах ой хөтөч → түрээслэгч → persona → ур чадварууд	ховор — агент/түрээслэгч бүрт
Өөрчлөлт ихтэй сүүл (сүүлд хавсаргасан)	оны шилжин суух байдал → санах ойн чийгшүүлэх → амьд байдлын огноо	бүх эргэлт

Тогтвортой префикс нь агент хэн болохыг тодорхойлдог бүх зүйлийг агуулдаг: багтсан таних тэмдэг болон хэрэгсэл болон санах ойн ажиллах заавар, дараа нь түрээслэгчийн давхарга, агентын дүр төрх, ба гаргаж буй ур чадварын блок. Энэ бүгд нэг агентын хоёр дараалсан эргэлтийн хооронд өөрчлөгдөхгүй, тиймээс дахин ашиглах боломжтой кэшлэгдсэн префикс үүсгэдэг.

Өөрчлөгдөх сүүл нэмэгдсэн дараа тогтвортой өмнөх залгуур нь кэшийг хүчинтэй бус болгохгүйгээр яг таг: суулгах төлөв, энэ тодорхой ярианд зориулж дүүргэсэн ой санамж, одоогийн огноо бүгд ээлж ээлжээр өөрчлөгддөг боловч тэд төгсгөлд нь байрласнаар зөвхөн нэмсэн хэмжээгээр зардал гардаг.

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

Дараа хаашаа явах вэ

Түрээслэгчид хэрхэн тусгаарлагддагийг харна уу Олон хэрэглэгчийн орчин ба идемпотент байдал.
Хариултууд хэрхэн буцаан ирдэгийг сурах Найдвартай хүргэлт ба сэргэлт.
Сонголттой чадварууд нь ажилладаг хэлбэрээр Өөр дугуйтай сэлгэж явдаг тэрэг.