Aggiungi un nodo classify a un flusso di lavoro (GitHub Copilot)

Note

Le funzionalità di questo articolo sono utilizzate da agenti o flussi di lavoro alimentati dall'harness GitHub Copilot.

La fatturazione basata sull'uso si applica all'utilizzo, alla costruzione, al test e alla valutazione degli agenti. Queste azioni potrebbero consumare crediti Copilot. Scopri di più in Gestire i costi per agenti alimentati dal GitHub Copilot harness.

Il nodo classifica prende un pezzo di testo e lo ordina in una delle categorie che definisci. Descrivi ogni categoria in modo chiaro, e il nodo usa l'IA per decidere quale categoria corrisponde meglio l'input. Ogni categoria diventa un proprio ramo, quindi il flusso di lavoro può adottare un'azione diversa a seconda del risultato.

Usa il nodo di classificazione ogni volta che un passaggio deve instradare il flusso di lavoro in base al significato di testo libero—il corpo di un’email, l’invio di un modulo, un messaggio di supporto—piuttosto che in base a un campo fisso o a una corrispondenza con parole chiave. Un uso comune è il triaggio delle email: leggi ogni messaggio in arrivo e invialo su un percorso diverso a seconda di cosa si tratta.

Utilizzando il nodo classify, puoi:

• Ordina un input di testo in una delle diverse categorie che descrivi in linguaggio naturale.
• Dirama il flusso di lavoro in modo che ogni categoria esegue un diverso insieme di passaggi.
• Individua tutto ciò che non corrisponde a una categoria Default automatica.
• Migliora l'accuratezza fornendo esempi di input per ogni categoria.

Aggiungi un nodo classificazione

1. In Copilot Studio passare a Flows e aprire un flusso di lavoro esistente oppure crearne uno nuovo.

   • Nuovo flusso di lavoro: si accede all'editor di progettazione per configurare un trigger.
   • Flusso di lavoro esistente: aprire il flusso di lavoro e passare alla scheda Compila .

2. Seleziona l'icona Classifica nel pannello Aggiungi.

3. Il pannello di configurazione si apre per il nodo classificazione.

Il nodo sulla tela mostra un punto di connessione per categoria, più un altro ramo (Default). Collega ogni ramo ai passaggi che dovrebbero essere eseguiti per quella categoria.

Fornire l'input per classificare

Nel campo Input to classify, inserisci il testo che vuoi che il nodo categorizzi. Usa il selettore dinamico di contenuti per inserire una variabile stringa da un passaggio precedente, così il nodo classifica i dati reali di runtime.

Ad esempio, in un flusso di lavoro che si attiva quando arriva una nuova email, imposta l'input sulla variabile Corpo dal trigger così che ogni esecuzione classifichi il contenuto effettivo dell'email.

L'input è destinato a testo libero. Se hai diversi valori che vuoi considerare insieme (ad esempio, l'oggetto e il corpo dell'email), usa il selettore dinamico di contenuti per combinarli nel campo.

Scegliere il modello

Usa il menu a tendina del modello nel campo Input per classificare e selezionare il modello che alimenterà la classificazione. Tieni presente che c'è un compromesso tra potenza e velocità per i modelli:

• Seleziona un modello più capace quando le categorie sono sfumate o facili da confondere, oppure quando l'input è lungo e necessita di un'attenta interpretazione. In questo caso, il modello ha bisogno di più tempo per essere elaborato.
• Seleziona un modello più veloce quando le categorie sono chiaramente distinte e il flusso di lavoro funziona ad alto volume.

Definisci le tue categorie

Nella sezione Categorie, aggiungi una voce per ogni esito a cui vuoi indirizzare. Per ogni categoria:

1. Dai alla categoria un nome breve e descrittivo. Il nome diventa l'etichetta sul ramo che lascia il nodo, quindi rendilo qualcosa che riconosci sulla tela (ad esempio, Product issue oppure Account update).

2. Nella casella Descrivi cosa appartiene a questa categoria , spiega in modo semplice che tipo di input appartiene qui. Descrizioni chiare sono il fattore più importante per una classificazione accurata.

Seleziona Aggiungi categoria per crearne di più. Punta a categorie chiaramente distinte tra loro e che insieme coprano gli input che ti aspetti.

La categoria predefinita

Una categoria predefinita viene creata automaticamente per input che non corrispondono chiaramente a nessuna categoria che hai definito. Viene visualizzato come il ramo Altro sul nodo. Collega questa categoria a un fallback adeguato, in modo che nulla venga ignorato silenziosamente. Ad esempio, indirizza l'oggetto per la revisione manuale, registralo o avvisa qualcuno.

Aggiungi esempi per migliorare la precisione (opzionale)

