Feilsøkingsveiledning for Agent 365

Bruk denne guiden til å diagnostisere og løse problemer gjennom hele Agent 365-utviklingslivssyklusen. Bruk denne artikkelen som utgangspunkt for feilsøking, og gå deretter til spesifikke seksjoner for detaljerte løsninger.

Feilsøkingstrinn

Hver lenke i denne tabellen gir feilsøkingstrinn for spesifikke områder. Innholdet er gruppert etter stadiet i Agent 365 SDK-utviklingslivssyklusen.

Fase Feilsøkingsinnhold
Bygg og kjør agent Agent 365 CLI
Registrering av egendefinert klientapp for Agent 365 CLI
Mock verktøyserver
Agentobserverbarhet
Testing av agenter
Test agenter med Dev Tunnels
Legg til og administrer verktøy
Sett opp agent blueprint Sett opp agent blueprint
Rull ut Rull ut agenten til Azure
Distribuer agenten til Amazon Web Services (AWS)
Distribuer agenten til Google Cloud Platform (GCP)
Publiser agent til Administrasjonssenter for Microsoft 365 Publiser agenten til administrasjonssenteret for Microsoft
Opprett agentinstanser Opprett agentinstanser

Diagnostikkommandoer – referanse

Før du går inn i konkrete problemer, bruk disse kommandoene for å sjekke den gjeldende tilstanden til ditt Agent 365-oppsett:

Sjekk CLI og konfigurasjon

Bruk disse kommandoene for å kontrollere CLI og konfigurasjon.

# 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

Verifiser Azure-ressursene

Bruk disse kommandoene for å kontrollere Azure-ressurser og appstatus.

# 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

Verifiser agentens blueprint

Forsikre deg om at agentmalen din eksisterer og er korrekt konfigurert.

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

Verifiser blueprint i Microsoft Entra

  1. Gå til https://entra.microsoft.com>App-registreringer>Alle applikasjoner.
  2. Søk etter appen agentBlueprintId.

Forebyggende beste praksiser

Bruk disse anbefalingene for å unngå vanlige problemer og effektivisere feilsøkingen.

Før du starter

Sjekkliste for forutsetninger:

✅ .NET 8.0 SDK installert
✅ Azure CLI installert og autentisert
✅ Påkrevde Entra-tillatelser tildelt
✅ Egendefinert klientapp opprettet og konfigurert
✅ Leietaker aktivert for Microsoft Agent 365 Frontier

Valideringskommandoer:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Under utvikling

Lagre pipelinekonfigurasjonene:

  • Ta sikkerhetskopier av konfigurasjonsfiler.
  • Dokumenter oppsettvalg.
  • Lagre genererte ID-er, som blueprint-ID og ID for administrert identitet.

Hold CLI oppdatert:

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

Test inkrementelt:

  • Test etter hvert større trinn.
  • Bekreft suksess før du går videre.
  • Fortsett å jobbe med konfigurasjoner.

Før utplassering

Sjekkliste før utplassering:

✅ Agenten fungerer lokalt med Agents Playground.
✅ Alle miljøvariabler dokumentert.
✅ Konfigurasjonsfiler kommittert til kildekontroll
✅ MCP-servere konfigurert og testet
✅ Observability aktivert og verifisert.

Få ytterligere hjelp

For å gjennomgå eksempelkode, rapportere problemer eller søke i eksisterende problemer, bruk disse repositoriene:

  • Last updated on