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.

Stage Contenu de résolution de problèmes
Générer et exécuter l’agent Authentification de Agent 365 CLI
CLI Agent 365
Enregistrement personnalisé de l’application client pour l’Agent 365 CLI
Serveur de simulation d'outillage
SDK d’observabilité de l’Agent 365 obsolète
Agents de test
Tester des agents à l'aide de Tunnels Dev
Ajouter et gérer les outils
Schéma de configuration de l’agent Plan d’agent de configuration
Déployer Deploy agent sur Azure
Déploiement de l’agent sur Amazon Web Services (AWS)
Déploiement de l’agent sur Google Cloud Platform (GCP)
Publier l’agent dans Microsoft 365 Centre d’administration Publier l'agent dans le centre d’administration de Microsoft
Créer des instances d’agent Créer des instances d’agent
Intégration groupée Intégration en masse de l’Agent 365 avec PowerShell

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.

Dépannage de l’authentification CLI

La configuration de l'Agent 365 utilise l'application entreprise Agent 365 CLI gérée par Microsoft lorsqu'elle est disponible, puis revient à une application personnalisée détenue par le locataire. Pour les étapes complètes de comportement et de vérification, voir authentification Microsoft Entra.

Symptôme Résolution
L'application gérée par Microsoft n'est pas trouvée Mettez à jour l’interface CLI et exécutez a365 setup requirements. Recherchez dans les applications d’entreprise l’identifiant f54280f4-395e-4ea8-9e48-bf2d4952aa14de l’application. Si le déploiement progressif n’a pas encore atteint votre tenant, utilisez la solution de repli avec application personnalisée.
AADSTS530035 lors de l’authentification par code de périphérique Les paramètres de sécurité ou accès conditionnel bloquent le code de l’appareil. Ne désactivez pas la politique de sécurité organisationnelle. Exécutez la CLI sur Windows natif pour utiliser WAM, ou travaillez avec votre administrateur d’identité pour utiliser une application personnalisée approuvée par un locataire.
AADSTS70007 Lors de l’authentification Mettez à jour vers la dernière version de l’interface de ligne de commande. Les versions plus anciennes pouvaient utiliser un mode réponse navigateur non pris en charge avec l’application gérée par Microsoft.
Les autorisations déléguées requises sont absentes Réexécutez a365 setup requirements . Ne modifiez pas l'application gérée par Microsoft ni ne créez une autorisation locale locataire pour celle-ci. Si vous utilisez une application appartenant au locataire, reportez-vous à L’échec de la validation CLI pendant la configuration.

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 d’entreprise Agent 365 CLI gérée par Microsoft disponible, ou application client personnalisée 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 :

  • Last updated on