Distribuera din agent till Azure

Du skapade din agent och testade den lokalt. Ge nu liv åt det i molnet. Steget är valfritt. Du kan hoppa över det om du redan har distribuerat din agent till något moln (det behöver inte ens vara Azure).

Denna guide hjälper dig att distribuera din agentkod till Azure och publicera den i Microsoft admincenter, där den blir en registrerad tillgång för din organisation.

För att uppdatera messaging slutpunkt, se följande resurser. De visar hur du kan uppdatera messaging slutpunkt om du har distribuerat din agent till andra molnleverantörer som Amazon Web Services eller Google Cloud Platform:

Krav

Kontrollera att du har följande innan du börjar:

Nödvändiga konton och behörigheter

Azure-prenumeration med behörighet som Deltagare.
Fungerande agentkod med en giltig och nåbar meddelandeslutpunkt. Säkerställ att du har testat din agent lokalt och vid behov testat med Microsoft 365 via Dev Tunnels för att verifiera att agentkoden kan skapas och köras som förväntat.
Giltig agentblueprint genom att slutföra steget för installationsagentens blueprint.
Uppdaterade konfigurationsfiler a365.config.json, a365.generated.config.json, och konfigurationsfil i koden (till exempel .env-fil).

Verktyg som krävs

Azure CLI installerad och autentiserad (Installera Azure CLI)

Distribuera till Azure

Distribuera agentprogrammets kod till Azure med hjälp av standardverktyg för Azure, till exempel Azure CLI, Azure Portal eller GitHub Actions.

Distribuera agentapplikationen

Använd Azure CLI-kommandot az webapp deploy för att distribuera din applikation:

# 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

För GitHub Actions, använd Åtgärden Azure Web Apps Deploy.

Varning!

Hantering av hemligheter: Spara miljövariabler, inklusive API-nycklar och hemligheter, som Azure App Settings istället för i kod eller konfigurationsfiler. För produktionsmiljöer, använd Azure Key Vault för känsliga hemligheter. Läs mer om säker lagring av apphemligheter under utveckling med ASP.NET Core och Azure Key Vault-konfigurationsleverantör. Checka aldrig in .env-filer med känslig information i versionskontroll.

Verifiera distribution

När driftsättningen är klar, använd denna lista och instruktionerna i följande avsnitt för att verifiera distributionen.

✅ Distributionskommandot slutfördes utan fel
✅ Webappen körs
✅ Applikationsloggar visar framgångsrik uppstart
✅ Miljövariablerna har konfigurerats
✅ Meddelandeslutpunkten svarar

Verifiera att utplaceringskommandot slutförts utan fel

När distributionen är klar, verifiera framgång i distributionsloggarna:

Gå till din webbapp i Azure Portal
Gå till Inställningar>Konfiguration för att verifiera appinställningarna.
Kolla distributionsloggarna i distributionscentret.

För att se detaljerad distributionshistorik:

Gå till Azure Portal > din webbapp
Distribution>Distributionscenter
Visa loggarna för din senaste distribution

Om bygget misslyckas:

Rengör och bygg om lokalt först för att bekräfta att bygget fungerar.
Kontrollera om det saknas beroenden eller om det finns syntaxfel.
Se Kommandot Distribuera misslyckas.

Om appen kraschar efter distribution:

Kontrollera loggarna efter specifika felmeddelanden.
Verifiera att alla nödvändiga miljövariabler är satta.
Se Applikationen kraschar vid start.

Verifiera att webbappen körs

Använd kommandot az webapp show för att verifiera att webbappen körs.

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

Den förväntade utdatan av detta kommando är Running.

Verifiera att applikationsloggar visar lyckad uppstart

Visa webbapp-loggar i Azure Portal:

Sök efter webbappen efter namn i Azure Portal.
Gå till Översikt>Loggar>Loggström.

Alternativt kan du använda PowerShell-kommandot az webapp log tail för att läsa webbappens loggar:

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

Om det finns krascher eller felmeddelanden i loggar, se Applikationskrascher vid uppstart.

Kontrollera att miljövariablerna har konfigurerats

I Azure Portal:

Gå till din webbapp.
Gå till Inställningar>Miljövariabler.
Kontrollera att dina inställningar finns.

Om miljövariablerna inte är satta:

Distribuera på nytt för att synkronisera från .env-filen.
Eller ställ in dem manuellt i Azure Portal.
Se Miljövariabler saknas eller är felaktiga.

