Agent 365 CLI-kommandoreference deploy

Installér Agent 365-program binære filer til de konfigurerede Azure App Service og opdater agent 365 Tool-tilladelser Kommandoen deploy indeholder indstillinger til oprettelse af Agent 365-installationer. Brug denne kommando til at installere binære programmer i din Azure infrastruktur og tildele Agent 365 Tools-tilladelser.

Der kræves rollenMinimum: Azure Contributor + Global Administrator

Du kan få oplysninger om brug af denne kommando under Deploy agent til Azure.

Syntaks

a365 deploy [command] [options]

Indstillinger

Bemærkninger

Kørsel a365 deploy uden en underkommando kører en udrulning i to faser:

• Phase 1 – Binære programfiler: Bygger og installerer dit program på Azure App Service.
• Fase 2 – MCP-tilladelser: Læser påkrævede områder fra toolingManifest.json og opdaterer agentens kursusplan med de nødvendige tilladelser.

Begge faser kører selv med --dry-run. Det tørre output er opdelt i to navngivne sektioner, så du kan gennemse, hvad hver fase ville gøre.

Kontrol af forhåndskontrol

Før installationen validerer kommandolinjegrænsefladen:

• Azure godkendelse og abonnement: Din Azure CLI session og dit abonnement skal være gyldig. Hvis ikke, stopper installationen med en fejl. Ret med az login --tenant <TENANT_ID> og az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service eksistens: Destinationswebappen skal findes, før installationen fortsætter. Hvis appen ikke findes, skal du køre a365 setup eller rette webAppName og resourceGroup i a365.config.json.

Konfiguration

Kommandolinjegrænsefladen læser fra to konfigurationsfiler:

• a365.config.json — din projektkonfiguration (vedligeholdes af brugeren).
• a365.generated.config.json – dynamisk tilstand, der genereres af installationskommandoer.

MCP-værktøjsområder læses fra toolingManifest.json i mappen med udrulningsprojekt.

Kommandolinjegrænsefladen gemmer også en global kopi af konfigurationen og tilstanden på:

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

Flagfunktionsmåde

--restart: Springer buildtrinnet over og starter direkte fra at komprimere den eksisterende publish/ mappe. Hvis publish/ ikke findes, mislykkes installationen. Kør en komplet installation (uden --restart) først for at oprette mappen publish/ .

--inspect: Stopper midlertidigt før overførselstrinnet, så du kan undersøge mappen publish/ og den genererede ZIP-fil. Kun tilgængelig for appfasen.

--dry-run: Udskriver alt, hvad der ville ske, uden at foretage ændringer. Når du kører a365 deploy (tofaset), er outputtet opdelt i:

• Del 1 – Udrul binære programfiler
• Del 2 – Tilladelser til installation/opdatering af Agent 365 Tool

deploy app

Installerer din agentkode på den Azure Web App, der blev oprettet under installationen.

a365 deploy app [options]

Udrul binære Microsoft Agent 365-programmer til de konfigurerede Azure App Service. Denne kommando installerer binære programmer i din konfigurerede Azure apptjeneste i Azure.

app indstillinger

deploy mcp

Opdaterer MCP-servertilladelser på din agent blueprint.

a365 deploy mcp [options]

mcp indstillinger

Forbrugsnoter

Opdater MCP-serveres omfang og tilladelser for eksisterende agent blueprint. Denne kommando føjer tilladelser for Agent 365 Tools til agentens kursusplan.

Hvis du tilføjer eller ændrer MCP-servere i agentkoden, skal du bruge denne kommando til at opdatere tilladelserne til din agent-kursusplan.

Denne kommando:

• Læser din MCP-serverkonfiguration ud fra din kode.
• Opdaterer agentens kursusplan med de påkrævede tilladelser.
• Tildeler nødvendige API-tilladelser til MCP-serverne.

Tilladelsesopdateringen gælder i følgende rækkefølge:

1. OAuth2-tilladelsestildel (blueprint-tjenesteprincipal → MCP-platform)
2. Tilladelser, der kan nedarves (agentplan → MCP-ressource)
3. Administratorsamtykke (agentidentitet → MCP-platform)

Hvornår skal du bruge deploy mcp:

• Når du har føjet nye MCP-servere til din agent.
• Efter ændring af MCP-serverkonfigurationer.
• Når MCP-værktøjer ikke er tilgængelige for din agent.

Du behøver ikke at køre deploy mcp:

• Ved den indledende installation. Dette håndteres automatisk under konfigurationen.
• Når du kun ændrer agentlogik uden MCP-ændringer.
• Efter rutinemæssige kodeopdateringer, der ikke påvirker værktøjer.

Fejlfinding

Brug følgende afsnit til at løse potentielle problemer med kommandoen deploy .

• Det er ikke logget på Azure eller et forkert abonnement
• Webappen blev ikke fundet
• Opdatering af tilladelser mislykkes
• --restart Mislykkes

Ikke logget på Azure eller forkert abonnement

Kør az login --tenant <TENANT_ID> og az account set --subscription <SUBSCRIPTION_ID>.

Webappen blev ikke fundet

Kontrollér, at a365 setup er blevet kørt, eller kontrollér, at webAppName og resourceGroup er korrekt i a365.config.json.

Opdatering af tilladelser mislykkes

• Bekræft AgentBlueprintId, AgenticAppIdog miljøet er angivet i a365.config.json.
• Sørg for, at din konto har rettigheder til at administrere tjenesteprincipaler og tilskud.
• Kontrollér, at findes toolingManifest.json i installationsprojektmappen og indeholder gyldige områder.

--restart Mislykkes

Kør en fuld installation uden --restart at oprette mappen publish/ og derefter bruge --restart til efterfølgende gentagelser.

Logs

CLI-logfiler gemmes på:

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

Hvis du vil have vist de sidste 80 linjer i den seneste installationslogfil, skal du bruge Hent-Indhold 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

I forbindelse med logfiler over kørselsprogrammer skal du bruge Log Stream på Azure-portalen til stdout/stderr fra din App Service.