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.

Stufe Inhalte zur Problembehandlung
Agent erstellen und ausführen Agent 365 CLI-Authentifizierung
Agent 365 CLI
Registrierung einer benutzerdefinierten Client-App für Agent 365 CLI
Mock-Tooling-Server
Agent-Observabilität
Testmittel
Testagenten mit Dev Tunnels testen
Hinzufügen und Verwalten von Tools
Setup-Agent-Blueprint Setup-Agent-Blueprint
Bereitstellen Deploy agent to Azure
Agent auf Amazon Web Services (AWS) deployen
Agent auf Google Cloud Platform (GCP) deployen
Agent im Microsoft 365 Admin Center veröffentlichen Agent veröffentlichen im Microsoft Admin Center
Agent-Instanzen erstellen Agent-Instanzen erstellen

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.

Fehlerbehebung der CLI-Authentifizierung

Die Agent-365-Einrichtung verwendet die von Microsoft verwaltete Agent 365 CLI-Enterprise-Anwendung, wenn sie verfügbar ist, und greift auf eine kundeneigene App zurück. Für vollständige Verhaltens- und Verifikationsschritte siehe Microsoft Entra-Authentifizierung.

Symptom Resolution
Eine von Microsoft verwaltete Anwendung wird nicht gefunden Aktualisiere die CLI und führe a365 setup requirements. Durchsuche Unternehmensanwendungen nach Anwendungs-ID f54280f4-395e-4ea8-9e48-bf2d4952aa14. Wenn der gestufte Rollout deinen Mieter noch nicht erreicht hat, nutze den Fallback der benutzerdefinierten App.
AADSTS530035 Während der Gerätecode-Authentifizierung Security Defaults oder Conditional Access blockiert Gerätecode. Deaktivieren Sie die Sicherheitsrichtlinien der Organisation nicht. Führe die CLI auf nativem Windows aus, um WAM zu nutzen, oder arbeite mit deinem Identitätsadministrator zusammen, um eine genehmigte, vom Mieter eigene App zu verwenden.
AADSTS70007 Während der Authentifizierung Update zur neuesten CLI. Ältere Versionen konnten einen nicht unterstützten Browser-Antwortmodus mit der von Microsoft verwalteten Anwendung verwenden.
Erforderliche delegierte Aufgabenbereiche fehlen Führen Sie a365 setup requirements erneut aus. Ändere die von Microsoft verwaltete Anwendung nicht und erstelle keine tenant-lokale Berechtigung dafür. Wenn Sie eine mandanteneigene App verwenden, befolgen Sie die Anweisungen unter CLI-Validierung schlägt während der Konfiguration fehl.

Vorbeugende beste Praktiken

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

Bevor du anfängst

Checkliste für Voraussetzungen:

✅ .NET 8.0 SDK installiert
✅ Azure CLI installiert und authentifiziert
✅ Erforderliche Entra-Berechtigungen sind zugewiesen worden
✅ Von Microsoft verwaltete Agent 365 CLI-Unternehmens-App verfügbar oder benutzerdefinierte Client-App 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 Quellcodeverwaltung übernommen.
✅ 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:

  • Last updated on