Solucionar problemas de la CLI de evaluaciones de agentes

En este artículo se proporciona información para la solución de problemas de la CLI de evaluaciones del agente de Microsoft 365 Copilot. Los problemas se agrupan por la fase del flujo de trabajo al que afectan: configuración, autenticación, tiempo de ejecución y entorno.

Problemas de configuración

Problemas surgidos durante la instalación o al ejecutar la CLI por primera vez.

Errores de instalación

Si npm install -g @microsoft/m365-copilot-eval se produce un error:

  • Comprueba que estás ejecutando Node.js 24.12.0 o posterior: node --version.
  • Compruebe que tiene permiso para instalar paquetes npm globales. En Unix/macOS, es posible que necesite sudo una instalación de nodo administrado por nvm.
  • Si está detrás de un proxy corporativo, consulte Problemas de red o proxy.

runevals No se ha encontrado el comando

Si el comando no se reconoce después de la runevals instalación:

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

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

Si el paquete aparece en la lista, pero el comando sigue sin encontrarse, compruebe que el directorio global bin de npm está en su PATH:

npm bin -g

Agregue el directorio de salida si PATH falta.

Almacenamiento en caché previo del entorno de Python

La herramienta descarga un entorno de ejecución de Python y dependencias en la primera ejecución. Para configurar el entorno con antelación sin ejecutar evaluaciones:

runevals --init-only

Esto es útil para:

  • Precalentamiento de la caché en canalizaciones de CI/CD.
  • Probar la configuración sin ejecutar evaluaciones.
  • Aislar los problemas de instalación de los problemas de evaluación.

Para solucionar problemas del programa de instalación, combínelo con el registro de depuración:

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

Problemas de autenticación

Problemas con el acceso al inquilino, al agente o a Microsoft Foundry.

Errores de autenticación

Si se produce un error en la autenticación:

  • La comprobación TENANT_ID coincide con el inquilino donde se implementa el agente.
  • Confirma que estás ejecutando en Windows. La compatibilidad con otros sistemas operativos estará disponible próximamente.
  • Asegúrese de haber iniciado sesión en la cuenta de Microsoft 365 correcta.
  • Si está usando varios inquilinos, cierre la sesión de otras cuentas antes de ejecutar runevals.

Error de coincidencia de inquilinos

Si la herramienta se conecta pero no devuelve ningún agente, TENANT_ID es posible que no coincida con el inquilino en el que está implementado el agente. Compruebe el identificador del inquilino ejecutando:

az account show --query tenantId

También puede seguir las instrucciones de Variables de entorno requeridas.

Errores de puntuación de Fundición

Si se produce un error en la puntuación de la evaluación con un error 401 o 403:

  • Compruebe que ha iniciado sesión mediante la CLI de Azure (az login) en el inquilino que hospeda el proyecto de Microsoft Foundry.
  • Confirme que su cuenta tiene el rol de desarrollador de IA de Azure en el proyecto de Fundición.
  • La confirmación AZURE_AI_PROJECT_ENDPOINT apunta al proyecto correcto de Microsoft Foundry.
  • Compruebe que gpt-5-mini (o el modelo establecido en AZURE_AI_MODEL_NAME) se implementa en el proyecto de Microsoft Foundry.

Problemas relacionados con el tiempo de ejecución

Problemas que se producen al ejecutar evaluaciones después de una instalación correcta.

Agente no encontrado

Si la herramienta no encuentra al agente:

  • La verificación M365_AGENT_ID es correcta. Para los proyectos de Agents Toolkit, la CLI lo detecta automáticamente desde en .env.local, así que compruebe ese valor en su lugar. Consulte Obtener el ID de M365_TITLE_ID agente.
  • Confirme que el agente se implementa en el inquilino especificado por TENANT_ID.
  • Asegúrese de que tiene permiso para acceder al agente.
  • Pruebe a especificar el ID de agente explícitamente: runevals --m365-agent-id "<your-agent-id>".

Errores de evaluación

Si las evaluaciones se inician, pero se produce un error a mitad de la ejecución:

  • Ejecute con el registro detallado para ver los errores detallados: runevals --log-level debug.
  • Compruebe los códigos de salida para la categoría de error general. Consulte Códigos de salida en la referencia de la CLI.

Advertencia

La --log-level debug opción puede incluir cargas útiles de API sin procesar y datos de respuesta en la salida de la consola. La redacción se basa en patrones y es posible que no detecte toda la información de identificación personal o las credenciales personalizadas. No comparta públicamente los resultados de nivel de depuración sin una revisión manual.

Problemas de entorno

Problemas con el tiempo de ejecución de Python almacenado en caché, el directorio de caché o la conectividad de red.

Problemas de caché

La herramienta de evaluación usa una caché local para el tiempo de ejecución y las dependencias de Python.

# View cache info
runevals cache-info

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

Problemas de permisos

Si las operaciones de caché presentan errores de permiso:

# 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

Problemas de red o proxy

Si se produce un error en la inicialización detrás de un proxy corporativo:

# 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

Obtener soporte técnico

Si los pasos de solución de problemas anteriores no resuelven el problema, presente un problema en el repositorio de GitHub Evaluaciones de agente de M365 Copilot.

Antes de presentar un problema, recopile:

  • Versión de la CLI: runevals --version.
  • El comando exacto que ejecutó.
  • Salida del error (redactar cualquier información de identificación personal, claves o identificadores específicos del inquilino).
  • Su sistema operativo y Node.js versión: node --version.

Para archivar el problema:

Contenido relacionado

  • Se actualizó por última vez el