Ispezionare un agente locale con Agent Inspector

Importante

Gli elementi contrassegnati (anteprima) in questo articolo sono attualmente in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero avere funzionalità limitate. Per ulteriori informazioni, vedere Condizioni supplementari per l'uso delle versioni di anteprima di Microsoft Azure.

Agent Inspector è un'interfaccia utente basata su browser per ispezionare un agente Microsoft Foundry in esecuzione sulla macchina locale. Si connette all'endpoint HTTP/SSE dell'agente locale, mostra le richieste e le risposte e consente di riprodurre i messaggi durante l'iterazione su prompt, strumenti e codice.

Prerequisiti

Progetto di agente ospitato inizializzato. Per crearne uno, vedere Inizializzare un progetto di agente.
Le estensioni azd di Foundry installate. Per la procedura di installazione, vedere Installare le estensioni azd Foundry.
Una sessione autenticata di Azure Developer CLI. Eseguire azd auth login se necessario.
Un agente locale per ispezionare. Per avviarne uno, vedere Eseguire un agente ospitato in locale con l'interfaccia della riga di comando per sviluppatori di Azure.

Lo strumento di ispezione è distribuito come estensione separata (azure.ai.inspector) ed è installato automaticamente dal meta-pacchetto microsoft.foundry. Viene inoltre incluso come dipendenza di azure.ai.agents, quindi è sufficiente installare solo l'estensione dell'agente.

Annotazioni

Per impostazione predefinita, il controllo è destinato solo a un agente locale in http://localhost:8088. Non si autentica con un agente Foundry distribuito né funge da proxy per esso. Per l'agente distribuito, usare azd ai agent invoke e azd ai agent monitor.

Avvia l'agente localmente

Avviare l'agente in un unico terminale:
```
azd ai agent run
```
Per impostazione predefinita, azd ai agent run apre l'Inspector quando il server locale inizia ad ascoltare.
Per saltare l'avvio automatico, specifica --no-inspector:
```
azd ai agent run --no-inspector
```

Avvia manualmente l'ispettore

Se hai avviato tu stesso l'agente, ad esempio con python app.py o dotnet run, oppure se hai chiuso la scheda dell'inspector e vuoi riaprirla, avvia l'inspector manualmente.

Eseguire il comando di avvio:
```
azd ai inspector launch
```
L'interfaccia utente è disponibile su http://localhost:8087 per impostazione predefinita e si connette a un agente su http://localhost:8088.

Configurare entrambe le porte, se necessario:

# Agent on port 9000, UI on port 9001.
azd ai inspector launch --port 9000 --inspector-port 9001

Per effettuare il seeding del controllo con un ID sessione o conversazione esistente per riprodurre un'esecuzione specifica, passare esplicitamente gli ID:
```
azd ai inspector launch \
  --conversation-id conv_abc123 \
  --session-id sess_xyz789
```

Esaminare il traffico locale

Quando l’ispettore è aperto, l’applicazione a pagina singola trasmette in streaming le risposte dell’agente tramite SSE e le mostra anche nel terminale. È possibile:

Esamina i payload completi della richiesta e della risposta in ogni turno.
Continuare una conversazione esistente riutilizzando l'ID della conversazione nei vari turni.
Reimposta una nuova sessione in qualsiasi momento.

Il controllo non modifica il codice dell'agente né azure.yaml. È puramente una visualizzazione di runtime.

Eseguire un agente ospitato in locale con l'interfaccia della riga di comando per sviluppatori Azure per avviare l'agente locale.
Richiamare un agente ospitato con l'interfaccia della riga di comando per sviluppatori Azure per la chiamata locale e distribuita basata su terminale.
Isolare le sessioni dell'agente ospitato per utente per testare l'isolamento rispetto a un agente distribuito.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-07-06