Felsökningsguide för Agent 365

Använd denna guide för att identifiera och lösa problem under hela Agent 365:s utvecklingslivscykel. Använd den här artikeln som utgångspunkt för felsökning och gå sedan till specifika avsnitt för detaljerade lösningar.

Felsökningssteg

Varje länk i denna tabell innehåller felsökningssteg för specifika områden. Innehållet är grupperat efter stadiet i Agent 365 SDK:s utvecklingslivscykel.

Stadium Felsökningsinnehåll
Skapa och köra agenten Agent 365 CLI
Registrering av anpassade klientappar för Agent 365 CLI
Mockverktygsserver
Agentobservabilitet
Testning av agenter
Testa agenter med Dev Tunnels
Lägga till och hantera verktyg
Konfigurera agent blueprint Skapa agent Blueprint
Distribuera Distribuera din agent till Azure
Distribuera agent till Amazon Web Services (AWS)
Distribuera agent till Google Cloud Platform (GCP)
Publicera agenten i Microsoft 365 Admin Center Publicera agenten i Microsoft Admin Center
Skapa agentinstanser Skapa agentinstanser

Referens för diagnostiska kommandon

Innan du går in på specifika problem, använd dessa kommandon för att kontrollera det aktuella läget på din Agent 365-installation:

Kontrollera CLI och konfiguration

Använd dessa kommandon för att validera din CLI och konfiguration.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Verifiera Azure-resurser

Använd dessa kommandon för att inspektera Azure-resurser och applikationens status.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

Verifiera agent blueprint

Bekräfta att din agentritning finns och är korrekt konfigurerad.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Verifiera ritningen i Microsoft Entra

  1. Gå till https://entra.microsoft.com>Appregistreringar>Alla applikationer.
  2. Sök efter din agentBlueprintId.

Förebyggande bästa praxis

Använd dessa rekommendationer för att undvika vanliga problem och effektivisera felsökningen.

Innan du börjar

Checklista med förutsättningar:

✅ .NET 8.0 SDK installerat
✅ Azure CLI installerat och autentiserat
✅ Nödvändiga Entra-behörigheter tilldelade
✅ Anpassad klientapp skapad och konfigurerad
✅ Klientorganisation aktiverad för Microsoft Agent 365 Frontier

Valideringskommandon:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Under utveckling

Spara dina konfigurationer:

  • Spara säkerhetskopior av konfigurationsfiler.
  • Dokumentera dina konfigurationsval.
  • Spara genererade ID:n, till exempel blueprint-ID och hanterad identitet-ID.

Håll CLI uppdaterad:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Testa stegvis:

  • Testa efter varje större steg.
  • Verifiera att steget lyckades innan du går vidare.
  • Behåll fungerande konfigurationer.

Före driftsättning

Checklista för driftsättning:

✅ Agenten fungerar lokalt i Agents Playground.
✅ Alla miljövariabler dokumenterade.
✅ Konfigurationsfiler har checkats in i versionshanteringssystemet.
✅ MCP-servrar konfigurerade och testade.
✅ Observabilitet aktiverad och verifierad.

Få ytterligare hjälp

För att granska exempelkod, rapportera problem eller söka efter befintliga problem, använd dessa kodförråd:

  • Last updated on