Ciclo di vita di sviluppo dell'agente

Il ciclo di vita di sviluppo dell'agente in Microsoft Foundry si estende dalla creazione iniziale tramite il monitoraggio della produzione. Seguendo questo ciclo di vita è possibile creare agenti affidabili, rilevare i problemi in anticipo e fornire sicurezza. Usare il portale di Foundry o il codice per compilare, personalizzare e testare il comportamento dell'agente. Iterare quindi con tracciamento, valutazione e monitoraggio per migliorare la qualità e l'affidabilità. Quando sei pronto, pubblica l'agente come agente applicazione allo scopo di condividerlo e integrarlo nelle applicazioni.

Questo articolo è destinato agli sviluppatori che vogliono compilare, testare e spedire agenti pronti per la produzione.

Prerequisiti

• Un progetto Microsoft Foundry
• Familiarità con l'Agents playground
• Per lo sviluppo di codice: familiarità con la configurazione dell'ambiente di sviluppo

Ciclo di vita a colpo d'occhio

Usare questo ciclo di sviluppo come elenco di controllo pratico durante la costruzione e la distribuzione di un agente.

1. Scegliere un tipo di agente: iniziare con un agente basato su prompt, un flusso di lavoro o un agente ospitato.
2. Creare l'agente e avviare il test: eseguire l'iterazione nel playground o nel codice.
3. Aggiungere strumenti e dati: collegare gli strumenti per il recupero e le azioni e convalidare la configurazione prima di salvare.
4. Salvare le modifiche come versioni: Catturare traguardi significativi e confrontare le versioni.
5. Eseguire il debug con il tracciamento: utilizzare il tracciamento per confermare le chiamate degli strumenti, la latenza e il comportamento end-to-end. Per informazioni dettagliate, vedere Panoramica della traccia dell'agente.
6. Valutare la qualità e la sicurezza: eseguire valutazioni ripetibili per intercettare le regressioni prima della pubblicazione. Per guida concettuale, vedere Valutatori di agenti.
7. Pubblicare e integrare: pubblicare un endpoint stabile e integrarlo nell'applicazione. Per la procedura, vedere Pubblicare e condividere agenti in Microsoft Foundry.
8. Monitorare e eseguire l'iterazione: monitorare le prestazioni e la qualità nell'ambiente di produzione, quindi aggiornare e ripubblicare in base alle esigenze. Per indicazioni, vedere Monitorare la qualità e la sicurezza.

Tipi di agente in Microsoft Foundry

Esistono tre tipi di agenti:

• Basato su prompt: un agente basato su prompt è un singolo agente definito in modo dichiarativo che combina la configurazione del modello, le istruzioni, gli strumenti e i prompt del linguaggio naturale per guidare il comportamento. Estenderlo collegando strumenti per la conoscenza e la memoria. Modifica, versiona, testa, valuta, monitora e pubblica agenti basati su prompt dal playground Agenti nel portale Foundry.

• Flusso di lavoro: usare i flussi di lavoro per creare un flusso di lavoro più avanzato che orchestra una sequenza di azioni o coordina più agenti. I flussi di lavoro hanno una propria interfaccia nel portale, ma si applica lo stesso ciclo di vita. Per informazioni dettagliate, vedere Creare un flusso di lavoro in Microsoft Foundry.

• Ospitato (anteprima): gli agenti ospitati sono agenti in contenitori compilati nel codice usando framework supportati o codice personalizzato. Il servizio Foundry Agent distribuisce e gestisce questi agenti. Non si modificano gli agenti ospitati nell'interfaccia utente che compila l'agente, ma è comunque possibile richiamare, valutare, monitorare e pubblicarli. Per informazioni dettagliate, vedere Che cosa sono gli agenti ospitati?

Creare agenti e flussi di lavoro basati su prompt nel portale foundry o nel proprio ambiente di sviluppo usando l'interfaccia della riga di comando, l'SDK o l'API REST. Per altre informazioni, vedere la guida introduttiva.

Creazione di un agente basato su prompt

Se si conosce già il tipo di agente che si vuole creare, denominarlo e quindi iniziare a configurare le istruzioni e gli strumenti del modello.

