Risolvere i problemi relativi alla CLI delle valutazioni di Microsoft 365 Copilot

Questo articolo fornisce informazioni sulla risoluzione dei problemi per l'interfaccia della riga di comando delle valutazioni di Microsoft 365 Copilot. Le sezioni seguenti raggruppano i problemi in base alla fase del flusso di lavoro su cui influiscono: configurazione, autenticazione, runtime e ambiente.

Problemi di configurazione

Problemi riscontrati durante l'installazione o durante l'esecuzione dell'interfaccia della riga di comando per la prima volta.

Errori di installazione

Se npm install -g @microsoft/m365-copilot-eval fallisce:

  • Verificare che sia in esecuzione Node.js 24.12.0 o versione successiva: node --version.
  • Verifica di avere l'autorizzazione per installare i pacchetti npm globali. Su Unix/macOS, potrebbe essere necessaria sudo un'installazione di Node gestita da nvm.
  • Se si sta dietro a un proxy aziendale, vedere Problemi di rete o proxy.

runevals Comando non trovato

Se il comando non viene riconosciuto dopo l'installazione runevals :

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

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

Se il pacchetto è elencato ma il comando non è ancora stato trovato, controlla che la directory globale bin npm si trovi nel tuo PATH:

npm bin -g

Aggiungi la directory di output alla tua PATH se manca.

Pre-memorizzare nella cache l'ambiente Python

Lo strumento scarica un runtime Python e le dipendenze alla prima esecuzione. Per configurare l'ambiente in anticipo senza eseguire valutazioni:

runevals --init-only

Ciò è utile per:

  • Preriscaldamento della cache nelle pipeline CI/CD.
  • Test della configurazione senza eseguire valutazioni.
  • Isolamento dei problemi di installazione da quelli di valutazione.

Per risolvere i problemi relativi alla configurazione stessa, combinarla con la registrazione di debug:

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

Problemi di autenticazione

Problemi con l'accesso al tenant, all'agente o a Microsoft Foundry.

Errori di autenticazione

Se l'autenticazione non riesce:

  • Verificare TENANT_ID che corrisponda al tenant in cui è distribuito l'agente.
  • Conferma che è in esecuzione Windows. Il supporto per altri sistemi operativi è in arrivo.
  • Assicurarsi di aver effettuato l'accesso all'account Microsoft 365 corretto.
  • Se si usano più tenant, disconnettersi da altri account prima dell'esecuzione runevals.

Mancata corrispondenza del tenant

Se lo strumento si connette ma non restituisce alcun agente, è possibile che il TENANT_ID tenant in cui è distribuito l'agente non corrisponda. Verificare l'ID tenant eseguendo:

az account show --query tenantId

Puoi anche seguire le istruzioni in Variabili di ambiente richieste.

Errori di punteggio di Foundry

Se il punteggio di valutazione non riesce con un errore 401 o 403:

  • Verificare di aver eseguito l'accesso usando l'interfaccia della riga di comando di Azure (az login) al tenant che ospita il progetto Microsoft Foundry.
  • Verificare che l'account disponga del ruolo di sviluppatore IA di Azure per il progetto Foundry.
  • Conferma AZURE_AI_PROJECT_ENDPOINT che punta al progetto Microsoft Foundry corretto.
  • Verificare che gpt-5-mini (o il modello impostato in AZURE_AI_MODEL_NAME) sia distribuito nel progetto Microsoft Foundry.

Problemi di runtime

Problemi che si verificano durante l'esecuzione di valutazioni dopo una configurazione riuscita.

Agente non trovato

Se lo strumento non riesce a trovare il tuo agente:

  • La verifica M365_AGENT_ID è corretta. Per i progetti Agents Toolkit, l'interfaccia a riga di comando lo rileva automaticamente da M365_TITLE_ID , .env.localquindi controlla questo valore: consulta Ottenere l'ID agente.
  • Verificare che l'agente sia distribuito nel tenant specificato da TENANT_ID.
  • Assicurarsi di avere l'autorizzazione necessaria per accedere all'agente.
  • Provare a specificare esplicitamente l'ID agente: runevals --m365-agent-id "<your-agent-id>".

Errori di valutazione

Se le valutazioni vengono avviate ma non riescono a metà corsa:

  • Eseguire con registrazione dettagliata per visualizzare gli errori dettagliati: runevals --log-level debug.
  • Controllare i codici di uscita per la categoria di errore generale. Vedere Codici di uscita nel riferimento CLI.

Avviso

L'opzione può includere payload API non elaborati e dati di risposta nell'output --log-level debug della console. L'oscuramento è basato su modelli e potrebbe non rilevare tutte le informazioni personali o le credenziali personalizzate. Non condividere pubblicamente l'output a livello di debug senza una revisione manuale.

Problemi di valutazione delle chiamate agli strumenti (anteprima v2)

ToolCallSelection e ToolCallExecution richiedono @microsoft/m365-copilot-eval@preview e schema v2. Non sono disponibili nella versione 1 (latest).

Sintomo Azione
toolCallNotAllowed Esaminare gli identificatori di consenso richiesti e approvare le operazioni previste con default_allowed_tools o allowed_tools. Le aspettative del valutatore non concedono il consenso.
toolCallEvidenceIndeterminate Verificare diagnostics.tool_calls la presenza di prove non disponibili o risultati HTTP che non possono essere analizzati. Un errore non è un pass o necessariamente un difetto dell'agente.
La chiamata prevista non trova corrispondenza Controllare le opzioni con distinzione tra plugin_idmaiuscole e minuscole e function_name. toolset_id plugin_id è l'ID del titolo del pacchetto, non plugin.id.
I risultati delle chiamate di utensili salvati non possono essere valutati nuovamente Verificare che gli elementi salvati o i turni includano response e mantengano la diagnostica. Le prove soppresse con EVALS_SUPPRESS_DIAGNOSTICS=true non sono disponibili per la riproduzione.
La valutazione di un plug-in è destinata a un agente Rimuovere M365_AGENT_ID e legacy AGENT_ID dalla shell e dai file di ambiente caricati e omettere --m365-agent-id.

Per i comandi di individuazione, gli esempi e la distinzione tra errori ed errori, vedere Analizzatori di chiamate di strumenti.

Problemi ambientali

Problemi con il runtime Python memorizzato nella cache, la directory della cache o la connettività di rete.

Problemi di cache

Lo strumento di valutazione utilizza una cache locale per il runtime Python e le dipendenze.

# View cache info
runevals cache-info

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

Problemi di autorizzazione

Se le operazioni della cache hanno esito negativo con errori di autorizzazione:

# 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

Problemi di rete o proxy

Se l'inizializzazione non riesce dietro un proxy aziendale:

# 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

Contattaci

Se i passaggi per la risoluzione dei problemi descritti in precedenza in questo articolo non consentono di risolvere il problema, inviare un problema nel repository GitHub Valutazioni di Microsoft 365 Copilot.

Prima di presentare un problema, raccogli:

  • La versione CLI: runevals --version.
  • Il comando esatto che hai eseguito.
  • Output degli errori (oscurare eventuali informazioni personali, chiavi o identificatori specifici del tenant).
  • Il sistema operativo e Node.js versione: node --version.

Per segnalare il problema: