AiHummer
Română
Autentificare
v1.0.x
{ }Swagger

Orchestrare și sub-agenți

v1.0.x · actualizat 2026-07-07

Orchestratorul este ceea ce transformă un mesaj primit într-un răspuns. El asamblează un prompt de sistem stratificat și conduce o buclă de apelare de funcții: modelul gândește, apelează instrumente, citește rezultatele și repetă până produce un răspuns final. Peste această buclă, un agent poate genera sub-agenți și aplica strategii de raționament opționale — toate fiind configurabile de administrator.

Bucla de tur

Un tur este o buclă limitată de apelare de funcții. Modelului i se dă promptul de sistem, conversația și instrumentele disponibile; el poate apela unul sau mai multe instrumente, orchestratorul le execută și transmite rezultatele înapoi, iar bucla continuă până când modelul returnează un mesaj final. Instrumentele, memoria și cunoștințele ajung întotdeauna ca rezultate de instrument, niciodată ca instrucțiuni injectate — acesta este lucrul care menține bucla rezistentă la injecția de prompt.

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

Sub-agenți

Un agent poate genera sub-agenți pentru a gestiona o sub-sarcină și a returna un rezultat apelantului. Acest lucru permite unui agent coordonator să delege muncă focalizată — cercetare, redactare, o căutare specializată — fără a supraîncărca un singur context.

Recursivitatea este limitată: adâncimea maximă de imbricare este controlată de AIHUMMER_SUBAGENT_MAX_DEPTH. Acest lucru previne generarea necontrolată și menține costul și latența unui tur previzibile.

[!WARNING] Sub-agenții multiplică munca. Păstrează AIHUMMER_SUBAGENT_MAX_DEPTH conservator pe gazde partajate — fiecare nivel suplimentar de adâncime poate multiplica apelurile de instrument și utilizarea modelului.

Strategii de raționament

Dincolo de bucla simplă, orchestratorul oferă strategii de raționament opționale. Sunt dezactivate dacă nu sunt activate, iar fiecare este configurabilă din interfața de administrare sub grupul de setări „Agent · Reasoning”.

Strategy What it does
Plan-steps Agentul schițează un plan înainte de a acționa, apoi parcurge pașii.
Reflect Agentul își critică și revizuiește propria schiță înainte de a răspunde.
Debate N agenți argumentează de-a lungul unui număr de runde, apoi un judecător alege câștigătorul.
Best-of-N Generează mai multe răspunsuri candidate și îl selectează pe cel mai bun.
Self-heal La un eșec, agentul diagnostichează și reîncearcă în loc să renunțe.

[!TIP] Strategiile de raționament schimbă latența și costul în tokeni pentru calitate. Activează-le selectiv pentru agenții și sarcinile care au nevoie de ele, mai degrabă decât global.

Grafuri de agenți

Pentru fluxuri de lucru multi-agent care sunt mai structurate decât apelurile ad-hoc de sub-agenți, AiHummer suportă grafuri de agenți — cablarea explicită a agenților într-un flux de lucru. Grafurile sunt gestionate din interfața de administrare și din API-ul de administrare sub /v1/admin/graphs/*.

Pagina „Grafuri” din interfața de administrare este un editor vizual de flowchart: nodurile grafului se trag pe pânză, legăturile dintre ele se desenează cu săgeți, paleta adaugă noduri noi, iar panoul lateral editează parametrii nodului selectat. Definiția grafului (nodul de start, limita de pași, nodurile și tranzițiile) este stocată ca JSON — comutatorul „Export/Import JSON” o deschide pentru vizualizare, transfer între instanțe și editare manuală.

Rezumat de configurare

Knob Where
Adâncime maximă de sub-agenți AIHUMMER_SUBAGENT_MAX_DEPTH (env; reîncărcabil la cald)
Strategii de raționament Grupul de setări „Agent · Reasoning”
Grafuri de agenți /v1/admin/graphs/*

[!NOTE] Adâncimea sub-agenților și activarea instrumentelor se numără printre setările care se aplică la cald (fără restart). Alte setări pot necesita un restart — vezi modelul de configurare în ghidul de început.

Unde mergi mai departe