Esaminare l'attività dell'agente

La creazione di un agente è un processo iterativo. Implica comprendere il funzionamento degli agenti, apportare modifiche e visualizzare i risultati. Questo processo consente di creare agenti migliori. Il rilevamento delle attività di Copilot Studio fornisce un mapping visivo della sequenza di input, decisioni e output degli agenti all'interno di un'attività, in modo da individuare problemi e opportunità di miglioramento.

Viene generata una mappa attività per ogni attività. Un'attività inizia quando un agente avvia una conversazione o un evento esterno attiva un agente. Una mappa rappresenta ogni attività con un nodo.

Esistono due forme di rilevamento delle attività:

• Mappa dell'attività in tempo reale delle prestazioni del tuo agente durante i test
• Mappe e trascrizioni delle attività cronologiche delle attività precedenti

Mappa dell'attività in tempo reale durante i test

Quando si pone all'agente una domanda nel riquadro di test, la mappa attività mostra una rappresentazione visiva del piano generato dall'agente. La mappa evidenzia gli errori, ad esempio parametri di input o output mancanti o non validi per le azioni e mostra il tempo necessario per l'esecuzione di ogni passaggio. Puoi anche verificare che le informazioni che il tuo agente invia o riceve siano corrette.

Per far apparire automaticamente la mappa di attività quando invii una query al tuo agente nel pannello di test, seleziona i tre punti (...) e poi attiva Mostra mappa di attività durante il test.

Qui, l'utente ha chiesto: "Che tempo farà a Toronto, Canada domani?" Puoi vedere l'azione che l'agente ha selezionato per rispondere e gli input e gli output.

Attivatori di eventi di test

Quando si testano i trigger dell'evento, la chat di test mostra il payload del trigger come messaggio. Solo questo messaggio può essere visualizzato all'interno di Copilot Studio a scopo di test. Gli utenti del tuo agente non possono visualizzarlo. Usare i messaggi di payload per comprendere quando e quali informazioni e istruzioni invia un trigger all'agente.

Tieni traccia tra argomenti

Quando testi l'agente, puoi tenere traccia tra gli argomenti. Quando si abilita il rilevamento, la mappa dell'attività mostra i nodi all'interno dell'argomento mentre vengono eseguiti nel momento in cui un argomento si attiva come parte di un piano. È possibile monitorare il flusso della conversazione.

Visualizza le variabili

Nella pagina Attività è possibile visualizzare le variabili usate dall'agente durante i test o nelle attività cronologiche. Queste variabili possono essere variabili globali, di ambiente o di sistema a cui l'agente ha accesso.

Per visualizzare le variabili usate durante un'attività:

1. Passare alla pagina Attività . Viene visualizzato un elenco di attività.
2. Per visualizzare le variabili durante il test, selezionare Test e selezionare Variabili. Viene visualizzato il riquadro Variabili che mostra le variabili usate durante il test.
3. Per visualizzare le variabili in un'attività cronologica, selezionare un'attività dall'elenco. Selezionare quindi Variabili. Viene visualizzato il riquadro Variabili che mostra le variabili usate durante l'attività.

Visualizzare la catena di pensieri dell'agente nella chat di test

La funzionalità Chain of Thought (CoT) fornisce informazioni dettagliate sul processo di ragionamento dell'agente durante i test. Visualizza i passaggi intermedi, le considerazioni e le decisioni prese dall'agente durante l'elaborazione degli input e la generazione di output. Questa funzionalità è utile per comprendere le interazioni complesse e il comportamento dell'agente di debug.

Per visualizzare la catena di pensieri o ragionamenti dell'agente durante i test, seguire questa procedura:

1. Aprire l'agente in Copilot Studio. Viene visualizzata la pagina Panoramica.
2. Selezionare Test per aprire il riquadro test.
3. Nel riquadro di test, avvia una conversazione con l'agente inserendo una query o un prompt.
4. Prima che l'agente risponda, il ragionamento viene visualizzato nel riquadro di test, visualizzando la catena di pensiero per la risposta dell'agente.

Attività storica

Ogni volta che un agente avvia un'attività, inclusi i test avviati in Copilot Studio, la pagina Attività registra l'attività in tempo reale. Vai alla pagina Attività per:

• Esaminare le interazioni e le decisioni prese dall'agente durante un'attività.
• Trovare dove il comportamento dell'agente non corrisponde agli obiettivi.
• Vedere quanto tempo impiega l'agente per completare ogni attività.
• Trovare i dettagli dell'errore.

La cronologia delle attività dell'agente è disponibile per:

• Interazioni in Copilot Studio test chat
• Agenti pubblicati nei canali Microsoft Teams e Microsoft 365 Copilot
• Agenti pubblicati nel canale SharePoint
• Attività avviate con un trigger autonomo

Esaminare le informazioni seguenti nella pagina Attività :

• Elenco delle attività e dei relativi dettagli.
• La conversazione passo-passo che si verifica all'interno di un'attività.

Elenco attività

Un'attività è un'unità di interazione dell'agente che implica la conversazione con un utente, la registrazione e la risposta agli eventi o una combinazione di queste attività.

Nell'elenco di attività è possibile visualizzare:

• Nome: il nome dell'utente che interagisce con l'agente. Se l'attività non coinvolge un utente, ad esempio quando un agente esegue azioni senza richieste umane, l'utente viene visualizzato come Automatizzato.
• Canali: canale in cui si è svolta l'interazione. Le attività che si verificano nel riquadro di test dell'agente hanno l'icona Copilot Studio.
• Data: data di inizio della prima interazione dell'attività.
• Passaggi completati: il numero di passaggi completati dall'agente durante l'attività.
• Ultimo passaggio: il passaggio finale completato nell'attività.
• Stato: stato dell'attività (operazione riuscita, non riuscita, in corso).

