Vejledning til fejlfinding i Agent 365

Brug denne guide til at identificere og løse problemer i hele Agent 365-udviklingslivscyklussen. Brug denne artikel som udgangspunkt til fejlfinding, og find detaljerede løsninger i de relevante sektioner.

Fejlfindingstrin

Hvert enkelt link i denne tabel indeholder trin til fejlfinding for specifikke områder. Indholdet er organiseret efter faserne i Agent 365 SDK-udviklingslivscyklussen.

Trin Fejlfindingsindhold
Lav og kør agent Agent 365 CLI
Registrering af brugerdefineret klientapp til Agent 365 CLI
Simuleret værktøjsserver
Agent-observerbarhed
Test af agenter
Test agenter ved at bruge Dev Tunnels
Tilføje og administrere værktøjer
Opsæt agent-blueprint Opsæt Agent Blueprint
Udrulle Udrul agent i Azure
Udrul agent til Amazon Web Services (AWS)
Udrul agent til Google Cloud Platform (GCP)
Publicer agent til Microsoft 365 Administration Publicer agent til Microsoft Administration
Opret agentforekomster Opret agentforekomster

Reference til diagnosticeringskommandoer

Før du læser mere om specifikke problemer, kan du bruge disse kommandoer til at kontrollere din Agent 365-opsætnings aktuelle tilstand:

Kontroller CLI og konfiguration

Brug disse kommandoer til at validere din CLI og 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

Bekræft Azure-ressourcer

Brug disse kommandoer til at undersøge Azure-ressourcer og appens 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

Verificér agentens blueprint

Bekræft, at dit agent-blueprint eksisterer og er korrekt konfigureret.

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

Bekræft blueprint i Microsoft Entra

  1. Gå til https://entra.microsoft.com>Appregistreringer>Alle programmer.
  2. Søg efter din agentBlueprintId.

Forebyggende bedste praksis

Brug disse anbefalinger til at undgå almindelige problemer og effektivisere fejlfindingen.

Før du begynder

Kontrol af forudsætninger:

✅ .NET 8.0 SDK installeret
✅ Azure CLI installeret og autentificeret
✅ Påkrævede tildelte Entra-tilladelser
✅ Brugerdefineret klientapp oprettet og konfigureret
✅ Lejer aktiveret for Microsoft Agent 365 Frontier

Valideringskommandoer:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Under udvikling

Gem dine pipeline-konfigurationer:

  • Gem sikkerhedskopier af konfigurationsfiler.
  • Dokumentér dine konfigurationsvalg.
  • Gem de genererede ID'er, f.eks. blueprint-ID og administreret identitets-ID.

Hold CLI opdateret:

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

Test trinvis:

  • Test efter hvert større trin.
  • Bekræft, at det virker, før du går videre.
  • Bevar fungerende konfigurationer.

Før udrulning

Tjekliste før udrulning:

✅ Agent fungerer lokalt med Agents Playground.
✅ Alle dokumenterede miljøvariabler
✅ Konfigurationsfiler tilføjet i versionskontrol.
✅ MCP-servere konfigureret og testet.
✅ Observability aktiveret og verificeret.

Få yderligere hjælp

Brug disse lagre til at gennemgå eksempelkode, anmelde problemer eller søge i nuværende problemer:

  • Last updated on