Router: invia le richieste allo specialista giusto

Il router classifica l'intento e sceglie un ramo specializzato.

Cosa imparerai

  • Spiegare: un flusso di lavoro ha una struttura esplicita
  • Applica l'idea in un esempio: Router: invia richieste allo specialista giusto
  • Riconoscere i limiti e verificare il risultato dell'esercizio

Il router classifica l'intento e sceglie un ramo specializzato. Si adatta a categorie distinte in cui un ramo può risolvere la richiesta.

Questi passaggi si riferiscono alle funzionalità identificate nel codice dell'applicazione. Questo materiale non è stato convalidato su un'istanza live; controlla la documentazione e le opzioni nella tua versione.

Come funziona, passo dopo passo

Un flusso di lavoro ha una struttura esplicita

Un nodo è una fase, un bordo è una transizione e lo stato trasporta i risultati tra le fasi. Un flusso di lavoro ha un percorso definito dall'applicazione, sebbene il modello possa scegliere alcuni rami. I sistemi ad agenti includono sia flussi di lavoro che agenti che agiscono dinamicamente. Nymrio offre ReAct, Reflection, Sequential, Orchestrator, Router, Parallel e Plan-and-Execute. Ciascuno cambia coordinazione; non rende automaticamente un modello un esperto. Più agenti significano più chiamate e contratti tra i ruoli. Inizia con la soluzione più semplice che supera i tuoi test.

Un'istruzione è un contratto

Un buon prompt specifica l'attività, i dati disponibili, il formato di output e i criteri di successo. Separare il ruolo dai dati e includere un esempio per i casi ambigui. “Sii preciso” è più debole di “indicare solo la scadenza nella polizza fornita; se manca, chiedere chiarimenti”. Pochi scatti significa pochi esempi risolti, non un elenco infinito. Il contenuto del documento rimane dati anche quando contiene comandi. I delimitatori aiutano, ma il software deve applicare autorizzazioni e convalida anziché fare affidamento sul prompt.

Definire il successo prima di ottimizzare

Preparare richieste rappresentative e risposte o proprietà previste. Includere casi ordinari, ambiguità, dati mancanti ed errori dello strumento. Per RAG, misurare il recupero delle prove separatamente dalla correttezza della risposta. Recall@k misura la quota di prove rilevanti trovate nei primi k risultati; Precision@k misura la quota di risultati restituiti che sono rilevanti. Per gli agenti, monitora anche azioni, autorizzazioni e arresti. Un LLM come giudice può accelerare la valutazione ma necessita di una calibrazione rispetto agli esseri umani. Non modificare prompt, modello e indice contemporaneamente se vuoi capire quali risultati migliorati.

Laboratorio dettagliato

Classificazione prima della delega

Istruzioni illustrative del router: "Consegna per spedizione; prodotto per caratteristiche e compatibilità; resi per politica di restituzione. Se più intenti non possono essere risolti in un unico ramo, chiedere chiarimenti. " I lavoratori utilizzano prompt e fonti specializzate.

Prova la parafrasi: “Dov’è il mio pacco?” e "Il mio pacco non è arrivato" dovrebbero esprimere lo stesso intento. Testare anche una richiesta scoperta: “Ho bisogno di fattura”. Non scegliere automaticamente il primo ramo. Nell'implementazione locale il lavoratore selezionato risponde e l'esecuzione termina; non presupporre un ritorno al router come in Orchestrator.

Lo schema esplicativo

