Kommandoreferens för Agent 365 CLI deploy

Distribuera agent 365-programbinärfiler till de konfigurerade Azure App Service och uppdatera agent 365-verktygsbehörigheter Kommandot deploy innehåller alternativ för att skapa Agent 365-distributioner. Använd det här kommandot för att distribuera programbinärfiler till din Azure infrastruktur och bevilja agent 365-verktygsbehörigheter.

Minimum-rollen krävs: Azure Deltagare + Global administratör

Information om hur du använder det här kommandot finns i Distributionsagent för Azure.

Syntax

a365 deploy [command] [options]

Options

Anmärkningar

Om du kör a365 deploy utan en underkommando körs en distribution i två faser:

• Phase 1 – Binärfiler för program: Skapar och distribuerar ditt program till Azure App Service.
• Fas 2 – MCP-behörigheter: Läser nödvändiga omfång från toolingManifest.json och uppdaterar agentritningen med nödvändiga behörigheter.

Båda faserna körs även med --dry-run. Torrkörningsutdata är indelade i två märkta avsnitt så att du kan granska vad varje fas skulle göra.

Preflight-kontroller

Innan du distribuerar verifierar CLI:

• Azure autentisering och prenumeration: Din Azure CLI-session och prenumeration måste vara giltig. Om inte stoppas distributionen med ett fel. Åtgärda med az login --tenant <TENANT_ID> och az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service existens: Målwebbappen måste finnas innan distributionen fortsätter. Om appen inte hittas kör eller korrigerar a365 setupwebAppName du och resourceGroup i a365.config.json.

Konfiguration

CLI läser från två konfigurationsfiler:

• a365.config.json – projektkonfigurationen (användarunderhållen).
• a365.generated.config.json — dynamiskt tillstånd som genereras av installationskommandon.

MCP-verktygsomfång läse från toolingManifest.json i distributionsprojektkatalogen.

CLI lagrar också en global kopia av konfiguration och tillstånd på:

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

Flaggbeteende

--restart: Hoppar över byggsteget och börjar direkt från att komprimera den befintliga publish/ mappen. Om publish/ det inte finns misslyckas distributionen. Kör en fullständig distribution (utan --restart) först för att skapa publish/ mappen.

--inspect: Pausar före uppladdningssteget så att du kan inspektera publish/ mappen och den genererade ZIP-filen. Endast tillgängligt för appfasen.

--dry-run: Skriver ut allt som skulle hända utan att göra några ändringar. När du kör a365 deploy (två faser) delas utdata in i:

• Del 1 – Distribuera binärfiler för program
• Del 2 – Distribuera/uppdatera agent 365-verktygsbehörigheter

deploy app

Distribuerar din agentkod till den Azure webbapp som skapades under installationen.

a365 deploy app [options]

Distribuera Microsoft Agent 365-programbinärfiler till den konfigurerade Azure App Service. Det här kommandot distribuerar programbinärfiler till din konfigurerade Azure apptjänst i Azure.

app Alternativ

deploy mcp

Uppdaterar MCP-serverbehörigheter för din agentritning.

a365 deploy mcp [options]

mcp Alternativ

Användningsanteckningar

Uppdatera MCP-servrarnas omfång och behörigheter för den befintliga agentritningen. Det här kommandot lägger till behörigheter för Agent 365 Tools i agentritningen.

Om du lägger till eller ändrar MCP-servrar i din agentkod använder du det här kommandot för att uppdatera behörigheterna för agentritningen.

Det här kommandot:

• Läser mcp-serverkonfigurationen från koden.
• Uppdaterar agentritningen med de behörigheter som krävs.
• Beviljar nödvändiga API-behörigheter för MCP-servrarna.

Behörighetsuppdateringen gäller i följande ordning:

1. OAuth2-behörighetstilldelning (skisstjänstens huvudnamn → MCP-plattform)
2. Ärvbara behörigheter (agentritning → MCP-resurs)
3. Administratörsmedgivande (agentidentitet → MCP-plattform)

När du ska använda deploy mcp:

• När du har lagt till nya MCP-servrar i din agent.
• När du har ändrat MCP-serverkonfigurationer.
• När MCP-verktyg inte är tillgängliga för din agent.

Du behöver inte köra deploy mcp:

• Vid den första distributionen. Detta hanteras automatiskt under installationen.
• När du bara ändrar agentlogik utan MCP-ändringar.
• Efter rutinmässiga koduppdateringar som inte påverkar verktyg.

Felsökning

Använd följande avsnitt för att lösa potentiella problem med deploy kommandot.

• Inte inloggad på Azure eller fel prenumeration
• Webbappen hittades inte
• Behörighetsuppdateringen misslyckas
• --restart Misslyckas

Inte inloggad i Azure eller fel prenumeration

Kör az login --tenant <TENANT_ID> och az account set --subscription <SUBSCRIPTION_ID>.

Webbappen hittades inte

Kontrollera att a365 setup har körts eller kontrollera att webAppName och resourceGroup är korrekta i a365.config.json.

Behörighetsuppdateringen misslyckas

• Bekräfta AgentBlueprintIdatt , AgenticAppIdoch miljön har angetts i a365.config.json.
• Se till att ditt konto har behörighet att hantera tjänstens huvudnamn och bidrag.
• Kontrollera att det toolingManifest.json finns i distributionsprojektkatalogen och innehåller giltiga omfång.

--restart Misslyckas

Kör en fullständig distribution utan --restart att skapa publish/ mappen och använd --restart sedan för efterföljande iterationer.

Loggfiler

CLI-loggfiler lagras på:

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

Om du vill visa de sista 80 raderna i den senaste distributionsloggfilen använder du Get-Content på Windows eller tail på 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

För programloggar för körning använder du Log Stream i Azure-portalen för stdout/stderr från Din App Service.