Partager via

Guide de dépannage de l’Agent 365

Important

Vous devez faire partie du programme de prévisualisation Frontier pour accéder en anticipation à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations en IA de Microsoft. Les aperçus Frontier sont soumis aux conditions d’aperçu existantes de vos contrats clients. Comme ces fonctionnalités sont encore en développement, leur disponibilité et leurs capacités peuvent évoluer avec le temps.

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.

Étape Contenu de dépannage
Build and run agent Agent 365 CLI
Enregistrement personnalisé de l’application client pour l’Agent 365 CLI
Serveur d’outils mock
Observabilité de l’agent
Agents de test
Configuration de l’agent de configuration 365 Configurer la configuration de l’Agent 365
Ajouter et gérer les outils
Plan d’agent de configuration Plan d’agent de configuration
Deploy Deploy agent to Azure
Déploiement de l’agent sur Amazon Web Services (AWS)
Déploiement de l’agent sur Google Cloud Platform (GCP)
Publier l’agent vers le centre d’administration Microsoft 365 Publier l’agent vers Microsoft admin Center
Créer des instances d’agent Créer des instances d’agent

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
a365 config display

# Display generated configuration (after setup)
a365 config display -g

Verify Azure resources

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
a365 config display -g | Select-String "agentBlueprintId"

Verify blueprint dans Microsoft Entra

  1. Aller à https://entra.microsoft.com>Inscriptions aux applications Toutes>les candidatures.
  2. Cherchez votre agentBlueprintIdfichier .

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 :

✅ SDK .NET 8.0 installé
✅ Azure CLI installé et authentifié
✅ Autorisations Entra requises attribuées
✅ Application client 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

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é mangée.

Tenez la CLI informée :

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

Tester progressivement :

  • Testez après chaque étape majeure.
  • Vérifiez votre succès avant de passer à autre chose.
  • Continuez à faire fonctionner des configurations.

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