Router: invia le richieste allo specialista giusto Seguire le frecce continue per il flusso principale. Le frecce blu tratteggiate forniscono dati o contesto; le frecce rosa tratteggiate mostrano feedback o risultati restituiti. Colori e forme distinguono modelli, negozi, decisioni e risultati. Il routing seleziona uno specialista; i tre rami sono alternativi, non lavoratori simultanei. Connessioni: Richiesta dell'utente → Router: classificare l'intento; Router: classificare l'intento → Seleziona un percorso; Specialista del catalogo → Risposta finale; Specialista in politica → Risposta finale; Specialista tecnico → Risposta finale; Istruzioni e contesto → Router: classificare l'intento; Stato di esecuzione condiviso → Router: classificare l'intento; Seleziona un percorso → Specialista del catalogo (Catalogare); Seleziona un percorso → Specialista in politica (Politica); Seleziona un percorso → Specialista tecnico (Tecnica); Conoscenza RAG → Specialista del catalogo; Conoscenza RAG → Specialista in politica; Servizio MCP → Specialista tecnico. W06 · Mappa delle relazioni Router: invia le richieste allo specialista giusto Ingresso Richiesta dell'utente Dati Istruzioni e contesto Memorizza/indicizza Stato di esecuzione condiviso Modello/agente AI Router: classificare l'intento Decisione/controllo Seleziona un percorso Modello/agente AI Specialista del catalogo Modello/agente AI Specialista in politica Modello/agente AI Specialista tecnico Memorizza/indicizza Conoscenza RAG Produzione Risposta finale Strumento/servizio Servizio MCP Catalogare Politica Tecnica Flusso principale Dati e contesto Feedback e reso

Seguire le frecce continue per il flusso principale. Le frecce blu tratteggiate forniscono dati o contesto; le frecce rosa tratteggiate mostrano feedback o risultati restituiti. Colori e forme distinguono modelli, negozi, decisioni e risultati. Il routing seleziona uno specialista; i tre rami sono alternativi, non lavoratori simultanei. Su schermi piccoli, scorri in orizzontale per seguire l’intero schema.

Un esempio completo

"Dov'è il mio pacco?" va alla consegna; "Come installo la parte?" va al supporto tecnico. “Voglio un ritorno e una nuova parte” necessita di chiarimenti o di un’architettura di coordinamento.

router: LunaDispatcher
route_1: DeliverySpecialist
route_2: TechnicalSpecialist

Provalo tu stesso

  1. Prepara dieci richieste e giustifica ogni percorso selezionato.
  2. Registrare l'input, la fonte e il risultato atteso prima di eseguire l'esperimento. Utilizzare solo i dati fittizi nell'esempio.
  3. Seguire le fasi del diagramma. Ad ogni passaggio registrare quali informazioni vengono ricevute e prodotte; non confondere il risultato intermedio con il risultato finale.
  4. Ripetere dopo aver rimosso le informazioni necessarie o reso ambiguo l'input. Controlla se il sistema chiarisce, ferma o inventa una risposta.
  5. Confrontare con la soluzione spiegata. Conserva la configurazione, la data, il risultato e una spiegazione delle differenze. Cambia una cosa e riprova.

Una soluzione spiegata

Il percorso corrisponde all'intento; richieste ambigue non vengono imposte a uno specialista inadatto. Un esercizio riuscito ti consente di mostrare la connessione tra input, fasi e risultato. Quando mancano le informazioni, una risposta cauta è più utile dei dettagli inventati. Confrontare non solo stile: verificare anche condizioni, fonti e operazioni.

Quando è utile e quali sono i suoi limiti

La convalida dell'interfaccia utente locale e dell'API differisce in base alla denominazione del router/supervisore; se il salvataggio viene rifiutato, utilizzare l'esercizio concettuale e segnalare il problema. Scegli questo approccio quando migliora un bisogno misurato. Mantieni una linea di base semplice e confronta i risultati utilizzando input identici. Un esempio di successo non stabilisce l’affidabilità in ogni situazione.

Verifica ciò che hai imparato

Multi-agente è un ottavo modello?

No. È una categoria architettonica che può utilizzare diversi modelli esistenti.

Un prompt può sostituire il controllo degli accessi?

No. Un'istruzione non costituisce un limite di autorizzazione.

Quale risultato dovrebbe produrre questo esercizio?

Il percorso corrisponde all'intento; richieste ambigue non vengono imposte a uno specialista inadatto.

Termini da ricordare

  • Cenno: Una fase in un grafico di esecuzione.
  • Pochi colpi: Esempi risolti forniti nel contesto.
  • Regresia/Regressione: una modifica che interrompe un caso precedentemente corretto.

Fonti e il prossimo passo

Per preparare: W05 — Orchestratore: coordinatore e specialisti