Sviluppare agenti nel codice

Se si preferisce lavorare nel codice, usare i modi supportati per inserire il codice dell'agente in un ambiente di sviluppo da cui è possibile testare localmente e quindi eseguire la distribuzione in Azure.

Dalla scheda Codice nel riquadro chat del playground dell'agente, è possibile portare un frammento di codice che fa riferimento all'agente in un ambiente cloud dedicato di Visual Studio Code per il Web. Il frammento di codice è preconfigurato con i pacchetti e le estensioni necessari, insieme alle istruzioni per sviluppare e distribuire in modo efficiente l'agente Foundry in Azure. È anche possibile copiare il frammento di codice direttamente nell'ambiente di sviluppo preferito. Per informazioni dettagliate, vedere la documentazione del playground.

Funzionalità di base per il ciclo di vita di sviluppo dell'agente

L'esperienza di creazione dell'agente offre esperienze integrate per ogni fase fondamentale del ciclo di vita di sviluppo dell'agente. Usare queste funzionalità di base durante lo sviluppo dell'applicazione agente pronta per la produzione. Ogni funzionalità include una documentazione approfondita in cui è possibile ottenere altre informazioni.

Salvare le modifiche come versioni

Dopo aver creato la prima versione di un agente basato su prompt o un flusso di lavoro, salvare le modifiche successive come nuove versioni. È possibile testare le modifiche non salvate nell'area di test dell'agente. Tuttavia, se si vuole visualizzare la cronologia delle conversazioni, monitorare le prestazioni dell'agente o eseguire valutazioni complete, è necessario salvare le modifiche.

Il controllo delle versioni dell'agente offre le funzionalità seguenti per la gestione delle configurazioni e delle iterazioni dell'agente. Questo sistema garantisce che tutte le modifiche vengano rilevate, testabili e confrontabili tra le versioni.

• Immutabilità della versione: ogni versione di un agente non è modificabile dopo averlo salvato. Le modifiche apportate a una versione esistente richiedono il salvataggio e la creazione di una nuova versione. Questo requisito garantisce l'integrità della versione e impedisce sovrascrizioni accidentali.

• Bozza di gestione dello stato: è possibile testare gli agenti in uno stato non salvato per la sperimentazione. Le modifiche non salvate vengono perse se si lascia il portale Foundry, quindi salvate frequentemente per preservare modifiche importanti.

• Operazioni di controllo della versione: è possibile indirizzare le richieste a versioni specifiche dell'agente per abilitare funzionalità di distribuzione e rollback controllate.

• Navigazione nella cronologia delle versioni: accedere alla cronologia delle versioni per qualsiasi agente, passare a una versione specifica ed eseguire i confronti seguenti:

  Tipo di confronto	Descrzione
  Configurazione dell'agente	Confrontare le impostazioni di configurazione tra le versioni usando l'elenco a discesa delle versioni
  Output della chat	Analizzare le differenze di risposta tra le versioni dell'agente usando input identici
  Definizione YAML	Esaminare le differenze nelle definizioni degli agenti

Aggiungere strumenti

Rendere l'agente più potente fornendogli informazioni (file o indici specifici) o consentendogli di eseguire azioni (chiamando API esterne). Gli strumenti sono disponibili per la maggior parte dei casi d'uso, dai caricamenti di file semplici alle connessioni server MCP (Model Context Protocol) personalizzate. Per strumenti più complessi, potrebbe essere necessario configurare l'autenticazione o aggiungere connessioni come parte del collegamento a un agente.

Per salvare un agente con uno strumento collegato, è necessario configurare correttamente lo strumento. Riutilizzare gli strumenti configurati tra gli agenti. Per informazioni sugli strumenti disponibili, vedere il catalogo degli strumenti.

Eseguire il debug e validare utilizzando il tracciamento (anteprima)

Durante l'aggiunta di strumenti e l'iterazione su richieste, usare la traccia per convalidare il comportamento end-to-end:

