Guide de dépannage d’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 consultez des sections spécifiques afin d’obtenir des solutions détaillées.

Étapes de dépannage

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

Phase Contenu de dépannage
Créer et exécuter un assistant CLI Agent 365
Enregistrement personnalisé de l’application client pour l’Agent 365 CLI
Serveur d’outils fictifs
Observabilité de l’assistant
Test des assistants
Tester les assistants à l’aide de Dev Tunnels
Ajouter et gérer les outils
Configurer le blueprint de l’assistant Configurer le blueprint de l’assistant
Déployer Déployer l’assistant sur Azure
Déployer l’assistant sur Amazon Web Services (AWS)
Déployer l’assistant sur Google Cloud Platform (GCP)
Publier un assistant dans le centre d’administration Microsoft 365 Publier un assistant dans le centre d’administration Microsoft
Créer des instances d’assistant Créer des instances d’assistant

Référence des commandes de diagnostic

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

Vérifier la CLI et la configuration

Utiliser 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 les ressources Azure

Utiliser 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 blueprint de l’assistant

Confirmer que votre blueprint d’assistant 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>Toutes les applications.
  2. Recherchez votre agentBlueprintId.

Bonnes pratiques préventives

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

Avant de commencer

Vérifications des conditions préalables :

✅ SDK .NET 8.0 installé
✅ Azure CLI installé et authentifié
✅ Autorisations Entra requises attribuées
✅ Application cliente personnalisée créée et configurée
✅ Locataire activé pour 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

Enregistrez vos configurations :

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

Maintenez la CLI à jour :

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

Tester progressivement :

  • Testez après chaque étape majeure.
  • Vérifiez la réussite avant de passer à l’étape suivante.
  • Conservez les configurations fonctionnelles.

Avant le déploiement

Liste de contrôle avant déploiement :

✅ L’assistant fonctionne localement avec Agents Playground.
✅ Toutes les variables d’environnement sont documentées.
✅ Fichiers de configuration sous contrôle de code source.
✅ Serveurs MCP configurés et testés.
✅ Observabilité activée et vérifiée.

Obtenir une aide supplémentaire

Pour consulter des exemples de code, signaler des problèmes ou rechercher des problèmes existants, utilisez ces dépôts :

  • Last updated on