Dépanner l’interface de ligne de commande Évaluations de l’agent

Cet article fournit des informations de dépannage pour l’interface CLI des évaluations de l’agent Microsoft 365 Copilot. Les problèmes sont regroupés en fonction de la phase du flux de travail qu’ils affectent : installation, authentification, environnement d’exécution et environnement.

Problèmes d’installation

Problèmes rencontrés lors de l’installation ou de la première exécution de l’interface de ligne de commande.

Échecs d’installation

En cas npm install -g @microsoft/m365-copilot-eval d’échec :

  • Vérifiez que vous exécutez Node.js 24.12.0 ou version ultérieure : node --version.
  • Vérifiez que vous êtes autorisé à installer les packages npm globaux. Sur Unix/macOS, vous aurez peut-être besoin sudo d’une installation Node gérée par nvm.
  • Si vous vous trouvez derrière un proxy d’entreprise, consultez Problèmes de réseau ou de proxy.

runevals Commande introuvable

Si la commande n’est pas reconnue après l’installation runevals :

# Verify the package is installed globally
npm list -g @microsoft/m365-copilot-eval

# Reinstall if missing
npm install -g @microsoft/m365-copilot-eval

Si le package est listé mais que la commande est toujours introuvable, case activée que votre répertoire global bin npm se trouve sur votre PATH:

npm bin -g

Ajoutez le répertoire de sortie à votre PATH s’il est manquant.

Pré-mettre en cache l’environnement Python

L’outil télécharge un runtime Python et les dépendances lors de la première exécution. Pour configurer l’environnement à l’avance sans exécuter d’évaluations :

runevals --init-only

Ceci est utile pour :

  • Préchauffage du cache dans les pipelines CI/CD.
  • Test de la configuration sans exécuter d’évaluations.
  • Isolation des problèmes d’installation des problèmes d’évaluation.

Pour résoudre les problèmes liés à l’installation elle-même, combinez-le avec le journal de débogage :

runevals --init-only --log-level debug

Problèmes d’authentification

Problèmes liés à l’accès au locataire, à l’agent ou à Microsoft Foundry.

Erreurs d’authentification

Si l’authentification échoue :

  • Verify TENANT_ID correspond au locataire où votre agent est déployé.
  • Vérifiez que vous exécutez sur Windows. La prise en charge d’autres systèmes d’exploitation sera bientôt disponible.
  • Vérifiez que vous êtes connecté au compte Microsoft 365 approprié.
  • Si vous utilisez plusieurs clients, déconnectez-vous des autres comptes avant d’exécuter runevals.

Incompatibilité des locataires

Si l’outil se connecte mais ne renvoie aucun agent, il se peut que vous TENANT_ID ne correspondiez pas au locataire où l’agent est déployé. Vérifiez l’ID de locataire en exécutant :

az account show --query tenantId

Vous pouvez également suivre les instructions de la section Variables d’environnement obligatoires.

Erreurs de notation de la fonderie

Si la notation de l’évaluation échoue avec une erreur 401 ou 403 :

  • Vérifiez que vous êtes connecté à l’aide de l’interface de ligne de commande Azure (az login) au client qui héberge votre projet Microsoft Foundry.
  • Vérifiez que votre compte dispose du rôle de développeur IA Azure sur le projet Foundry.
  • Confirmer AZURE_AI_PROJECT_ENDPOINT pointe vers le projet Microsoft Foundry correct.
  • Vérifiez que gpt-5-mini (ou le modèle défini dans AZURE_AI_MODEL_NAME) est déployé dans votre projet Microsoft Foundry.

Problèmes d’exécution

Problèmes qui se produisent lors de l’exécution d’évaluations après une configuration réussie.

Agent introuvable

Si l’outil ne trouve pas votre agent :

  • Vérifier M365_AGENT_ID est correct. Pour les projets Agents Toolkit, l’interface CLI le détecte automatiquement à partir de M365_TITLE_ID dans .env.local, alors faites une case activée cette valeur — consultez Obtenir votre ID d’agent.
  • Confirmez que votre agent est déployé sur le locataire spécifié par TENANT_ID.
  • Vérifiez que vous êtes autorisé à accéder à l’agent.
  • Essayez de spécifier explicitement l’ID de l’agent : runevals --m365-agent-id "<your-agent-id>".

Échecs de l’évaluation

Si les évaluations démarrent mais échouent en cours d’exécution :

  • Exécutez avec la journalisation détaillée pour afficher les erreurs détaillées : runevals --log-level debug.
  • Vérifiez les codes de sortie pour la catégorie d’échec général. Voir Code de sortie dans la référence CLI.

Avertissement

L’option --log-level debug peut inclure des charges utiles d’API brutes et des données de réponse dans la sortie de la console. La rédaction est basée sur un modèle et peut ne pas intercepter toutes les informations d’identification personnelles ou personnalisées. Ne partagez pas publiquement la sortie de débogage sans examen manuel.

Problèmes d’environnement

Problèmes liés au runtime Python mis en cache, au répertoire cache ou à la connectivité réseau.

Problèmes liés au cache

L’outil d’évaluation utilise un cache local pour le runtime et les dépendances Python.

# View cache info
runevals cache-info

# Clear and rebuild the cache
runevals cache-clear
runevals --init-only --log-level debug

Problèmes liés aux autorisations

Si les opérations de cache échouent avec des erreurs d’autorisation :

# View the cache directory path
runevals cache-dir

# Fix permissions (Unix/macOS)
chmod -R u+w $(runevals cache-dir)

# Fix permissions (Windows PowerShell)
icacls "$(runevals cache-dir)" /grant ${env:USERNAME}:F /T

Problèmes de réseau ou de proxy

Si l’initialisation échoue derrière un proxy d’entreprise :

# Set proxy (Unix/macOS)
export HTTPS_PROXY=http://proxy:8080
export HTTP_PROXY=http://proxy:8080

# Set proxy (Windows PowerShell)
$env:HTTPS_PROXY="http://proxy:8080"
$env:HTTP_PROXY="http://proxy:8080"

# Retry initialization with verbose output
runevals --init-only --log-level debug

Obtenir une assistance

Si les étapes de dépannage ci-dessus ne résolvent pas votre problème, déposez un problème dans le dépôt GitHub M365 Copilot Agent Evaluations.

Avant de signaler un problème, recueillez :

  • Version CLI : runevals --version.
  • Commande exacte que vous avez exécutée.
  • Sortie d’erreur (caviarder les informations d’identification personnelle, les clés ou les identificateurs spécifiques au locataire).
  • Votre système d’exploitation et Node.js version : node --version.

Pour classer le problème :

Contenu connexe

  • Last updated on