Rull ut agenten til Azure

Du har bygget agenten din og testet den lokalt. Nå, bring det til live i skyen. Dette trinnet er valgfritt. Du kan hoppe over dette steget hvis du allerede har distribuert agenten din til en skytjeneste (det trenger ikke engang å være Azure).

Denne veiledningen viser deg hvordan du kan distribuere agentkoden din til Azure og publisere den i Microsoft Admin Center, hvor den blir en registrert ressurs for organisasjonen din.

For å oppdatere meldingsendepunktet, se følgende ressurser. De viser hvordan du kan oppdatere meldingsendepunktet hvis du har distribuert agenten din til andre skyleverandører, som Amazon Web Services eller Google Cloud Platform:

• Bruk agentkode distribuert i Amazon Web Services
• Bruk agentkode distribuert i Google Cloud Platform

Forutsetning

Pass på at du har følgende elementer før du begynner:

Krav til kontoer og tillatelser

• Azure-abonnement med bidragsytertilgang.
• Fungerende agentkode med et gyldig og nåbart meldingsendepunkt. Sørg for at du har testet agenten lokalt, og eventuelt testet med Microsoft 365 ved hjelp av Dev Tunnels, for å verifisere at agentkoden kan bygges og kjøres som forventet.
• Gyldig agent blueprint etter å ha fullført trinnet for oppsett av agent blueprint.
• Oppdaterte konfigurasjonsfiler a365.config.json, a365.generated.config.json samt konfigurasjonsfil i koden (f.eks. .env-fil).

Obligatoriske verktøy

• Azure CLI må være installert og autentisert (Installer Azure CLI)

Distribuer til Azure

Distribuer kode for agentapplikasjonen din til Azure ved å bruke standard Azure-verktøy som Azure CLI, Azure Portal eller GitHub Actions.

Distribuer agentapplikasjonen

Bruk Azure CLI az webapp deploy-kommandoen for å distribuere applikasjonen din:

# 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 Actions, bruk Azure Web Apps Deploy-handlingen.

Advarsel!

Håndtering av hemmeligheter: Lagre miljøvariabler, inkludert API-nøkler og hemmeligheter, som Azure App Settings i stedet for kode eller konfigurasjonsfiler. For produksjonsmiljøer, bruk Azure Key Vault for sensitive hemmeligheter. Les mer om Sikker lagring av app-hemmeligheter under utvikling i ASP.NET Core og Azure Key Vault konfigurasjonsleverandør. Aldri sjekk inn .env filer med sensitiv informasjon til kildekontroll.

Bekreft distribusjon

Etter at utrullingen er ferdig, bruk denne listen og instruksjonene i de følgende seksjonene for å verifisere utrullingen.

✅ Utplasseringskommando fullført uten feil
✅ Webappen kjører
✅ Applikasjonslogger viser vellykket oppstart
✅ Miljøvariabler er konfigurert
✅ Meldingsendepunktet svarer

Kontroller at utrullingskommandoen ble fullført uten feil

Etter at utrullingen er ferdig, kontroller at utrullingen var vellykket i utrullingsloggene:

1. Gå til webappen din i Azure Portal.
2. Gå til Innstillinger>Konfigurasjon for å verifisere appens innstillinger.
3. Sjekk distribusjonsloggene i distribusjonssenteret.

For å se detaljert utplasseringshistorikk:

1. Gå til Azure Portal > Din webapp
2. Distribusjon>Distribusjonssenter
3. Se loggene for din siste utplassering

Hvis byggingen feiler:

• Rens og bygg på nytt lokalt først for å bekrefte at byggingen fungerer.
• Sjekk for manglende avhengigheter eller syntaksfeil.
• Se Deploy-kommandoen feiler.

Hvis appen krasjer etter utrulling:

• Sjekk loggene for spesifikke feilmeldinger.
• Verifiser at alle nødvendige miljøvariabler er satt.
• Se Applikasjonen krasjer ved oppstart.

Verifiser at webappen kjører

Bruk az webapp show-kommandoen for å verifisere at webappen kjører.

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

Den forventede utdataen av denne kommandoen er Running.

Verifiser at applikasjonsloggene viser vellykket oppstart

For å se webappens logger i Azure Portal:

1. Søk opp webappen ved navn i Azure Portal.
2. Gå til Oversikt>Logger>Loggstrøm.

Alternativt kan du bruke PowerShell az webapp log tail-kommandoen for å lese webapplogger:

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

Hvis det er krasj- eller feilmeldinger i logger, se Applikasjonen krasjer ved oppstart.

Bekreft at miljøvariabler er konfigurert

I Azure Portal:

1. Gå til nettappen din.
2. Gå til Innstillinger>Miljøvariabler.
3. Sjekk at innstillingene dine er til stede.

Hvis miljøvariablene ikke er satt:

