Naslaginformatie over cli-opdrachten deploy voor agent 365

Binaire bestanden van agent 365-toepassingen implementeren in de geconfigureerde Azure App Service en agent 365-hulpprogrammamachtigingen bijwerken De opdracht deploy biedt opties voor het maken van agent 365-implementaties. Gebruik deze opdracht om binaire toepassingsbestanden te implementeren in uw Azure-infrastructuur en agent 365 Tools-machtigingen te verlenen.

Minimumrol vereist: Azure Inzender + Global Administrator

Zie Deploy-agent voor Azure voor meer informatie over het gebruik van deze opdracht.

Syntaxis

a365 deploy [command] [options]

Options

Opmerkingen

Uitvoeren a365 deploy zonder subopdracht voert een implementatie in twee fasen uit:

• Phase 1 — Binaire toepassingsbestanden: hiermee bouwt en implementeert u uw toepassing in Azure App Service.
• Fase 2: MCP-machtigingen: leest vereiste bereiken van toolingManifest.json en werkt de blauwdruk van de agent bij met de benodigde machtigingen.

Beide fasen worden zelfs uitgevoerd met --dry-run. De uitvoer van de drooguitvoering is onderverdeeld in twee gelabelde secties, zodat u kunt controleren wat elke fase zou doen.

Controles vooraf

Voordat de CLI wordt geïmplementeerd, wordt het volgende gevalideerd:

• Azure verificatie en abonnement: uw Azure CLI sessie en abonnement moeten geldig zijn. Als dat niet het probleem is, stopt de implementatie met een fout. Opgelost met az login --tenant <TENANT_ID> en az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service bestaan: de doelweb-app moet bestaan voordat de implementatie wordt voortgezet. Als de app niet wordt gevonden, voert u deze uit a365 setup of corrigeert webAppName u deze.resourceGroupa365.config.json

Configuratie

De CLI leest uit twee configuratiebestanden:

• a365.config.json — uw projectconfiguratie (door de gebruiker onderhouden).
• a365.generated.config.json — dynamische status gegenereerd door installatieopdrachten.

MCP-hulpprogrammabereiken worden gelezen toolingManifest.json in uw implementatieprojectmap.

In de CLI wordt ook een globale kopie van de configuratie en status opgeslagen op:

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

Vlaggedrag

--restart: slaat de buildstap over en begint rechtstreeks bij het comprimeren van de bestaande publish/ map. Als publish/ deze niet bestaat, mislukt de implementatie. Voer eerst een volledige implementatie (zonder --restart) uit om de publish/ map te produceren.

--inspect: Pauzeert voor de uploadstap, zodat u de publish/ map en het gegenereerde ZIP-bestand kunt inspecteren. Alleen beschikbaar voor de app-fase.

--dry-run: Drukt alles af wat er zou gebeuren zonder wijzigingen aan te brengen. Bij uitvoering a365 deploy (twee fasen) wordt de uitvoer onderverdeeld in:

• Deel 1: Binaire toepassingsbestanden implementeren
• Deel 2: Agent 365 Tool-machtigingen implementeren/bijwerken

deploy app

Hiermee wordt uw agentcode geïmplementeerd in de Azure Web App die tijdens de installatie is gemaakt.

a365 deploy app [options]

Implementeer binaire microsoft Agent 365-toepassingsbestanden in de geconfigureerde Azure App Service. Met deze opdracht worden binaire toepassingsbestanden geïmplementeerd in uw geconfigureerde Azure app-service in Azure.

app Opties

deploy mcp

Hiermee worden MCP-servermachtigingen bijgewerkt op de blauwdruk van uw agent.

a365 deploy mcp [options]

mcp Opties

Gebruiksnotities

Werk MCP-serversbereiken en -machtigingen bij voor bestaande agentblauwdruk. Met deze opdracht worden machtigingen voor Agent 365 Tools toegevoegd aan de blauwdruk van de agent.

Als u MCP-servers in uw agentcode toevoegt of wijzigt, gebruikt u deze opdracht om de machtigingen voor uw agentblauwdruk bij te werken.

Deze opdracht:

• Leest uw MCP-serverconfiguratie uit uw code.
• Werkt de blauwdruk van de agent bij met de vereiste machtigingen.
• Verleent de benodigde API-machtigingen voor de MCP-servers.

De machtigingsupdate is van toepassing in de volgende volgorde:

1. OAuth2-machtiging verlenen (blauwdrukservice-principal → MCP-platform)
2. Overgenomen machtigingen (agentblauwdruk → MCP-resource)
3. Beheerderstoestemming (agentidentiteit → MCP-platform)

Wanneer gebruikt deploy mcpu:

• Nadat u nieuwe MCP-servers aan uw agent hebt toegevoegd.
• Na het wijzigen van MCP-serverconfiguraties.
• Wanneer MCP-hulpprogramma's niet toegankelijk zijn voor uw agent.

U hoeft het volgende niet uit te voeren deploy mcp:

• Bij de eerste implementatie. Dit wordt automatisch verwerkt tijdens de installatie.
• Wanneer u alleen agentlogica wijzigt zonder MCP-wijzigingen.
• Na routinecode-updates die geen invloed hebben op hulpprogramma's.

Troubleshooting

Gebruik de volgende secties om potentiële problemen met de deploy opdracht op te lossen.

• Not aangemeld bij Azure of verkeerd abonnement
• Web-app is niet gevonden
• Update van machtigingen mislukt
• --restart Mislukt

Niet aangemeld bij Azure of verkeerde abonnement

Voer az login --tenant <TENANT_ID> en az account set --subscription <SUBSCRIPTION_ID> uit.

Web-app is niet gevonden

Zorg ervoor dat a365 setupwebAppName deze is uitgevoerd of controleer of en resourceGroup juist is in a365.config.json.

Update van machtigingen mislukt

• Bevestig AgentBlueprintId, AgenticAppIden omgeving zijn ingesteld in a365.config.json.
• Zorg ervoor dat uw account rechten heeft om service-principals en subsidies te beheren.
• Controleer of deze toolingManifest.json bestaat in de map van uw implementatieproject en dat deze geldige bereiken bevat.

--restart Mislukt

Voer een volledige implementatie uit zonder --restart de publish/ map te produceren en gebruik --restart deze vervolgens voor volgende iteraties.

Logs

CLI-logboekbestanden worden opgeslagen op:

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

Als u de laatste 80 regels van het meest recente implementatielogboekbestand wilt weergeven, gebruikt u Get-Content op Windows of 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

Gebruik voor runtimetoepassingslogboeken Log Stream in de Azure-portal voor stdout/stderr vanuit uw App Service.