Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.
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
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
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
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à
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
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.
Immettere un messaggio, incluso il tag #extensibility, nella casella di testo.