Personalizzare la visualizzazione della tabella Attività

Puoi personalizzare la visualizzazione della tabella Attività per mettere in evidenza le informazioni più rilevanti per te.

Per personalizzare la visualizzazione della tabella Attività:

1. Vai alla pagina Attività del tuo agente. Viene visualizzato un elenco di attività.
2. Seleziona Modifica colonne. Viene visualizzato il riquadro Modifica colonne con un elenco di colonne disponibili.
3. Nel riquadro Modifica colonne:
   • Seleziona la casella di controllo accanto al nome delle colonne da visualizzare.
   • Deseleziona la casella di controllo accanto al nome delle colonne da nascondere.
   • Trascina e rilascia le colonne nella sequenza preferita o usa le frecce su e giù.
4. Seleziona Salva per confermare e aggiornare la visualizzazione della tabella Attività.

Visualizzare la conversazione all'interno di un'attività

Nella pagina Attività è possibile visualizzare la conversazione all'interno di un'attività in una mappa attività visiva o in una trascrizione della conversazione e nella mappa attività visiva. Per impostazione predefinita, viene visualizzata la visualizzazione Trascrizione + Mappa.

1. Per visualizzare una conversazione all'interno di un'attività, selezionare un'attività.

   • Per visualizzare la trascrizione e la mappa delle attività insieme, seleziona Visualizza e quindi seleziona la visualizzazione Trascrizione + Mappa.
   • Per visualizzare solo la mappa delle attività, seleziona Visualizza e quindi seleziona Visualizzazione mappa.

   

2. Per tornare all'elenco attività, selezionare l'icona Indietro .

La visualizzazione Trascrizione + Mappa mostra la conversazione avvenuta con l'agente durante un'attività insieme alla mappa visiva delle attività. La trascrizione registra l'input dell'utente, attiva i payload e le risposte dell'agente. Usare le trascrizioni per vedere in che modo l'agente risponde alle conversazioni con gli utenti. Puoi anche visualizzare i messaggi di payload del trigger che l'agente riceve dai trigger degli eventi.

Visualizzare la catena di pensieri dell'agente

La funzionalità Chain of Thought (CoT) fornisce informazioni dettagliate sul processo di ragionamento dell'agente durante un'attività. Visualizza i passaggi intermedi, le considerazioni e le decisioni prese dall'agente durante l'elaborazione degli input e la generazione di output. Questa funzionalità è utile per comprendere le interazioni complesse e il comportamento dell'agente di debug. È possibile visualizzare la catena di pensiero dell'agente per un'attività specifica solo nella visualizzazione Mappa.

Per visualizzare la catena di pensieri o ragionamenti dell'agente per un'attività specifica:

1. Nella scheda Attività selezionare l'attività da rivedere. Per impostazione predefinita, viene visualizzata la visualizzazione Trascrizione + Mappa .
2. Nella mappa delle attività, selezionare il chevron Ragionamento. Viene visualizzata la catena di pensieri dell'agente.

Aggiungere o rimuovere l'attività

Nella pagina Attività è possibile aggiungere attività importanti all'inizio dell'elenco di attività per facilitarne l'accesso o rimuoverle quando non sono più necessarie.

• Per aggiungere un'attività, passare il puntatore del mouse sull'attività e selezionare l'icona Aggiungi accanto al nome.
• Per rimuovere un'attività, passare il puntatore del mouse sull'attività bloccata e selezionare l'icona Rimuovi accanto al nome.

Visualizza tutta l'attività dell'agente nella mappa dell'attività

La vista Mappa è una rappresentazione visiva del flusso di input, decisioni e reazioni che si verificano durante un'attività. Ogni attività eseguita dall'agente, da un utente o da un trigger con un nodo. Durante la visualizzazione della mappa delle attività, seleziona un nodo per visualizzare i dettagli sugli input, le decisioni e gli output per tale attività.

L'immagine seguente è un esempio di ciò che viene visualizzato quando selezioni un nodo della Knowledge Base. Mostra:

• Query utilizzata dall'agente per cercare le origini della Knowledge Base. Può essere diversa dalla query scritta da un utente o dall'input fornito da un trigger.
• Risposta creata dall'agente in base alle origini della Knowledge Base.
• Origini a cui fa riferimento l'agente.
• Altre fonti che l'agente ha esaminato, ma che non ha utilizzato per creare la risposta. L'agente ha cercato queste origini, ma non ha trovato informazioni rilevanti per la query.

In questo esempio è possibile visualizzare i dettagli di un nodo azione per Ottenere la previsione domani che mostra gli input e gli output:

Seleziona Modifica per visualizzare e modificare la configurazione associata all'attività selezionata.

Spiegazione

Razionale fornisce una spiegazione del modo in cui un agente ha deciso di chiamare uno strumento specifico. L'intelligenza artificiale genera la logica su richiesta ed è basata su metadati e attività dell'agente. Razionale viene visualizzato per le fonti di conoscenza o i connettori con stato Completo. Seleziona Mostra logica per mostrare la logica.

Quando si esamina l'attività dell'agente, usare Razionale per comprendere meglio il motivo per cui un agente ha scelto di chiamare uno strumento specifico o compilare i parametri. È utile per la risoluzione dei problemi relativi al comportamento dell'agente. Tuttavia, poiché la logica viene generata con l'intelligenza artificiale, potrebbe non essere accurata, quindi usare il giudizio migliore quando si esamina la logica fornita.

Stato dell'agente

Nella tabella seguente vengono fornite informazioni sui vari stati che un agente potrebbe riscontrare durante l'operazione:

Invia feedback

Se si hanno suggerimenti su come migliorare la qualità dell'agente, inviate il vostro feedback usando l'icona Feedback nella scheda Attività.