panoramica dell'estensione dell'agente Foundry Microsoft

L'estensione agente Microsoft Foundry di Azure Developer CLI (azd) genera la struttura, esegue il provisioning e distribuisce gli agenti in Microsoft Foundry dal terminale o dall'editor. Combina le funzionalità dell'agente Foundry con azd i comandi del ciclo di vita per un flusso di lavoro coerente da locale a cloud. È possibile passare da un agente di esempio a un endpoint distribuito e chiamabile con alcuni comandi.

Questo articolo presenta l'estensione. Per istruzioni dettagliate, vedere la documentazione relativa agli agenti ospitati Microsoft Foundry.

Funzionalità principali

Esplorare il flusso di lavoro

L'estensione segue un noto ciclo di vita azd dalla generazione della struttura di base a un agente operativo:

1. Scaffolding: inizializzare un progetto agente di esempio, tra cui l'infrastruttura come codice, una definizione dell'agente e la configurazione.
2. Effettuare il provisioning e la distribuzione: creare l'account e il progetto Foundry, distribuire modelli, compilare ed eseguire il push del contenitore dell'agente e pubblicare l'agente.
3. Eseguire localmente: eseguire l'iterazione nell'agente nel computer locale mentre si è connessi alle risorse di Azure remote.
4. Richiamare e monitorare: inviare richieste all'agente distribuito e trasmettere i log live.
5. Smantellamento: rimuovere tutte le risorse di cui è stato eseguito il provisioning al termine delle operazioni.

Provala

Provare a distribuire un agente di esempio con il flusso di lavoro minimo. In questo esempio viene usato l'esempio Di base di Agent Framework della documentazione di Microsoft Foundry.

1. Crea un progetto di esempio per un agente in una cartella vuota:

   azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml
   

2. Effettuare il provisioning delle risorse e distribuire l'agente in un unico passaggio:

   azd up
   

   Tip

   È anche possibile suddividere questo passaggio in azd provision e azd deploy per un maggiore controllo su ogni fase.

3. Rimuovere tutte le risorse di cui è stato effettuato il provisioning al termine:

   azd down
   

   Avviso

   azd down elimina definitivamente ogni risorsa nel gruppo di risorse. Usarlo con attenzione in ambienti condivisi o di produzione.

Per i prerequisiti, la selezione del modello, i test locali e la risoluzione dei problemi, vedere Avvio rapido: Distribuire il primo agente ospitato.

Quando usare l'estensione dell'agente

Microsoft Foundry supporta diversi modi per compilare e distribuire agenti ospitati, tra cui Python SDK, Visual Studio Code e il portale. L'estensione dell'agente azd è la soluzione migliore quando vuoi:

• Lavorare principalmente dal terminale o dall'editor con un flusso di lavoro ripetibile tramite script.
• Gestire insieme l'infrastruttura e gli agenti usando file dichiarativi azure.yaml e Bicep sotto il controllo del codice sorgente.
• Passare in modo coerente dal cloud locale al cloud usando gli stessi azd comandi del ciclo di vita (azd init, azd up, azd down) già usati per altre app Azure.
• Standardizzare le distribuzioni tra ambienti (sviluppo, test e produzione) e automatizzarle in CI/CD.

Per un'esperienza guidata del portale o per creare agenti con Python SDK, iniziare con la documentazione degli agenti ospitati di Microsoft Foundry.

Risorse aggiuntive

• Documentazione CLI degli sviluppatori di Azure
• Documentazione di Microsoft Foundry
• Repository di Agent Framework (esempi e strumenti)
• modello iniziale Foundry