Informazioni di riferimento sul comando dell'interfaccia della riga di comando di Agent 365 deploy

Distribuire i file binari dell'applicazione Agent 365 nei Azure App Service configurati e aggiornare le autorizzazioni dello strumento Agent 365 Il comando deploy offre opzioni per creare distribuzioni di Agent 365. Usare questo comando per distribuire i file binari dell'applicazione nell'infrastruttura di Azure e concedere le autorizzazioni di Agent 365 Tools.

Ruolo Minimum necessario: Azure Collaboratore + Global Administrator

Per informazioni sull'uso di questo comando, vedere Deploy agent to Azure.

Sintassi

a365 deploy [command] [options]

Options

Osservazioni:

L'esecuzione a365 deploy senza un sottocomando esegue una distribuzione in due fasi:

• Phase 1 - File binari dell'applicazione: compila e distribuisce l'applicazione in Azure App Service.
• Fase 2- Autorizzazioni MCP: legge gli ambiti necessari da toolingManifest.json e aggiorna il progetto agente con le autorizzazioni necessarie.

Entrambe le fasi vengono eseguite anche con --dry-run. L'output di dry-run è suddiviso in due sezioni etichettate in modo da poter esaminare le operazioni eseguite da ogni fase.

Controlli preliminari

Prima della distribuzione, l'interfaccia della riga di comando convalida:

• Azure l'autenticazione e la sottoscrizione: la sessione e la sottoscrizione di Azure CLI devono essere valide. In caso contrario, la distribuzione viene arrestata con un errore. Correggere con az login --tenant <TENANT_ID> e az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service esistenza: l'app Web di destinazione deve esistere prima che la distribuzione proceda. Se l'app non viene trovata, eseguire a365 setup o correggere webAppName e resourceGroup in a365.config.json.

Configurazione

L'interfaccia della riga di comando legge da due file di configurazione:

• a365.config.json — configurazione del progetto (gestita dall'utente).
• a365.generated.config.json — stato dinamico generato dai comandi di installazione.

Gli ambiti degli strumenti MCP vengono letti dalla toolingManifest.json directory del progetto di distribuzione.

L'interfaccia della riga di comando archivia anche una copia globale della configurazione e dello stato in:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• Linux/macOS: ~/.config/a365

Comportamento del flag

--restart: ignora il passaggio di compilazione e inizia direttamente dalla compressione della cartella esistente publish/ . Se publish/ non esiste, la distribuzione ha esito negativo. Eseguire prima una distribuzione completa (senza --restart) per produrre la publish/ cartella .

--inspect: si sospende prima del passaggio di caricamento in modo da poter esaminare la publish/ cartella e il file ZIP generato. Disponibile solo per la fase dell'app.

--dry-run: stampa tutto ciò che accadrebbe senza apportare modifiche. Durante l'esecuzione a365 deploy (in due fasi), l'output viene suddiviso in:

• Parte 1: Distribuire file binari dell'applicazione
• Parte 2 - Distribuire/aggiornare le autorizzazioni degli strumenti dell'agente 365

deploy app

Distribuisce il codice dell'agente nell'app Web Azure creata durante l'installazione.

a365 deploy app [options]

Distribuire i file binari dell'applicazione di Microsoft Agent 365 nel Azure App Service configurato. Questo comando distribuisce i file binari dell'applicazione nel servizio app configurato Azure in Azure.

Opzioni app

deploy mcp

Aggiorna le autorizzazioni del server MCP nel progetto agente.

a365 deploy mcp [options]

Opzioni mcp

Note sull'utilizzo

Aggiornare gli ambiti e le autorizzazioni dei server MCP nel progetto agente esistente. Questo comando aggiunge le autorizzazioni per Gli strumenti di Agent 365 al progetto agente.

Se si aggiungono o si modificano i server MCP nel codice dell'agente, usare questo comando per aggiornare le autorizzazioni per il progetto agente.

Questo comando:

• Legge la configurazione del server MCP dal codice.
• Aggiorna il progetto agente con le autorizzazioni necessarie.
• Concede le autorizzazioni API necessarie per i server MCP.

L'aggiornamento delle autorizzazioni si applica nell'ordine seguente:

1. Concessione di autorizzazioni OAuth2 (entità servizio progetto → piattaforma MCP)
2. Autorizzazioni ereditabili (progetto agente → risorsa MCP)
3. Consenso amministratore (identità agente → piattaforma MCP)

Quando usare deploy mcp:

• Dopo aver aggiunto nuovi server MCP all'agente.
• Dopo aver modificato le configurazioni del server MCP.
• Quando gli strumenti MCP non sono accessibili all'agente.

Non è necessario eseguire deploy mcp:

• Nella distribuzione iniziale. Questa operazione viene gestita automaticamente durante l'installazione.
• Quando si modifica solo la logica dell'agente senza modifiche mcp.
• Dopo gli aggiornamenti del codice di routine che non influiscono sugli strumenti.

Risoluzione dei problemi

Usare le sezioni seguenti per risolvere potenziali problemi con il deploy comando .

• Non è stato eseguito l'accesso a Azure o una sottoscrizione errata
• App Web non trovata
• L'aggiornamento delle autorizzazioni non riesce
• --restart Ha esito negativo

Non è stato eseguito l'accesso a Azure o una sottoscrizione errata

Eseguire az login --tenant <TENANT_ID> e az account set --subscription <SUBSCRIPTION_ID>.

App Web non trovata

Verificare a365 setup che sia stato eseguito o verificare che webAppName e resourceGroup siano corretti in a365.config.json.

L'aggiornamento delle autorizzazioni non riesce

• Verificare che AgentBlueprintId, AgenticAppIde l'ambiente siano impostati in a365.config.json.
• Assicurarsi che l'account disponga dei diritti per gestire le entità servizio e le concessioni.
• Verificare che toolingManifest.json esista nella directory del progetto di distribuzione e che contenga ambiti validi.

--restart Fallisce

Eseguire una distribuzione completa senza --restart produrre la publish/ cartella, quindi usare --restart per le iterazioni successive.

Registrazioni

I file di log dell'interfaccia della riga di comando vengono archiviati in:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• Linux/macOS: ~/.config/a365/logs/

Per visualizzare le ultime 80 righe del file di log di distribuzione più recente, usare Get-Content in Windows o tail in Linux/macOS:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Per i log delle applicazioni di runtime, usare Log Stream nel portale di Azure per stdout/stderr dal servizio app.