Usa la traccia di attività per debug del tuo agente

La traccia di attività negli agenti alimentata dal harness GitHub Copilot in Microsoft Copilot Studio ti mostra esattamente come il tuo agente elabora ogni messaggio. Usala per comprendere il ragionamento CoT del tuo agente, verificare l'attribuzione della fonte delle informazioni, confermare l'esecuzione degli strumenti e risolvere errori.

Note

Le funzionalità di questo articolo sono alimentate dal harness GitHub Copilot, che utilizza Copilot Credits per la fatturazione basata sull'uso. Scopri di più sui Crediti Copilot in Panoramica della fatturazione per agenti alimentati dal GitHub Copilot harness.

La fatturazione basata sull'uso si applica all'utilizzo, alla costruzione, al test e alla valutazione degli agenti. Queste azioni potrebbero consumare crediti Copilot.

Prerequisiti

  • Un agente creato con il GitHub Copilot harness
  • Almeno una conversazione di test nella scheda Anteprima

Apri la traccia delle attività

  1. Apri il tuo agente in Copilot Studio e seleziona la scheda Anteprima.

  2. Assicurati che l'interruttore Anteprima utente finale sia disattivato (la vista degli autori predefinita). La traccia delle attività viene visualizzata accanto al riquadro della chat, mostrando i dettagli di elaborazione per ogni messaggio.

  3. Invia un messaggio al tuo agente. La traccia si aggiorna in tempo reale mentre l'agente elabora il messaggio.

Comprendere la traccia

La traccia delle attività mostra una visione CoT (Chain-of-Thought) dell'elaborazione del tuo agente. Ogni passaggio della traccia appare come un nodo che mostra cosa ha fatto l'agente e perché.

Tipi di nodo

La traccia può includere i seguenti tipi di nodo:

Tipo di nodo Cosa mostra
Messaggio utente Il messaggio che hai inviato all'agente
Risposta agente La risposta generata dall'agente
Informazioni Una fonte delle informazioni che l'agente ha consultato per il grounding. Visualizzata come una scheda pieghevole "Informazioni in cui è stata eseguita la ricerca" che mostra le fonti per ogni fonte delle informazioni accessibile e i collegamenti alle citazioni quando disponibili.
Azione eseguita Un'invocazione di un connettore o di uno strumento resa come una scheda espandibile che mostra il connettore, i parametri di input compilati e la durata dell'esecuzione.
Tool Uno strumento che l'agente ha invocato per eseguire un'azione o recuperare dati
Connettore Un connettore che l'agente ha utilizzato per accedere ai dati esterni
Flusso Un flusso dell'agente che è stato attivato
Competenza Una competenza che è stata eseguita
Error Un errore che si è verificato durante l'elaborazione
Completo Un segno di spunta verde appare in fondo alla traccia quando tutte le chiamate agli strumenti sono completate.

Visualizzare i dettagli del nodo

  1. Seleziona un nodo qualsiasi nella traccia per visualizzare i dettagli.

  2. Esamina le informazioni mostrate, che possono includere:

    • L'input inviato dall'agente al passaggio
    • L'output o il risultato restituito
    • Tempi di elaborazione e metriche
    • Dettagli errore se il passaggio non è riuscito

Problemi con la fonte delle informazioni del debug

Quando il tuo agente utilizza fonti delle informazioni per rispondere a una domanda, la traccia mostra quali fonti sono state consultate:

  1. Trova il nodo Conoscenza nella traccia.

  2. Rivedi la fonte per vedere quali fonti delle informazioni sono state consultate.

  3. Seleziona una fonte per visualizzare il contenuto specifico recuperato.

  4. Verifica che l'agente abbia utilizzato la fonte corretta e che il contenuto recuperato sia rilevante.

Se l'agente ha utilizzato la fonte errata o ha restituito informazioni imprecise, verifica la configurazione delle fonti delle informazioni nella scheda Creazione.

Esecuzione dello strumento di debug

Quando il tuo agente invoca uno strumento, la traccia mostra i dettagli dell'esecuzione:

  1. Trova il nodo Strumento, Connettore, Flusso o Competenza nella traccia.

  2. Rivedi i dettagli dell'esecuzione, inclusi i parametri di input e i risultati di output.

  3. Verifica che sia stato invocato lo strumento corretto e che i risultati siano come atteso.

  4. Se un'esecuzione dello strumento è fallita, rivedi i dettagli dell'errore nel nodo.

Per riconfigurare uno strumento, apri la scheda Creazione e individua lo strumento nella configurazione del tuo agente.

Risolvere gli errori

Quando si verificano errori durante l'elaborazione, la traccia li evidenzia:

  1. Cerca nodi contrassegnati con un indicatore di errore nella traccia.

  2. Seleziona il nodo di errore per visualizzare i dettagli dell'errore, inclusi il messaggio di errore e il contesto.

  3. I problemi comuni includono:

    • Errori di autenticazione per strumenti o connettori
    • Errori di accesso alla fonte delle informazioni
    • Errori di timeout per chiamate di strumenti di lunga durata
    • Flag di moderazione del contenuto

  4. Affronta la causa principale nella scheda Creazione o nelle Impostazioni, quindi ripeti il test.

La traccia attività si integra con la scheda Creazione per una modifica rapida.

  1. Seleziona qualsiasi sorgente, strumento o componente nella traccia.

  2. Copilot Studio passa al componente corrispondente nella scheda Creazione.

  3. Apporta le modifiche e torna nella scheda Anteprima per ripetere il test.

  • Last updated on