Agent 365 Anleitung für die Problembehandlung

Nutzen Sie diesen Leitfaden, um Probleme im gesamten Agent 365-Entwicklungslebenszyklus zu diagnostizieren und zu beheben. Nutzen Sie diesen Artikel als Ausgangspunkt für die Fehlerbehebung und wechseln Sie zu spezifischen Abschnitten für detaillierte Lösungen.

Problembehandlungsschritte

Jeder Link in dieser Tabelle bietet Fehlerbehebungsschritte für spezifische Bereiche. Der Inhalt ist nach den einzelnen Phasen des Entwicklungslebenszyklus des Agent 365 SDK gruppiert.

Referenz der Diagnosebefehle

Bevor Sie sich mit spezifischen Problemen beschäftigen, verwenden Sie diese Befehle, um den aktuellen Stand Ihrer Agent 365-Einrichtung zu überprüfen:

Überprüfung von CLI und Konfiguration

Verwenden Sie diese Befehle, um Ihre CLI und Konfiguration zu überprüfen.

# 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

Überprüfen der Azure-Ressourcen

Verwenden Sie diese Befehle, um Azure-Ressourcen und den App-Status zu überprüfen.

# 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

Überprüfen Sie den Agent-Blueprint

Stellen Sie sicher, dass Ihr Agent-Blueprint vorhanden und korrekt konfiguriert ist.

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

Agent-Blueprint in Microsoft Entra überprüfen

1. Gehen Sie zu https://entra.microsoft.com>App-Registrierungen>Alle Anwendungen.
2. Suche nach Ihrer agentBlueprintId.

Vorbeugende Best Practices

Nutzen Sie diese Empfehlungen, um häufige Probleme zu vermeiden und die Fehlersuche zu erleichtern.

Bevor Sie beginnen

Voraussetzungen-Checkliste

✅ .NET 8.0 SDK installiert
✅ Azure CLI installiert und authentifiziert
✅ Erforderliche Entra-Berechtigungen zugewiesen
✅ Benutzerdefinierte Client-App erstellt und konfiguriert
✅ Mandant aktiviert für Microsoft Agent 365 Frontier

Validierungsbefehle:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Während der Entwicklung

Speichern Ihrer Konfigurationen:

• Bewahren Sie Backups von Konfigurationsdateien auf.
• Dokumentieren Sie Ihre Einrichtungsentscheidungen.
• Speichern Sie generierte IDs, wie Blueprint-ID und verwaltetete Identität-ID.

Halten Sie CLI auf dem Laufenden:

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

Schrittweise testen:

• Testen Sie nach jedem wichtigen Schritt.
• Stellen Sie sicher, dass der vorherige Schritt erfolgreich war, bevor Sie fortfahren.
• Behalten Sie funktionierende Konfigurationen bei.

Vor der Bereitstellung

Checkliste vor der Bereitstellung

✅ Agent läuft lokal mit Agents Playground.
✅ Alle Umgebungsvariablen dokumentiert.
✅ Konfigurationsdateien in die Quellcodeverwaltung übernommen.
✅ MCP-Server konfiguriert und getestet.
✅ Einblick aktiviert und verifiziert.

Zusätzliche Hilfe abrufen

Um Beispielcode zu überprüfen, Probleme zu melden oder bestehende Probleme zu durchsuchen, verwenden Sie diese Repositories:

• Agent 365 Beispiele
• Agent 365 DevTools (CLI)
• Agent 365 SDK - .NET
• Agent 365 SDK - Python
• Agent 365 SDK - Node.js