Kommandoreferanse for Agent 365 CLI deploy

Distribuer agent 365-programbinærer til konfigurerte Azure App Service og oppdater agent 365-verktøytillatelser Kommandoen deploy gir alternativer for å opprette Agent 365-distribusjoner. Bruk denne kommandoen til å distribuere programbinærfiler til Azure infrastruktur og gi agent 365 Verktøy-tillatelser.

Minimum-rolle kreves: Azure bidragsyter + Global-administrator

Hvis du vil ha informasjon om hvordan du bruker denne kommandoen, kan du se Deploy-agent for å Azure.

Syntaks

a365 deploy [command] [options]

Alternativer

Merknader

Kjøring a365 deploy uten en underkommando kjører en tofaset distribusjon:

• Phase 1 – programbinærfiler: Bygger og distribuerer programmet til Azure App Service.
• Fase 2 – MCP-tillatelser: Leser nødvendige omfang fra toolingManifest.json og oppdaterer agenttegningen med de nødvendige tillatelsene.

Begge fasene kjører selv med --dry-run. Utdataene for tørrkjøring er delt inn i to merkede inndelinger, slik at du kan se gjennom hva hver fase ville gjort.

Forhåndskontroll

Før distribusjon validerer CLI:

• Azure godkjenning og abonnement: Din Azure CLI økt og abonnement må være gyldig. Hvis ikke, stopper distribusjonen med en feil. Korriger med az login --tenant <TENANT_ID> og az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service: Målwebappen må finnes før distribusjonen fortsetter. Hvis appen ikke blir funnet, kjører eller korrigerer a365 setupwebAppName du og resourceGroup i a365.config.json.

Konfigurasjon

Cli leser fra to konfigurasjonsfiler:

• a365.config.json – prosjektkonfigurasjonen (brukerholdt).
• a365.generated.config.json – dynamisk tilstand generert av installasjonskommandoer.

MCP-verktøyomfang leses fra toolingManifest.json i distribusjonsprosjektkatalogen.

CLI lagrer også en global kopi av konfigurasjon og tilstand på:

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

Flaggvirkemåte

--restart: Hopper over byggetrinnet og starter direkte fra komprimering av den eksisterende publish/ mappen. Hvis publish/ det ikke finnes, mislykkes utrullingen. Kjør en fullstendig distribusjon (uten --restart) først for å produsere publish/ mappen.

--inspect: Stanser midlertidig før opplastingstrinnet publish/ , slik at du kan undersøke mappen og den genererte ZIP-filen. Bare tilgjengelig for appfasen.

--dry-run: Skriver ut alt som ville skje uten å gjøre noen endringer. Når du kjører a365 deploy (tofaset), deles utdataene inn i:

• Del 1 – Distribuer programbinærer
• Del 2 – Distribuer/oppdater agent 365-verktøytillatelser

deploy app

Distribuerer agentkoden til Azure Web App som ble opprettet under installasjonen.

a365 deploy app [options]

Distribuer binærfiler for Microsoft Agent 365-programmer til konfigurerte Azure App Service. Denne kommandoen distribuerer programbinærfiler til den konfigurerte Azure app-tjenesten i Azure.

app Alternativer

deploy mcp

Oppdaterer MCP-servertillatelser på agentplanen.

a365 deploy mcp [options]

mcp Alternativer

Bruksnotater

Oppdater MCP-serveromfang og tillatelser for eksisterende agentplantegning. Denne kommandoen legger til tillatelser for Agent 365 Tools i agenttegningen.

Hvis du legger til eller endrer MCP-servere i agentkoden, kan du bruke denne kommandoen til å oppdatere tillatelsene på agenttegningen.

Denne kommandoen:

• Leser KONFIGURASJONEN av MCP-serveren fra koden.
• Oppdaterer agenttegningen med de nødvendige tillatelsene.
• Gir nødvendige API-tillatelser for MCP-serverne.

Tillatelsesoppdateringen gjelder i følgende rekkefølge:

1. OAuth2-tillatelsestilskudd (plantegningstjenestekontohaver → MCP-plattform)
2. Arvbare tillatelser (agenttegning → MCP-ressurs)
3. Administratorsamtykke (agentidentitet → MCP-plattform)

Når du skal bruke deploy mcp:

• Når du har lagt til nye MCP-servere i agenten din.
• Når du har endret KONFIGURASJONER for MCP-server.
• Når MCP-verktøy ikke er tilgjengelige for agenten din.

Du trenger ikke å kjøre deploy mcp:

• Ved første distribusjon. Dette håndteres automatisk under installasjonen.
• Når du bare endrer agentlogikk uten MCP-endringer.
• Etter rutinemessige kodeoppdateringer som ikke påvirker verktøy.

Feilsøking

Bruk følgende inndelinger til å løse potensielle problemer med deploy kommandoen.

• Ikke logget på Azure eller feil abonnement
• Finner ikke Web App
• Oppdatering av tillatelser mislykkes
• --restart Mislykkes

Ikke logget på Azure eller feil abonnement

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

Finner ikke Web App

Kontroller at a365 setup det er kjørt, eller kontroller at og webAppNameresourceGroup er riktig i a365.config.json.

Oppdatering av tillatelser mislykkes

• Bekreft AgentBlueprintId, AgenticAppIdog miljøet er angitt i a365.config.json.
• Sørg for at kontoen din har rettigheter til å administrere tjenestekontohavere og tilskudd.
• Kontroller at det toolingManifest.json finnes i distribusjonsprosjektkatalogen og inneholder gyldige omfang.

--restart Mislykkes

Kjør en fullstendig distribusjon uten --restart å produsere publish/ mappen, og bruk --restart deretter for etterfølgende gjentakelser.

Logs

CLI-loggfiler lagres på:

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

Hvis du vil vise de siste 80 linjene i den nyeste distribusjonsloggfilen, bruker 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

Bruk Log Stream i Azure-portalen for stdout/stderr fra apptjenesten for kjøretidslogger.