Sotto Esempi, puoi fornire input campione e la categoria a cui appartiene ciascuno. Gli esempi insegnano al nodo come gestire i casi borderline e il tipo di linguaggio che usano i tuoi veri input.

Per aggiungere un esempio:

1. Seleziona Aggiungi esempio.

2. In Seleziona categoria, scegli la categoria a cui appartiene l'esempio.

3. Nella casella di testo, incolla o digita un input rappresentativo per quella categoria.

Aggiungi esempi per le categorie che si confondono più spesso, e soprattutto per i casi limite in cui la risposta giusta non è ovvia solo dalla descrizione. Pochi esempi ben scelti per categoria ambigua di solito fanno più di una lunga lista.

Dirama il flusso di lavoro in base al risultato

Ogni categoria, inclusa Other, è un ramo di output separato sul nodo. Dopo che il nodo ha classificato un input, il flusso di lavoro continua lungo il ramo per la categoria corrispondente. Aggiungi i passaggi che vuoi per ogni ramo:

• Invia l'oggetto a un altro agente, casella postale o coda a seconda della categoria.
• Esegui un'azione terminale su un ramo (ad esempio, cancella o archivia) mentre instradasci altri per il seguito.
• Imposta una colonna o un valore di stato, poi continua con i passaggi condivisi a valle.

Solo il ramo corrispondente viene eseguito per un dato input, quindi ogni percorso può essere adattato esattamente a ciò di cui quella categoria ha bisogno.

Scenari di automazione

Il nodo classify funziona meglio come passaggio di instradamento: arriva testo libero, il nodo decide di cosa si tratta e ogni branch gestisce quel caso.

Triaggio delle email

Un flusso di lavoro si attiva quando arriva una nuova email. Il nodo classify prende il Corpo dell'email come input e lo ordina in Product issue, How-to question, Account update, Spam, o Altro. Ogni ramo instrada il messaggio nel posto giusto:

• Problema di prodotto: un Issue Triager Agent che presenta e dà priorità a un ticket.
• Domanda su come fare: un Docs Responder Agent che redige una risposta dalla base di conoscenza.
• Aggiornamento account: un Account Updater Agent che applica la modifica.
• Spam: un'azione Elimina email che rimuove il messaggio.
• Altro: un'opzione di fallback che instrada l'e-mail per la revisione manuale.

Una sola casella di posta, un solo flusso di lavoro, e ogni messaggio finisce dove dovrebbe, senza che nessuno li legga e ordini.

Instradare le richieste di supporto in arrivo

Un flusso di lavoro si attiva quando una richiesta viene inviata tramite un modulo o una cassetta condivisa. Il nodo classify legge il testo della richiesta e lo ordina in Billing, Technical, oppure Sales. Ogni ramo assegna la richiesta alla coda della squadra corrispondente e notifica quella squadra, così le richieste arrivano alle persone giuste senza un passaggio di triage intermedio.

Dai priorità al feedback

Un flusso di lavoro si attiva quando un cliente invia un feedback. Il nodo classifica ordina il commento in Bug report, Feature request, o Praise. Le segnalazioni di bug aprono un elemento di lavoro, le richieste di funzionalità vengono aggiunte al backlog e i complimenti vengono inoltrati al team responsabile dell’account. Questa ramificazione trasforma un singolo canale di feedback in tre follow-up personalizzati.

Domande frequenti

Quando dovrei usare il nodo classificazione rispetto a un nodo agente?

Usa il nodo classify quando l'unico compito è ordinare il testo in una delle categorie note e fare un branch sul risultato. Il nodo classificazione è progettato appositamente per il lavoro, più semplice da configurare e facile da leggere sulla tela.

Usa un nodo agente quando il passaggio deve fare più che categorizzare: ragionare su più input, chiamare strumenti, prelevare dalla conoscenza o restituire campi strutturati. Un agente può classificare e agire in un unico passaggio, a costo di una configurazione maggiore.

Cosa succede se un input non corrisponde a nessuna categoria?

L'input va alla categoria automatica Predefinita, visualizzata come ramo Altro. Collega sempre quel ramo a un percorso di fallback, in modo da gestire gli input che non trovano corrispondenza.

Come posso rendere la classificazione più accurata?

Scrivi descrizioni chiare e distinte delle categorie che specifichino cosa appartiene e cosa no. Aggiungi esempi per le categorie che si confondono. Scegli un modello più capace quando le categorie sono sottili. Categorie distinte con descrizioni nette contano più del numero di categorie.

Contenuti correlati

• Aggiungere un nodo agente a un flusso di lavoro
• Aggiungi un nodo Copilot a un flusso di lavoro
• Modificare e gestire il flusso di lavoro nella finestra di progettazione
• Panoramica dei flussi di lavoro