Router: cererea merge la specialistul potrivit
Router clasifică intenția și alege o ramură specializată.
Ce vei învăța
- Explici: un workflow are structură explicită
- Aplici ideea într-un exemplu: Router: cererea merge la specialistul potrivit
- Recunoști limitele și verifici rezultatul exercițiului
Router clasifică intenția și alege o ramură specializată. Este potrivit când categoriile sunt distincte și o singură ramură poate rezolva cererea.
Pașii se referă la funcționalități identificate în codul aplicației. Validarea pe o instanță live nu a fost efectuată pentru acest material; verifică documentația și opțiunile din versiunea ta.
Cum funcționează, pas cu pas
Un workflow are structură explicită
Nodul este o etapă, muchia este o trecere, iar starea transportă rezultatele între etape. Într-un workflow traseul este definit de aplicație, deși modelul poate decide unele ramuri. Sistemele agentice includ atât workflows cât și agenți cu decizii dinamice. În Nymrio există ReAct, Reflection, Sequential, Orchestrator, Router, Parallel și Plan-and-Execute. Fiecare schimbă coordonarea, nu transformă automat modelul într-un expert. Mai mulți agenți înseamnă mai multe apeluri și contracte între roluri. Începe cu soluția cea mai simplă care trece testele tale.
Instrucțiunea este un contract
Un prompt bun spune ce trebuie făcut, cu ce date, în ce format și cum recunoști succesul. Separă rolul de date și include un exemplu pentru cazurile ambigue. „Fii precis” este mai slab decât „menționează doar termenul din politica furnizată; dacă lipsește, cere clarificare”. Few-shot înseamnă câteva exemple rezolvate, nu o listă fără sfârșit. Conținutul unui document rămâne date chiar dacă include imperative. Delimitarea ajută, dar permisiunile și validarea trebuie aplicate de software, nu doar cerute prin prompt.
Definește succesul înainte de optimizare
Pregătește un set de cereri reprezentative și răspunsuri sau proprietăți așteptate. Include cazuri obișnuite, ambigue, fără date și cu erori de unelte. Pentru RAG măsoară separat găsirea dovezii și corectitudinea răspunsului. Recall@k urmărește proporția dovezilor relevante găsite în primele k rezultate; precision@k urmărește proporția rezultatelor relevante. Pentru agenți urmărește și acțiunile, accesul și oprirea. Un LLM-as-judge poate accelera evaluarea, dar se calibrează față de oameni. Nu modifica simultan promptul, modelul și indexul dacă vrei să înțelegi cauza îmbunătățirii.
Laborator detaliat
Clasificarea înainte de delegare
Prompt orientativ pentru router: „livrare pentru transport și expediere; produs pentru caracteristici și compatibilitate; retur pentru politica de returnare. Când cererea are mai multe intenții care nu pot fi rezolvate într-o ramură, cere clarificare”. Workers au prompturi și surse specializate.
Testează parafraze: „Unde este coletul?” și „Nu mi-a ajuns pachetul” trebuie să urmărească aceeași intenție. Testează și cazul absent: „Vreau o factură”. Nu trimite automat la prima ramură. În implementarea locală worker-ul selectat produce răspunsul și execuția se încheie; nu presupune revenire la router ca într-un Orchestrator.
Harta vizuală
Urmărește săgețile continue pentru fluxul principal. Săgețile albastre punctate furnizează date sau context; cele roz punctate arată feedback sau rezultate care revin. Culorile și formele disting modelele, stocările, deciziile și rezultatele. Rutarea selectează un specialist; cele trei ramuri sunt alternative, nu lucrează simultan. Pe ecrane mici, derulează orizontal pentru a urmări întreaga diagramă.
Un exemplu complet
„Unde este coletul?” merge la livrare, „Cum montez piesa?” la suport tehnic. „Vreau retur și o piesă nouă” necesită clarificare sau o arhitectură care poate coordona ambele.
router: LunaDispatcher
route_1: DeliverySpecialist
route_2: TechnicalSpecialist
Încearcă tu
- Pregătește zece cereri și justifică ruta aleasă pentru fiecare.
- Notează intrarea, sursa și rezultatul așteptat înainte să rulezi experimentul. Folosește doar datele fictive din exemplu.
- Urmărește etapele din diagramă. La fiecare pas scrie ce informație primește și ce produce; nu confunda rezultatul intermediar cu rezultatul final.
- Repetă cazul după eliminarea unei informații necesare sau după o intrare ambiguă. Verifică dacă sistemul cere clarificare, se oprește sau inventează.
- Compară cu soluția comentată. Păstrează configurația, data, rezultatul și o explicație pentru orice diferență. Schimbă un singur lucru și retestează.
Soluție comentată
Ruta reflectă intenția; o cerere ambiguă nu este trimisă forțat la un specialist nepotrivit. Pentru a considera exercițiul reușit, poți arăta legătura dintre intrare, etapele parcurse și rezultat. Dacă lipsesc date, un răspuns prudent este mai util decât o completare inventată. Nu compara doar stilul: verifică și condițiile, sursele și operațiile efectuate.
Când merită și ce poate merge prost
Configurația locală are o diferență router/supervisor între UI și validarea API; dacă salvarea este refuzată, urmează exercițiul conceptual și raportează problema. Alege această abordare când îmbunătățește o nevoie măsurată. Păstrează o variantă simplă ca referință și compară rezultatele pe aceleași intrări. Un singur exemplu reușit nu stabilește fiabilitatea în toate situațiile.
Verifică ce ai înțeles
Multi-agent este un al optulea template?
Nu. Este o categorie de arhitecturi care poate folosi mai multe dintre template-urile existente.
Un prompt poate înlocui controlul accesului?
Nu. O instrucțiune nu este o barieră de autorizare.
Ce rezultat trebuie să obții în acest exercițiu?
Ruta reflectă intenția; o cerere ambiguă nu este trimisă forțat la un specialist nepotrivit.
Cuvinte de ținut minte
- Nod: Etapă din graful unei execuții.
- Few-shot: Exemple rezolvate oferite în context.
- Regresie / Regression: O schimbare care strică un caz anterior corect.
Surse și următorul pas
Pentru pregătire: W05 — Orchestrator: coordonator și specialiști