Orkestratsiya va sub-agentlar — AiHummer Hujjatlar

Orkestrator — bu kirayotgan xabarni javobga aylantiradigan narsa. U qatlamli tizim promptini yigʻadi va funksiya-chaqirish tsiklini boshqaradi: model oʻylaydi, vositalarni chaqiradi, natijalarni oʻqiydi va yakuniy javob hosil qilguncha takrorlaydi. Bu tsiklning ustida agent sub-agentlar paydo qilishi va ixtiyoriy fikrlash strategiyalarini qoʻllashi mumkin — bularning barchasi admin tomonidan sozlanadi.

Nubat tsikli

Nubat — bu chegaralangan funksiya-chaqirish tsikli. Modelga tizim prompti, suhbat va mavjud vositalar beriladi; u bir yoki bir nechta vositani chaqirishi mumkin, orkestrator ularni bajaradi va natijalarni qaytaradi, tsikl esa model yakuniy xabarni qaytarguncha davom etadi. Vositalar, xotira va bilim doimo vosita natijalari sifatida keladi, hech qachon kiritilgan koʻrsatmalar sifatida emas — aynan shu tsiklni prompt-inyeksiyaga chidamli saqlaydi.

prompt + tools ─▶ model ─▶ tool calls ─▶ results ─▶ model ─▶ ... ─▶ final reply

Sub-agentlar

Agent kichik vazifani bajarish va natijani chaqiruvchiga qaytarish uchun sub-agentlar paydo qilishi mumkin. Bu muvofiqlashtiruvchi agentga aniq ishni — tadqiqot, qoralama tayyorlash, maxsus qidiruv — bitta kontekstni ortiqcha yuklamasdan topshirish imkonini beradi.

Rekursiya chegaralangan: maksimal joylashish chuqurligi AIHUMMER_SUBAGENT_MAX_DEPTH orqali boshqariladi. Bu nazoratsiz paydo boʻlishni oldini oladi va nubatning narxi hamda kechikishini bashorat qilinadigan saqlaydi.

[!WARNING] Sub-agentlar ishni koʻpaytiradi. Umumiy xostlarda AIHUMMER_SUBAGENT_MAX_DEPTHni ehtiyotkor saqlang — har bir qoʻshimcha chuqurlik darajasi vosita chaqiruvlari va model ishlatilishini koʻpaytirishi mumkin.

Fikrlash strategiyalari

Oddiy tsikldan tashqari, orkestrator ixtiyoriy fikrlash strategiyalarini taklif qiladi. Ular yoqilmaguncha oʻchiq, har biri esa admin UI ostida “Agent · Reasoning” sozlamalar guruhidan sozlanadi.

Strategiya	Nima qiladi
Reja-bosqichlar	Agent harakat qilishdan oldin reja tuzadi, soʻngra bosqichlarni bajaradi.
Refleksiya	Agent javob berishdan oldin oʻz qoralamasini tanqid qiladi va qayta koʻrib chiqadi.
Bahs	`N` ta agent bir necha raund boʻylab bahslashadi, soʻngra hakam gʻolibni tanlaydi.
Eng-yaxshi-N	Bir nechta nomzod javoblarni hosil qiladi va eng yaxshisini tanlaydi.
Oʻzini-davolash	Xatolik yuz berganda agent taslim boʻlish oʻrniga tashxis qoʻyadi va qayta urinadi.

[!TIP] Fikrlash strategiyalari kechikish va token narxini sifatga almashtiradi. Ularni global tarzda emas, balki ularga muhtoj boʻlgan agentlar va vazifalar uchun tanlab yoqing.

Agent grafikalari

Maxsus sub-agent chaqiruvlaridan koʻra tarkibiyroq koʻp-agentli ish jarayonlari uchun AiHummer agent grafikalarini qoʻllab-quvvatlaydi — agentlarni ish jarayoniga aniq ulash. Grafikalar admin UI va /v1/admin/graphs/* ostidagi admin API orqali boshqariladi.

Admin UI’dagi «Grafikalar» sahifasi — vizual flowchart-muharrir: graf tugunlari xolst boʻylab sudrab koʻchiriladi, ular orasidagi bogʻlanishlar strelkalar bilan chiziladi, palitra yangi tugunlar qoʻshadi, yon panel esa tanlangan tugun parametrlarini tahrirlaydi. Graf taʼrifi (boshlangʻich tugun, qadamlar limiti, tugunlar va oʻtishlar) JSON sifatida saqlanadi — «JSON eksport/import» oʻtkazgichi uni koʻrish, instanslar orasida koʻchirish va qoʻlda tahrirlash uchun ochadi.

Konfiguratsiya xulosasi

Sozlagich	Qayerda
Sub-agent maksimal chuqurligi	`AIHUMMER_SUBAGENT_MAX_DEPTH` (env; qaynoq qayta yuklanadigan)
Fikrlash strategiyalari	Sozlamalar guruhi “Agent · Reasoning”
Agent grafikalari	`/v1/admin/graphs/*`

[!NOTE] Sub-agent chuqurligi va vositani yoqish qaynoq (qayta ishga tushirishsiz) qoʻllaniladigan sozlamalar qatorida. Boshqa sozlamalar qayta ishga tushirishni talab qilishi mumkin — getting-started qoʻllanmasidagi konfiguratsiya modeliga qarang.

Keyin qayerga

Tsikl nimalarni chaqira olishini Vositalar sahifasida koʻring.
Xabar oʻzining boshlangʻich agentini qanday tanlashini Marshrutlash sahifasida oʻrganing.
Agentlarning oʻzini Agentlar va personalar sahifasida sozlang.