Guide de dépannage de l’Agent 365

Utilisez ce guide pour diagnostiquer et résoudre les problèmes tout au long du cycle de développement de l’Agent 365. Utilisez cet article comme point de départ pour le dépannage, puis allez dans des sections spécifiques pour des solutions détaillées.

Étapes de résolution des problèmes

Chacun des liens de ce tableau fournit des étapes de dépannage pour des zones spécifiques. Le contenu est regroupé par étape du cycle de développement du SDK de l’Agent 365.

Référence des commandes de diagnostic

Avant de vous lancer dans des problèmes spécifiques, utilisez ces commandes pour vérifier l’état actuel de votre configuration Agent 365 :

Vérifiez la CLI et la configuration

Utilisez ces commandes pour valider votre CLI et votre configuration.

# 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

Vérifier Azure ressources

Utilisez ces commandes pour inspecter les ressources Azure et l’état de l’application.

# 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

Vérifier le plan de l’agent

Confirmez que votre plan d’agent existe et est correctement configuré.

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

Vérifier le blueprint dans Microsoft Entra

1. Accédez à https://entra.microsoft.com>inscriptions d'applications>All applications.
2. Cherchez votre agentBlueprintId.

Meilleures pratiques préventives

Utilisez ces recommandations pour éviter les problèmes courants et simplifier le dépannage.

Avant de commencer

Liste des prérequis :

✅ .NET SDK 8.0 installé
✅ Azure CLI installé et authentifié
✅ Autorisations Entra requises attribuées
✅ Application client personnalisée créée et configurée
✅ Client activé avec Microsoft Agent 365 Frontier

Commandes de validation :

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

Pendant le développement

Sauvegardez vos configurations :

• Gardez des sauvegardes des fichiers de configuration.
• Documentez vos choix d’installation.
• Sauvegardez les identifiants générés, tels que l’ID de blueprint et l’ID d’identité gérée.

Tenez la CLI informée :

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

Tester progressivement :

• Testez après chaque étape majeure.
• Vérifiez votre succès avant de passer à autre chose.
• Conservez les configurations opérationnelles.

Avant le déploiement

Liste de contrôle avant déploiement :

✅ L’agent travaille localement avec Agents Playground.
✅ Toutes les variables de l’environnement sont documentées.
✅ Fichiers de configuration engagés dans le contrôle de version.
✅ Serveurs MCP configurés et testés.
✅ Observabilité activée et vérifiée.

Obtenez de l’aide supplémentaire

Pour revoir un code d’exemple, signaler des problèmes ou rechercher des problèmes existants, utilisez ces dépôts :

• Exemples d’Agent 365
• Agent 365 DevTools (CLI)
• Kit de développement logiciel (SDK) Agent 365 - .NET
• sdk Agent 365 - Python
• SDK Agent 365 - Node.js