Verifiera att meddelandeslutpunktens svar svarar

Verifiera att slutpunkten du hittar på din webbapps Översikt-sida finns, till exempel med PowerShell eller andra metoder. Annars, se 404 om meddelandeterminalen.

Nästa steg

Publicera därefter din agentapplikation i Microsoft administrationscenter så att du kan skapa agentinstanser och användare från den.

Publicera agenten

Din agent är nu live i molnet och redo att svara på agentförfrågningar. När din agent hanterar riktiga förfrågningar, överväg följande steg för din kod:

Övervaka prestanda: Använd observabilitetsfunktioner för att spåra agentens beteende och optimera svar.
Lägg till fler verktyg: Utforska verktygskatalogen för att utöka din agents möjligheter.
Iterera och förbättra: Uppdatera din agentkod, distribuera om och publicera om (kom ihåg att öka versionsnumret!).
Skala över organisationen: Dela din agents framgångshistorier för att öka användningen.

Felsökning

Detta avsnitt beskriver vanliga problem vid distribution av agenter till Azure.

Dricks

Agent 365-felsökningsguide innehåller övergripande felsökningsrekommendationer, bästa praxis och länkar till felsökningsinnehåll för varje enskild del av Agent 365:s utvecklingslivscykel.

Kommandot distribuera misslyckas

Symptom: Distribution till Azure misslyckas.

Vanliga orsaker och lösningar:

Byggfel

Bygg om projektet lokalt för att se detaljerade kompileringsfel:

# .NET
dotnet clean
dotnet build --verbosity detailed

# Python
uv build

# Node.js
npm install
npm run build

Azure-autentisering utgången

Logga in på Azure igen:

az login
az account show  # Verify correct subscription

Webbapp ej skapad

Lista webbappar för att bekräfta att målet existerar:

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

Kontrollera distributionsloggar

Använd kommandot az webapp log tail för att se detaljerade distributionsloggar:
```
az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
```

Verifiering:

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

Webbappen är avstängd

Symptom: Distribution lyckas men webbappen körs inte.

Lösning: Använd az webapp start och az webapp show för att starta webbappen och verifiera att den körs.

# 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

Applikationen kraschar vid start.

Symptom: Webbappen startar men kraschar omedelbart; loggar visar fel.

Vanliga orsaker:

Saknade beroenden - Kontrollera att byggresultatet innehåller alla nödvändiga paket.
Saknade miljövariabler – Kontrollera att alla nödvändiga inställningar är konfigurerade.
Versionsinkompatibilitet – Se till att Azure körmiljö matchar din utvecklingsmiljö.
Kodfel – Kontrollera applikationsloggarna för specifika undantag.

Lösning: Använd az webapp log tail, az webapp config appsettings list och az webapp config appsettings set-kommandona för att visa loggar, kontrollera miljövariabler och ange saknade 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å meddelandeslutpunkten

Symptom: Webbappen körs men /api/messages slutpunkten returnerar 404.

Lösning:

Verifiera ruttkonfigurationen i din agentkod.
Kontrollera att slutpunkthanteraren är korrekt registrerad.
Säkerställ att rätt ingångspunkt anges vid distribution.

Testa slutpunkten genom att skicka en GET-förfrågan till URL:en. Använd kommandot az webapp config show för att kontrollera webbapplikationens konfiguration.

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

Miljövariabler saknas eller är felaktiga

Symptom: Distributionen lyckas men agenten fungerar inte; det finns fel om saknad konfiguration i loggarna.

Lösning: Verifiera och uppdatera miljövariabler. Använd kommandona az webapp config appsettings list och az webapp config appsettings set för att kontrollera miljövariabler och sätt de som saknas. Distribuera 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

Bygget lyckas lokalt men misslyckas i Azure

Symptom: Koden byggs utan problem på din dator men misslyckas vid distribution till Azure.

Lösningar:

Kontrollera plattformsspecifika beroenden
- Vissa paket har plattformsspecifika byggen.
- Se till att beroenden stödjer Linux (Azure Web Apps körs på Linux som standard).
Verifiera att runtime-versionerna matchar

Kör dessa röstkommandon:
```
# Check your local version
dotnet --version  # .NET
node --version    # Node.js
python --version  # Python
```
Jämför med Azure runtime i Portal: Inställningar>Konfiguration>Allmänna inställningar>Stack-inställningar.

För ytterligare hjälp, se: Felsökning av slutpunkter för meddelanden.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-07-30