Udrul agent i Azure

Du har lavet din agent og testet den lokalt. Nu skal du få den til at køre i skyen. Dette trin er valgfrit. Du kan springe det over, hvis du allerede har udrullet din agent til en sky (det behøver ikke engang være Azure).

Denne vejledning fører dig gennem udrulningen af din agentkode på Azure og publicering af den i Microsoft Administration, hvor den bliver et registreret aktiv for din organisation.

Få oplysninger i følgende ressourcer om, hvordan du opdaterer beskedslutpunktet. De viser, hvordan du kan opdatere beskedslutpunktet, hvis du har udrullet din agent til andre cloud-udbydere som f.eks. Amazon Web Services eller Google Cloud Platform:

• Brug agentkode, der er udrullet i Amazon Web Services
• Brug agentkode, der er udrullet i Google Cloud Platform

Forudsætninger

Sørg for, at du har følgende ting, før du starter:

Påkrævede konti og tilladelser

• Azure-abonnement med bidragyderadgang.
• Fungerende agentkode med et gyldigt og tilgængeligt beskedslutpunkt. Sørg for, at du har testet din agent lokalt og eventuelt testet med Microsoft 365 ved hjælp af Dev Tunnels for at sikre, at agentkoden kan laves og køre som forventet.
• Gyldigt agent blueprint-ved at fuldføre trinnet opsætning af agent-blueprint.
• Opdaterede konfigurationsfiler a365.config.json, a365.generated.config.json og konfigurationsfil i koden (for eksempel .env-fil).

Krævede værktøjer

• Azure CLI installeret og godkendt (Installér Azure CLI)

Udrul til Azure

Udrul din agentprogramkode til Azure ved at bruge almindelige Azure-værktøjer såsom Azure CLI, Azure-portal eller GitHub Actions.

Udrul agentprogrammet

Brug Azure CLI-az webapp deploykommandoen til at udrulle programmet:

# Build your project first (example for .NET)
dotnet publish -c Release -o ./publish

# Deploy to Azure Web App
az webapp deploy --name <your-web-app> --resource-group <your-resource-group> --src-path ./publish

For GitHub-handlinger skal du bruge handlingen Azure Web Apps Deploy.

Advarsel

Administration af hemmeligheder: Gem miljøvariabler (herunder API-nøgler og hemmeligheder) som Azure-appindstillinger i stedet for i kode eller konfigurationsfiler. I produktionsmiljøer skal du bruge Azure Key Vault til følsomme hemmeligheder. Få flere oplysninger om Sikker lagring af apphemmeligheder under udvikling i ASP.NET Core- og Azure Key Vault-konfigurationsprovider. Bekræft aldrig .env filer med følsomme oplysninger til kildestyring.

Kontrollér udrulning

Når udrulningen er færdig, kan du bruge denne liste samt instruktionerne i de følgende afsnit til at kontrollere udrulningen.

✅ Udrulningskommando fuldført uden fejl
✅ Webappen kører
✅ Programlogfilerne viser en vellykket opstart
✅ Miljøvariabler er konfigureret
✅ Beskedslutpunktet svarer

Kontrollér, at udrulningskommandoen er fuldført uden fejl

Bekræft, at udrulningen lykkedes i udrulningslogfilerne:

1. Gå til din webapp i Azure Portal.
2. Gå til Indstillinger>Konfiguration for at bekræfte appindstillingerne
3. Kontrollér udrulningslogfilerne i udrulningscenteret.

Sådan ser du en detaljeret udrulningshistorik:

1. Gå til Azure Portal > din webapp
2. Udrulning>Udrulningscenter
3. Se logfiler for din seneste udrulning

Sådan gør du, hvis dit build ikke virker:

• Ryd op og genopbyg lokalt først for at bekræfte, at dit build virker.
• Se, om der er manglende afhængigheder eller syntaksfejl.
• Se Udrulningskommandoen virker ikke.

Gør følgende, hvis appen crasher efter udrulningen:

• Se efter i logfilerne, om der er specifikke fejlmeddelelser.
• Kontroller, at alle nødvendige miljøvariabler er indstillet.
• See Programmet går ned ved opstart.

Kontroller, at webappen kører

Brug az webapp show-kommandoen til at kontrollere, at webappen kører.

az webapp show --name <your-web-app> --resource-group <your-resource-group> --query state

Denne kommandos forventede output er Running.

Kontroller, at applikationslogfilerne viser en vellykket opstart

Sådan ser du webappens logfiler i Azure Portal:

1. Søg efter webappens navn i Azure Portal.
2. Gå til Oversigt>Logfiler>Log-stream.

Du kan også bruge PowerShell-az webapp log tail-kommandoen til at læse webappens logfiler:

az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

Hvis der er nedbrud eller fejlmeddelelser i logfilerne, kan du finde oplysninger i Nedbrud ved opstart af programmet.

Kontroller, at miljøvariablerne er konfigureret

Gør følgende i Azure-portal:

1. Gå til din webapp.
2. Gå til Indstillinger>Miljøvariabler.
3. Kontroller, at dine indstillinger findes.

Gør følgende, hvis miljøvariablerne ikke er sat:

• Kør udrulningen igen for at synkronisere fra .env-filen.
• Du kan også indstille dem manuelt i Azure Portal.
• Se Miljøvariabler er ikke indstillet eller forkerte.

Verificér beskedslutpunktets svar

