Deploy agent to Azure

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

L'agente è stato creato e testato in locale, ora è il momento attivarlo nel cloud. Questo passaggio è opzionale e può essere saltato se hai già implementato il tuo agente su qualche cloud (non deve nemmeno essere Azure).

Questa guida illustra come distribuire il codice dell'agente in Azure e pubblicarlo nell'interfaccia di amministrazione di Microsoft, in cui diventa un asset individuabile per l'organizzazione.

Ci sono anche risorse disponibili per mostrare come aggiornare l'endpoint di messaggistica se, invece di Azure, hai già implementato il tuo agente ad altri provider cloud come AWS o GCP:

• Usa il codice agente distribuito in AWS
• Usa il codice dell'agente distribuito in GCP

Prerequisiti

Prima di iniziare, assicurarsi di disporre degli elementi seguenti:

Account e autorizzazioni obbligatori

• Sottoscrizione Azure con accesso contributore.
• Codice agente funzionante con un endpoint di messaggistica valido e raggiungibile. Assicurati di aver testato questo localmente e verifica che il codice dell'agente possa essere compilato ed eseguito.
• Completa il passaggio del blueprint dell'agente di configurazione per avere un blueprint valido dell'agente.
• Assicurati che i file a365.config.jsona365.generated.config.json di configurazione e il file di configurazione nel codice (ad esempio file .env) siano aggiornati.

Strumenti necessari

• Interfaccia della riga di comando di Azure installata e autenticata (Installa l'interfaccia della riga di comando di Azure)
• Interfaccia della riga di comando di A365 installata (Interfaccia della riga di comando di Agent 365)

Distribuzione su Azure

Il a365 deploy comando distribuisce il tuo agente sull'Azure Web App creata durante la configurazione. Questo carica il codice dell'agente su Azure, rendendolo disponibile per l'esecuzione nel cloud e la gestione di eventuali richieste agentiche a quell'endpoint.

Distribuire l'agente

Esegui il comando di distribuzione:

a365 deploy

Annotazioni

a365 deploy -h mostra tutte le opzioni per eseguire questo comando, inclusi i sotto-comandi.

.NET

Comando di distribuzione per gli agenti .NET:

• Rileva i file di progetto .NET (*.csproj, *.fsprojo *.vbproj)
• Ripristina i pacchetti NuGet usando dotnet restore
• Pubblica l'applicazione usando dotnet publish con la configurazione di rilascio
• Crea un manifesto Oryx con il comando DLL del punto di ingresso (ad esempio, dotnet YourApp.dll)
• Configura il runtime di Azure in base alla versione .NET rilevata (impostazione predefinita: DOTNET|8.0)
• Distribuisce tramite ZIP con stato di avanzamento in tempo reale

Python

Comando di distribuzione per gli agenti Python:

• Rileva la struttura del progetto Python (pyproject.toml, requirements.txt e *.py )
• Crea pacchetti usando uv build se esiste pyproject.toml
• Converte automaticamente .env in impostazioni di app di Azure
• Rilevamento di avvio intelligente: trova i punti di ingresso di Agent 365.
• Configura il runtime di Azure per PYTHON|3.11
• Distribuisce tramite ZIP con stato di avanzamento in tempo reale

Node.js

Comando di distribuzione per gli agenti Node.js:

• Rileva la struttura di progetto Node.js (file package.json)
• Installa le dipendenze usando npm ci (esegue il fallback a npm install, se necessario)
• Esegue lo script di compilazione (npm run build) se definito in package.json
• Copia i file dell'applicazione: output compilato (dist/build) o file di origine
• Copia node_modules per distribuzione in Azure
• Crea il manifesto Oryx con il comando di avvio da package.json (o rileva il punto di ingresso)
• Configura il runtime di Azure in base alla versione Node rilevata (impostazione predefinita: NODE|18)
• Distribuisce tramite ZIP con stato di avanzamento in tempo reale

Avvertimento

Gestione dei segreti: quando si distribuisce, le variabili di ambiente (incluse le chiavi API e i segreti) vengono archiviate come impostazioni dell'app Azure. Mentre le variabili di ambiente vengono comunemente usate per la configurazione, vengono archiviate in testo normale. Per gli ambienti di produzione, Microsoft consiglia di usare Azure Key Vault per i segreti sensibili. Per altre informazioni, vedi Archiviazione sicura dei segreti delle app in fase di sviluppo in ASP.NET Core e nel provider di configurazione Azure Key Vault. Non eseguire mai il commit dei file .env con informazioni riservate nel controllo del codice sorgente.

Verificare la distribuzione

Al termine della distribuzione:

1. Accedi all'app Web nel portale di Azure
2. Vai a Impostazioni>Configurazione per verificare le impostazioni dell'app
3. Controlla i log di distribuzione nel centro di distribuzione

Passaggi successivi

Successivamente, pubblica la tua applicazione agente su Microsoft Admin Center così che istanze e utenti possano essere creati da esso: Pubblica l'agente su Microsoft Admin Center

Il tuo agente ora è attivo nel cloud e pronto a rispondere alle richieste agentiche. Mentre il tuo agente gestisce richieste reali, considera questi passaggi del tuo codice:

• Monitora le prestazioni: utilizza le funzionalità di osservabilità per tenere traccia del comportamento dell'agente e ottimizzare le risposte
• Aggiungi altri strumenti: esplora il catalogo degli strumenti per espandere le funzionalità dell'agente
• Esegui l'iterazione e migliora: aggiorna il codice dell'agente, ridistribuisci e ripubblica (ricordati di incrementare il numero di versione!)
• Scalabilità nell'organizzazione: condividi le storie di successo dell'agente per favorire l'adozione