Agent 365 Fehlerbehebungsanleitung

Nutzen Sie diesen Leitfaden, um Probleme im gesamten Entwicklungszyklus von Agent 365 zu diagnostizieren und zu lösen. Nutzen Sie diesen Artikel als Ausgangspunkt für die Fehlersuche und gehen Sie dann zu bestimmten Abschnitten für detaillierte Lösungen.

Schritte zur Fehlersuche

Jeder der Links in dieser Tabelle bietet Schritte zur Fehlerbehebung für bestimmte Bereiche. Der Inhalt ist nach der Entwicklungsphase des Agent 365 SDK gruppiert.

Diagnostische Befehlsreferenz

Bevor Sie sich auf spezifische Probleme einlassen, verwenden Sie diese Befehle, um den aktuellen Stand Ihrer Agent-365-Einrichtung zu überprüfen:

Überprüfen Sie CLI und Konfiguration

Verwenden Sie diese Befehle, um Ihre CLI und Konfiguration zu validieren.

# 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 Sie die Azure-Ressourcen

Verwenden Sie diese Befehle, um Azure Ressourcen und App-Status zu prü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

Agent Blueprint verifizieren

Bestätigen Sie, dass Ihr Agenten-Blueprint existiert und korrekt konfiguriert ist.

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

Überprüfung des Blueprints in Microsoft Entra

1. Wechseln Sie zu https://entra.microsoft.com>App-Registrierungen>All applications.
2. Suchen Sie nach Ihrem agentBlueprintId.

Vorbeugende beste Praktiken

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

Bevor Sie beginnen

Checkliste für Voraussetzungen:

✅ .NET 8.0 SDK installiert
✅ Azure CLI installiert und authentifiziert
✅ Erforderliche Entra-Berechtigungen sind zugewiesen worden
✅ Benutzerdefinierte Client-App erstellt und konfiguriert
✅ Tenant 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 Sie Ihre Konfigurationen:

• Führe Backups von Konfigurationsdateien auf.
• Dokumentiere deine Setup-Entscheidungen.
• Speichere generierte IDs, wie Blueprint-ID und Managed Identity ID.

Halte die CLI auf dem Laufenden:

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

Testen Sie schrittweise:

• Teste nach jedem wichtigen Schritt.
• Überprüfe den Erfolg, bevor du weitermachst.
• Behalten Sie die aktuellen Konfigurationen bei.

Vor der Bereitstellung

Checkliste vor dem Einsatz:

✅ Agent arbeitet lokal mit Agents Playground zusammen.
✅ Alle Umweltvariablen dokumentiert.
✅ Konfigurationsdateien in die Versionskontrolle übertragen.
✅ MCP-Server konfiguriert und getestet.
✅ Observabilität aktiviert und verifiziert.

Holen Sie sich zusätzliche Hilfe

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