Kontrollér, at det slutpunkt, du finder på din webapps Oversigt-side, eksisterer, ved hjælp af PowerShell eller andre værktøjer. Ellers kan du få flere oplysninger i 404 på beskedslutpunktet.

Næste trin

Dernæst skal du offentliggøre agentprogrammet i Microsoft Administration, så du kan oprette agentforekomster og brugere i det.

Publicer din agent

Din agent er nu live i skyen og klar til at besvare agentiske henvendelser. Når din agent håndterer anmodninger fra den virkelige verden, skal du overveje disse næste trin til din kode:

• Overvåg ydeevne: Brug observationsmulighedsfunktioner til at spore agentens funktionsmåde og optimere svar.
• Tilføj flere værktøjer: Udforsk værktøjskataloget for at udvide din agents funktioner.
• Gentagelse og forbedring: Opdater agentkoden, genudrul og publicer igen (husk at forøge versionsnummeret!).
• Skaler i hele din organisation: Del din agents succeshistorier for at skabe implementering.

Fejlfinding

Denne sektion beskriver de typiske problemer ved udrulning af agenter til Azure.

Tip

Agent 365 Fejlfindingsguide indeholder overordnede anbefalinger til fejlfinding, bedste praksis og links til fejlfindingsindhold for hver fase af udviklingslivscyklussen for Agent 365.

Udrulningskommandoen virker ikke

Symptom: Udrulningen til Azure mislykkes.

Almindelige årsager og løsninger:

• Buildfejl

  Genopbyg projektet lokalt for at se detaljerede kompileringsfejl:

  # .NET
  dotnet clean
  dotnet build --verbosity detailed
  
  # Python
  uv build
  
  # Node.js
  npm install
  npm run build
  

• Azure-autentificering udløbet

  Log ind igen i Azure:

  az login
  az account show  # Verify correct subscription
  

• Web App er ikke oprettet

  Vis Web Apps for at bekræfte, at målet eksisterer:

  # List Web Apps in resource group
  az webapp list --resource-group <your-resource-group> --output table
  

• Tjek udrulningslogfiler

  Brug az webapp log tail-kommandoen til at se detaljerede udrulningslogfiler:

  az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
  

• Bekræftelse:

  # Web App should be running
  az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
  # Expected: "Running"
  

Webappen er stoppet

Symptom: Udrulningen lykkes, men webappen kører ikke.

Løsning: Brug az webapp start og az webapp show til at starte webappen, og verificér, at den kører.

# Start the Web App
az webapp start --name <your-app> --resource-group <your-resource-group>

# Verify it's running
az webapp show --name <your-app> --resource-group <your-resource-group> --query state

Programmet går ned ved opstart

Symptom: Webappen starter, men går straks ned; logfilerne viser fejl.

Almindelige årsager:

• Manglende afhængigheder – gennemgå build-resultatet for at sikre, at alle nødvendige pakker er medtaget.
• Manglende miljøvariabler – kontroller at alle nødvendige indstillinger er konfigureret.
• Uoverensstemmelse mellem runtime-versioner – sørg for, at Azures runtime-miljø matcher dit udviklingsmiljø.
• Kodefejl – gennemgå logfiler til programmet, og find specifikke undtagelser.

Løsning: Brug az webapp log tail, az webapp config appsettings list og az webapp config appsettings set kommandoerne til at se logfiler, kontrollere miljøvariabler og sætte manglende variabler.

# View application logs
az webapp log tail --name <your-app> --resource-group <your-resource-group>

# Check environment variables
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Manually set a missing variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings KEY=VALUE

404 på beskedslutpunktet

Symptom: Web App kører, men /api/messages-slutpunktet returnerer 404.

Løsning:

1. Verificér rutekonfigurationen i din agentkode.
2. Kontrollér, at slutpunktets handler er korrekt registreret.
3. Sørg for, at det korrekte indgangspunkt er angivet i udrulningen.

Test slutpunktet ved at sende en GET-anmodning til URL'en. Brug az webapp config show-kommandoen til at kontrollere webappens konfiguration.

curl https://<your-app-name>.azurewebsites.net/api/messages
az webapp config show --name <your-app> --resource-group <your-resource-group>

Miljøvariabler er ikke konfigureret eller er forkerte

Symptom: Udrulningen lykkes, men agenten virker ikke; fejl med manglende konfiguration i logfilerne.

Løsning: Verificér og opdater miljøvariabler. Brug az webapp config appsettings list- og az webapp config appsettings set-kommandoerne til at kontrollere miljøvariabler og sætte manglende variabler. Udrul derefter igen.

# List all app settings
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Set a specific variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings API_KEY=your-value

Build lykkes lokalt, men mislykkes i Azure

Symptom: Koden bygges fint på din maskine, men mislykkes under Azure-udrulning.

Løsninger:

• Se efter, om der er platformsspecifikke afhængigheder

  • Nogle pakker har platformsspecifikke builds.
  • Sørg for, at afhængigheder understøtter Linux (Azure Web Apps kører som standard på Linux).

• Kontroller, at runtime-versionerne stemmer overens

  Kør disse kommandoer:

  # Check your local version
  dotnet --version  # .NET
  node --version    # Node.js
  python --version  # Python
  

  Sammenlign med Azure-runtime i portalen: Indstillinger>Konfiguration>Generelle indstillinger>Stakindstillinger..

Få yderligere hjælp i: Fejlfinding til beskedslutpunkt.