Probleemoplossingshandleiding voor Agent 365

Gebruik deze handleiding om problemen gedurende de gehele ontwikkelingscyclus van Agent 365 te diagnosticeren en op te lossen. Gebruik dit artikel als startpunt voor het oplossen van problemen en ga vervolgens naar specifieke secties voor gedetailleerde oplossingen.

Stappen voor probleemoplossing

Elke link in deze tabel biedt probleemoplossingsstappen voor specifieke gebieden. De inhoud is gegroepeerd op basis van de fase van de Agent 365 SDK-ontwikkelingscyclus.

Fase Content voor probleemoplossing
Agent bouwen en uitvoeren Agent 365 CLI
Registratie van aangepaste client-apps voor Agent 365 CLI
Mock tooling-server
Agent-observability
Agenten testen
Agenten testen met behulp van Dev Tunnels
Tools toevoegen en beheren
Agent-blauwdruk instellen Agent-blauwdruk instellen
Implementeren Een agent implementeren in Azure
Een agent implementeren in Amazon Web Services (AWS)
Een agent implementeren in Google Cloud Platform (GCP)
Een agent publiceren naar het Microsoft 365-beheercentrum Een agent publiceren naar het Microsoft-beheercentrum
Agentexemplaren maken Agentexemplaren maken

Diagnostische opdrachtenreferentie

Gebruik voordat u in specifieke problemen, deze opdrachten om de huidige status van uw Agent 365-configuratie te controleren:

Controleer de CLI en de configuratie

Gebruik deze opdrachten om uw CLI en configuratie te valideren.

# 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

Azure-resources verifiëren

Gebruik deze opdrachten om Azure-resources en de appstatus te inspecteren.

# 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

Agent-blauwdruk controleren

Controleer of uw agent-blauwdruk bestaat en correct is geconfigureerd.

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

De blauwdruk in Microsoft Entra verifiëren

  1. Ga naar https://entra.microsoft.com>App-registraties>Alle toepassingen.
  2. Zoek naar uw agentBlueprintId.

Aanbevolen preventieve werkwijzen

Gebruik deze aanbevelingen om veelvoorkomende problemen te voorkomen en foutopsporing te vereenvoudigen.

Voordat u begint

Checklist van vereisten:

✅ .NET 8.0 SDK geïnstalleerd
✅ Azure CLI geïnstalleerd en geauthenticeerd
✅ Vereiste Entra-machtigingen toegewezen
✅ Aangepaste client-app gemaakt en geconfigureerd
✅ Tenant ingeschakeld voor Microsoft Agent 365 Frontier

Validatieopdrachten:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Tijdens ontwikkeling

Sla uw pipeline-configuraties op:

  • Bewaar back-ups van configuratiebestanden.
  • Documenteer uw configuratiekeuzes.
  • Sla gegenereerde id's op, zoals blauwdruk-id en beheerde identiteits-id.

Houd de CLI up-to-date:

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

Test stapsgewijs:

  • Test na elke belangrijke stap.
  • Controleer het resultaat voor u verder gaat.
  • Bewaar werkende configuraties.

Voor de implementatie

Checklist vóór implementatie:

✅ Agent werkt lokaal met Agents Playground.
✅ Alle omgevingsvariabelen gedocumenteerd.
✅ Configuratiebestanden vastgelegd in broncodebeheer.
✅ MCP servers geconfigureerd en getest.
✅ Observability ingeschakeld en geverifieerd.

Aanvullende hulp

Om voorbeeldcode te bekijken, problemen te melden of bestaande problemen te zoeken, raadpleeg deze repositories:

  • Last updated on