• Conferma se l'agente ha utilizzato gli strumenti previsti.
• Esaminare gli input e gli output degli strumenti.
• Identificare gli hotspot di latenza tra le chiamate di modelli e strumenti.

Per altre informazioni, vedere Panoramica della traccia dell'agente.

Valutare la qualità e la sicurezza (anteprima)

Prima di pubblicare l'agente (e dopo qualsiasi modifica significativa), eseguire valutazioni per rilevare le regressioni e misurare la qualità in modo coerente tra le versioni.

• Per le dimensioni di valutazione chiave per gli agenti, vedere Analizzatori di agenti.
• Per un flusso di lavoro orientato al codice che è possibile automatizzare, consulta Valuta i tuoi agenti di intelligenza artificiale localmente.

Monitorare dopo la pubblicazione

Dopo aver pubblicato un'applicazione agente, considerarla come software di produzione:

• Monitorare i segnali di qualità e sicurezza.
• Esaminare le tracce quando cambia il comportamento.
• Aggiornare e ripubblicare quando si correggeno i problemi o si apportano miglioramenti.

Per indicazioni, vedere Monitorare la qualità e la sicurezza.

Pianificare l'identità e le autorizzazioni

Gli strumenti e le risorse downstream richiedono spesso l'autenticazione. Quando si pubblica un agente, l'identità e il modello di autorizzazione possono cambiare. Assicurati che l'agente pubblicato abbia solo l'accesso necessario.

Per informazioni dettagliate, vedere Concetti relativi all'identità di Agent in Microsoft Foundry.

Sicurezza e accesso

Gestire la configurazione dell'agente come il codice dell'applicazione. Proteggere segreti e autorizzazioni durante tutto il ciclo di vita:

• Usare privilegi minimi e assegnazioni di ruolo invece di incorporare chiavi. Per altre informazioni, vedere Controllo degli accessi in base al ruolo nel portale di Foundry.
• Archivia i segreti in un archivio di segreti gestito e fai riferimento ad essi tramite connessioni anziché incorporarli direttamente nel codice, nei file di configurazione o nei prompt di input. Per indicazioni, vedere Configurare una connessione di Key Vault.
• Prima della pubblicazione, verificare che l'identità dell'agente e le connessioni degli strumenti nell'applicazione agente pubblicata dispongano solo dell'accesso necessario. Per informazioni dettagliate, vedere Concetti relativi all'identità di Agent in Microsoft Foundry.

Pubblicare l'agente o il flusso di lavoro

Dopo aver creato una versione dell'agente o del flusso di lavoro di cui si è soddisfatti, pubblicarla come applicazione agente. Si ottiene un endpoint stabile che è possibile aprire e testare nel browser, condividere con altri utenti o incorporare nelle applicazioni esistenti. L'utente e i collaboratori possono convalidare le prestazioni e identificare le esigenze di perfezionamento. Apportare eventuali aggiornamenti necessari e ripubblicare una nuova versione in qualsiasi momento.

Problemi comuni nello sviluppo di agenti

• Le modifiche non salvate sono temporanee: se si desidera confrontare versioni, visualizzare la cronologia o eseguire valutazioni complete, salvare le modifiche come versione.
• Gli strumenti devono essere configurati prima del salvataggio: se uno strumento richiede l'autenticazione o una connessione, completare la configurazione prima di salvare.
• La pubblicazione può richiedere aggiornamenti delle autorizzazioni: dopo la pubblicazione, controllare nuovamente l'accesso alle risorse per l'identità dell'agente pubblicato e rimuovere qualsiasi accesso all'agente non più necessario.

Contenuti correlati

Altre informazioni sui tipi di agente:

• Che cosa sono gli agenti ospitati?
• Componenti di runtime dell'agente

Configurare ed estendere gli agenti:

• Scoprire strumenti in Foundry Tools
• Procedure consigliate per l'uso di strumenti nel servizio Microsoft Foundry Agent

Pubblicare e monitorare gli agenti:

• Pubblicare e condividere agenti in Microsoft Foundry
• Monitorare la qualità e la sicurezza

Eseguire il debug e valutare:

• Panoramica del tracciamento degli agenti
• Valutatori di agenti