Traccia con Application Insights
Determinare il motivo alla base delle esecuzioni dell'agente è importante per la risoluzione dei problemi e il debug. Tuttavia, può essere difficile per gli agenti complessi per diversi motivi:
- Potrebbe esserci un numero elevato di passaggi coinvolti nella generazione di una risposta, rendendo difficile tenere traccia di tutti.
- La sequenza di passaggi può variare in base all'input dell'utente.
- Gli input/output in ogni fase potrebbero essere lunghi e meritano un'ispezione più dettagliata.
- Ogni passaggio del runtime di un agente può comportare anche l'annidamento. Ad esempio, un agente potrebbe richiamare uno strumento, che usa un altro processo, che quindi richiama un altro strumento. Se si nota un output strano o errato da un'esecuzione dell'agente di primo livello, potrebbe essere difficile determinare esattamente dove è stato introdotto il problema nell'esecuzione.
La traccia risolve questo problema consentendo di visualizzare chiaramente gli input e gli output di ogni primitiva coinvolta in una determinata esecuzione dell'agente, nell'ordine in cui sono stati richiamati.
Creazione di una risorsa di Application Insights
La traccia consente di analizzare le prestazioni e il comportamento dell'agente usando OpenTelemetry e aggiungendo una risorsa di Application Insights al progetto Azure AI Foundry.
Per aggiungere una risorsa di Application Insights, passare alla scheda Traccia nel portale di Azure AI Foundry e creare una nuova risorsa, se non ne è già disponibile una.
Dopo la creazione, è possibile ottenere un stringa di connessione di Application Insights, configurare gli agenti e osservare il percorso di esecuzione completo dell'agente tramite Monitoraggio di Azure. In genere si vuole abilitare la traccia prima di creare un agente.
Tracciare un agente
pip install Usare prima di tutto per installare OpenTelemetry e il plug-in di traccia di Azure SDK.
pip install opentelemetry
pip install azure-core-tracing-opentelemetry
È anche necessario un esportatore per inviare i risultati al back-end di osservabilità. È possibile stampare tracce nella console o usare un visualizzatore locale, ad esempio Aspira dashboard. Per connettersi a Aspire Dashboard o a un altro back-end compatibile con OpenTelemetry, installare l'utilità di esportazione OPENTelemetry Protocol (OTLP).
pip install opentelemetry-exporter-otlp
Dopo aver installato i pacchetti, è possibile usare uno degli esempi python seguenti per implementare la traccia con gli agenti. Gli esempi che usano la traccia della console visualizzano i risultati in locale nella console. Gli esempi che usano Monitoraggio di Azure inviano le tracce a Monitoraggio di Azure nel portale di Azure AI Foundry, nella scheda Traccia nel menu di spostamento a sinistra per il portale.
Nota
Esiste un bug noto nella funzionalità di traccia degli agenti. Il bug causerà che lo strumento funzione dell'agente chiami informazioni correlate (nomi di funzione e valori dei parametri, che potrebbero contenere informazioni riservate) nelle tracce anche quando la registrazione del contenuto non è abilitata.
Uso di Monitoraggio di Azure
- Esempio di agente di base
- Esempio di agente con chiamata di funzione
- Esempio con un gestore eventi di flusso
Uso della traccia della console