Usa la modalità sviluppatore in Microsoft 365 Copilot per testare ed eseguire il debug degli agenti

Il test è una parte importante del processo di sviluppo di agenti dichiarativi per Microsoft 365 Copilot. È possibile usare la modalità sviluppatore in Copilot Studio per testare l'agente e verificare se e come l'agente di orchestrazione Copilot seleziona le origini di conoscenza da usare in risposta a determinati prompt.

Usare la modalità sviluppatore in Copilot

Per abilitare la modalità sviluppatore in Copilot, digita -developer on. Per disabilitare la modalità sviluppatore, digitate -developer off.

Screenshot della sessione di Microsoft 365 Copilot in cui l'utente ha digitato

Quando la modalità sviluppatore è abilitata, viene restituita una scheda con le informazioni di debug ogni volta che l'agente di orchestrazione esegue una ricerca specifica all'interno delle conoscenze (dati), delle funzionalità o delle competenze aziendali (azioni o plug-in) all'interno dell'agente per rispondere a una richiesta. La scheda informazioni di debug include i seguenti campi:

  • Metadati dell'agente: identificatori per l'agente e la conversazione.
  • Funzionalità: un elenco delle funzionalità configurate per l'agente.
  • Azioni: un elenco di azioni configurate per l'agente
    • Funzioni corrispondenti: stato delle funzioni corrispondenti nella ricerca dell'indice dell'app di runtime
    • Funzioni selezionate per l'esecuzione: stato delle funzioni selezionate per la chiamata in base al ragionamento dell'agente di orchestrazione
  • Esecuzione: un elenco delle funzionalità eseguite e delle azioni per il prompt
    • Capacità eseguite: statistiche di stato e risposta per le funzionalità eseguite.
    • Azioni eseguite: stato di esecuzione della richiesta e della risposta per le azioni.

Sezione metadati agente

Screenshot della sessione di Microsoft 365 Copilot in cui Copilot ha restituito una scheda con informazioni di debug che mostra i metadati dell'agente

I metadati dell'agente forniscono dettagli chiave sull'agente e sulla sessione di debug corrente, tra cui:

  • ID agente - Un identificatore univoco per l'agente, che include l'ID del titolo e l'ID del manifesto.
  • Versione agente : il numero di versione dell'agente attualmente in uso.
  • ID conversazione - Identifica la sessione di chat o la conversazione attiva.
  • ID richiesta : identifica la richiesta specifica all'interno della conversazione.

Nota

Il prefisso nell'ID agente indica come è distribuito l'agente:

  • U_ Indica un agente con ambito utente (sideload).
  • T_ Indica un agente con ambito tenant (pubblicato nell'archivio tenant o nel catalogo dell'organizzazione).
  • P_ Indica un agente disponibile pubblicamente.

Per indicazioni sulla pubblicazione correlate, vedi:

Funzionalità dell'agente

Screenshot della sessione di Microsoft 365 Copilot in cui Copilot ha restituito una scheda con informazioni di debug che mostrano le funzionalità dell'agente configurato

Nella sezione Funzionalità dell'agente vengono visualizzate le funzionalità configurate per l'agente, definendo l'ambito delle origini di conoscenza accessibili.

Importante

Se la sezione Funzionalità agente indica che Ricerca Web è abilitata, significa solo che l'agente ha abilitato la funzionalità. Non riflette l'impostazione dei criteri cloud che gli amministratori possono usare per disabilitare la ricerca sul Web per la Allow web search in Copilot propria organizzazione. Per altre informazioni, vedere Gestire scenari di Microsoft 365 Copilot nell'interfaccia di amministrazione di Microsoft 365.

Azioni degli agenti

Screenshot della sessione di Microsoft 365 Copilot in cui Copilot ha restituito una scheda con informazioni di debug che mostrano le azioni dell'agente configurate

Le azioni agente visualizzano l'ID e il numero di versione, le funzioni configurate per l'azione, insieme al relativo stato di corrispondenza e selezione.

Scheda senza azioni abilitate

Se non sono state abilitate azioni, la sezione delle azioni indica che non sono abilitate azioni.

Scheda senza funzioni corrispondenti

Se non sono state restituite funzioni corrispondenti per il prompt specificato, è probabile che il prompt non abbia menzionato in modo esplicito il nome dell'azione.

Dettagli di esecuzione

Le sezioni dei dettagli eseguiti mostrano se e quali delle funzionalità o azioni configurate sono state eseguite per la richiesta, nonché i dettagli e lo stato di esecuzione.

Dettagli di esecuzione delle funzionalità

Screenshot della sessione di Microsoft 365 Copilot in cui Copilot ha restituito una scheda con informazioni di debug che mostrano le funzionalità eseguite

I dettagli di esecuzione della funzionalità visualizzano la funzionalità eseguita e il relativo stato. Ogni funzionalità può avere dettagli di esecuzione diversi, ad esempio il testo di ricerca usato, la risposta della funzionalità e/o il numero di risultati restituiti.

Dettagli di esecuzione delle azioni

Screenshot della sessione di Microsoft 365 Copilot in cui Copilot ha restituito una scheda con informazioni di debug che mostrano le azioni eseguite

I dettagli di esecuzione dell'azione includono la funzione e il relativo stato, insieme alla latenza, alle informazioni sulla richiesta (endpoint della richiesta, metodo HTTP, intestazioni della richiesta) e alla risposta.

Scheda senza funzioni selezionate per l'esecuzione

Se nessuna funzione di azione corrisponde all'intento di ricerca del prompt, la scheda informazioni di debug segnala Nessuna funzione selezionata per l'esecuzione. Questo è probabilmente dovuto al fatto che la descrizione del comando nel manifesto non è semanticamente correlata all'intento di ricerca del prompt specificato.

Se Copilot in precedenza corrispondeva ed eseguiva correttamente le funzioni, questa può essere un'indicazione di limitazione.

Scheda con vuoto o non riuscito Nessun dettaglio di esecuzione della funzione

Per i plug-in di estensione non messaggio, se sono presenti dettagli di esecuzione della funzione non riusciti o assenti, indica un errore durante il tentativo dell'agente di assegnare parametri alla funzione selezionata del plug-in. Se l'errore è coerente, è molto probabile che sia dovuto a descrizioni poco chiare di azioni o parametri, URL host non validi o altri problemi con la definizione di Open API.

Per i plug-in di estensione messaggio, la procedura consigliata consiste nell'ottimizzare le risposte sotto i nove secondi. Per altre informazioni, esaminare i requisiti tecnici per i plug-in di estensione messaggio.

Attualmente, il limite di timeout per l'esecuzione di un'API plug-in da parte di Copilot è impostato su 10 secondi.

Risolvere gli errori

Di seguito sono riportati gli errori comuni che potrebbero verificarsi durante il debug dell'agente e le possibili cause.

Nessuna scheda di debug

Se l'agente di orchestrazione non richiede i dati o le competenze di Microsoft 365 per rispondere a un prompt, non viene restituita alcuna scheda informazioni di debug.

Le schede di debug non vengono restituite nemmeno nei casi di limitazione della capacità, per cui in genere viene visualizzato un messaggio di errore che indica di riprovare in un secondo momento.

Segnalazione di un problema

Segnala qualsiasi feedback o problema con il tuo agente usando il pulsante pollice in su o pollice in giù. Includere il tag #extensibility nel report.

Screenshot delle opzioni di feedback pollice in su o pollice in giù di Microsoft 365 Copilot

Immettere un messaggio, incluso il tag #extensibility, nella casella di testo.

Screenshot del feedback su Microsoft 365 Copilot nella casella di testo