Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
sudoun'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_IDche 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_ENDPOINTche punta al progetto Microsoft Foundry corretto. - Verificare che
gpt-5-mini(o il modello impostato inAZURE_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 daM365_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:
- Apri un nuovo problema in Problemi di valutazione di Microsoft 365 Copilot.
- Applicare l'etichetta appropriata (ad esempio,
setup, ,authenticationruntime,environment) per facilitare la valutazione.