• Kjør distribusjon på nytt for å synkronisere fra .env-filen.
• Eller sett dem manuelt i Azure Portal.
• Se Miljøvariabler ikke satt eller feil.

Verifiser at meldingsendepunktet svarer

Test om endepunktet du finner på Oversikt-siden til nettappen din eksisterer ved hjelp av PowerShell eller andre verktøy. Hvis ikke, se 404 på meldingsendepunktet.

Neste trinn

Publiser agentapplikasjonen din i Microsoft Admin Center, slik at du kan opprette agentinstanser og brukere basert på den.

Publiser agenten

Agenten din er nå operativ i skyen og klar til å svare på agentiske forespørsler. Etter hvert som agenten din håndterer faktiske forespørsler, bør du vurdere disse neste trinnene:

• Overvåk ytelsen: Bruk overvåkingsfunksjoner for å spore agentatferd og optimalisere svarene.
• Legg til flere verktøy: Utforsk verktøykatalogen for å utvide agentens funksjonalitet.
• Iterer og forbedre: Oppdater agentkoden din, distribuer på nytt og publiser på nytt (husk å øke versjonsnummeret!).
• Skaler på tvers av organisasjon: Del agentens suksesshistorier for å øke utbredelsen.

Feilsøking

Denne delen beskriver vanlige problemer ved distribuering av agenter til Azure.

Tips

Feilsøkingsveiledning for Agent 365 inneholder anbefalinger på høyt nivå for feilsøking, anbefalte fremgangsmåter og koblinger til feilsøkingsinnhold for hver fase i utviklingssyklusen i Agent 365.

Deploy-kommandoen feiler

Symptom: Distribusjon til Azure feiler.

Vanlige årsaker og løsninger:

• Byggefeil

  Bygg prosjektet på nytt lokalt for å se detaljerte kompileringsfeil:

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

• Azure-autentisering utløpt

  Logg på Azure igjen:

  az login
  az account show  # Verify correct subscription
  

• Webapp ikke opprettet

  List opp webapper for å bekrefte at målet eksisterer:

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

• Sjekk distribusjonslogger

  Bruk kommandoen az webapp log tail for å se detaljerte distribusjonslogger:

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

• Verifikasjon:

  # 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: Distribusjonen lykkes, men webappen er ikke i gang.

Løsning: Bruk az webapp start og az webapp show for å starte webappen og verifiser at den kjø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

Applikasjonen krasjer ved oppstart

Symptom: Nettappen starter, men krasjer umiddelbart; loggene viser feil.

Vanlige årsaker:

• Manglende avhengigheter - Sjekk byggeoutput for å sikre at alle nødvendige pakker er inkludert.
• Manglende miljøvariabler - Bekreft at alle påkrevde miljøvariabler er satt opp.
• Runtime-versjonskonflikt – Sørg for at Azure-runtime stemmer overens med utviklingsmiljøet ditt.
• Kodefeil – Sjekk applikasjonslogg for spesifikke unntak.

Løsning: Bruk az webapp log tail, az webapp config appsettings list og az webapp config appsettings set-kommandoene for å vise logger, kontrollere miljøvariabler og angi 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å meldingsendepunkt

Symptom: Webappen kjører, men /api/messages endepunktet returnerer 404.

Løsning:

1. Kontroller rutekonfigurasjonen i agentkoden din.
2. Sjekk at endepunktshandleren er korrekt registrert.
3. Sørg for at riktig inngangspunkt er angitt under distribusjon.

Test endepunktet ved å sende en GET forespørsel til nettadressen. Bruk kommandoen az webapp config show for å sjekke webapp-konfigurasjonen.

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

Miljøvariablene er ikke satt eller feilkonfigurert

Symptom: Distribusjonen lykkes, men agenten fungerer ikke; loggene viser feil om manglende konfigurasjon.

Løsning: Verifiser og oppdater miljøvariabler. Bruk kommandoene az webapp config appsettings list og az webapp config appsettings set for å kontrollere miljøvariabler, og sett verdier for manglende variabler. Distribuer på nytt.

# 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

Byggingen lykkes lokalt, men feiler i Azure

Symptom: Koden bygger uten problemer på maskinen din, men feiler under distribusjon til Azure.

Løsninger:

• Sjekk etter plattformspesifikke avhengigheter

  • Noen pakker har plattformspesifikke byggversjoner.
  • Sørg for at avhengighetene er kompatible med Linux (Azure Web Apps kjører på Linux som standard).

• Verifiser at kjøretidsversjonene stemmer overens

  Kjør disse kommandoene:

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

  Sammenlign med Azure runtime i Azure-portalen: Innstillinger>Konfigurasjon>Generelle innstillinger>Stack-innstillinger.

For ytterligere hjelp, se: Feilsøking av meldingsendepunkt.