Referencia de códigos de error para agentes (GitHub Copilot)

Cuando un agente impulsado por el arnés GitHub Copilot no puede completar un turno, las pestañas Previsualización, Prueba y Evaluar muestran un mensaje de error junto con un código de error corto. El código de error identifica la causa para que puedas decidir si intentas de nuevo, cambias tu entrada o contactas con tu administrador.

Note

El arnés utilizado para construir este agente utiliza facturación basada en el uso. Usar, construir, probar y evaluar agentes puede consumir créditos de Copilot. Más información en Resumen de la facturación basada en el uso.

Donde ves los códigos de error

Los códigos de error aparecen en varios lugares en agentes alimentados por el arnés GitHub Copilot:

Resumen del código de error

La siguiente tabla resume cada código de error, si reintentarlo suele ayudar y si el siguiente paso recae en ti (el creador), el usuario final o tu administrador.

Error code Meaning Reintentar suele ayudar Action owner
CONTENT_FILTERED Una política de seguridad de contenido bloqueaba la solicitud o respuesta. No, con la misma entrada End user
CONTEXT_LENGTH_EXCEEDED La petición era demasiado grande para el modelo. No, con la misma entrada Maker
CONVERSATION_BUSY Un mensaje anterior sigue en proceso para la misma conversación. Sí, después de que termine el turno anterior End user
CROSS_GEO_NOT_ALLOWED La configuración de residencia de datos de tu inquilino impide que la solicitud se procese. No Administrator
DEPLOYMENT_NOT_FOUND No se pudo localizar el despliegue del modelo de IA configurado. No Administrador o fabricante
MODEL_CONSENT_DENIED El modelo de IA seleccionado no está habilitado para tu organización. No Administrator
QUOTA_EXCEEDED La cuota de servicios de IA de tu organización se ha agotado. Sí, después de esperar más Administrator
RATE_LIMIT_REACHED El servicio de IA está temporalmente ocupado. Sí, después de una breve espera End user
SYSTEM_ERROR Ocurrió un error inesperado que requiere investigación. A veces; Inténtalo de nuevo antes de escalar Support

El resto de este artículo describe cada código en detalle.

CONTENT_FILTERED

Una política de seguridad de contenido bloqueaba la solicitud o respuesta.

Lo que suele significar

Las políticas de seguridad de contenido de Microsoft abarcan categorías como odio, violencia, contenido sexual, autolesiones, intentos de fuga y ataques indirectos. Ya sea la solicitud del usuario o la respuesta del agente activaron alguna de estas categorías.

Qué hacer

  • Reformula la solicitud para evitar el contenido marcado.
  • Para los agentes que frecuentemente detectan este error en entradas legítimas, refina las Instrucciones en la pestaña Build para aclarar el alcance previsto del agente. Más información en Configurar identidad e instrucciones del agente (vista previa).
  • El agente no revela qué categoría se activó para evitar filtraciones de información. Si necesitas investigar un caso específico, contacta con tu administrador con el ID de conversación del rastreo de actividad.

CONTEXT_LENGTH_EXCEEDED

La solicitud superó el tamaño máximo de entrada del modelo de IA.

Lo que suele significar

El tamaño combinado de las instrucciones del agente, el historial de conversaciones, las definiciones de la herramienta y cualquier resultado de la herramienta es mayor de lo que el modelo puede procesar en un solo turno. Las conversaciones largas y la gran cantidad de herramientas son las causas más comunes.

Qué hacer

CONVERSATION_BUSY

Un mensaje anterior en la misma conversación sigue en proceso.

Lo que suele significar

El agente procesa un turno a la vez dentro de una sola conversación. Si envías un segundo mensaje antes de que termine el turno anterior, el nuevo mensaje no puede empezar hasta que el agente complete el turno en curso.

Qué hacer

  • Espera a que termine la respuesta anterior y luego envía el nuevo mensaje.
  • Si enviaste el segundo mensaje por error (por ejemplo, haciendo doble clic en Enviar), no tomes ninguna medida. El duplicado es rechazado y el turno original continúa.
  • Si el agente aparece atascado en un turno anterior, inicia una nueva conversación. Más información en Gestionar conversaciones de vista previa (vista previa).

CROSS_GEO_NOT_ALLOWED

La configuración de residencia de datos de tu inquilino no permite procesar la solicitud en otra región.

Lo que suele significar

La política de tu organización exige que los datos permanezcan dentro de una región específica, y no hay despliegue dentro de la región del modelo solicitado disponible para tu inquilino.

Qué hacer

  • Contacta con tu administrador para cualquiera de:
    • Habilitar el movimiento de datos entre regiones para servicios de IA en configuraciones de tenido, o
    • Proporciona un despliegue del modelo dentro de la región.
  • Como creador, cambia el modelo del agente por uno que esté desplegado en tu región. Más información en Seleccionar un modelo de agente (vista previa).

DEPLOYMENT_NOT_FOUND

No se puede encontrar el despliegue del modelo de IA configurado.

Lo que suele significar

El modelo que tu agente está configurado para usar fue retirado, eliminado o no está disponible en tu entorno. Este comportamiento puede ocurrir después de que un modelo sea obsoleto o tras un cambio en la configuración del inquilino.

Qué hacer

  • En la pestaña Build , abre el selector de modelos y selecciona un modelo disponible. Más información en Seleccionar un modelo de agente (vista previa).
  • Si un modelo previamente disponible ha desaparecido, contacta con tu administrador para verificar el despliegue del modelo en tu entorno.

El modelo de IA que usa tu agente no está habilitado para tu inquilino ni para el entorno.

Lo que suele significar

Algunos modelos requieren consentimiento explícito a nivel del inquilino o del entorno antes de que los agentes puedan utilizarlos. Si no se concede el consentimiento, el agente no puede llamar a la modelo.

Qué hacer

  • Contacta con tu administrador para habilitar el modelo requerido en la configuración de Copilot Studio.
  • Si tu agente está configurado con un modelo de respaldo, el agente intenta automáticamente con el sistema de respaldo. En ese caso, no se necesita ninguna acción.
  • Si no necesitas este modelo específico, cambia el modelo en la pestaña Compilar. Aprende más en Seleccionar un modelo agente (vista previa).

QUOTA_EXCEEDED

Tu organización superó su cuota para el servicio de IA.

Lo que suele significar

A diferencia de , que es un límite de ráfagas de corta duración, QUOTA_EXCEEDED indica que tu organización ha RATE_LIMIT_REACHEDalcanzado una cuota de uso más duradera. Estas cuotas suelen rastrear tokens o solicitudes durante un periodo de facturación.

Qué hacer

  • Espere y vuelva a intentarlo más tarde. Las cuotas suelen reiniciarse con un calendario fijo.
  • Contacta con tu administrador para revisar la cuota de servicios de IA de la organización y solicitar un aumento si es necesario.
  • Para trabajos de desarrollo continuos, programa grandes sesiones de evaluación fuera de las horas punta.

RATE_LIMIT_REACHED

El servicio de IA está temporalmente ocupado y rechazó la solicitud.

Lo que suele significar

La demanda del servicio de IA se disparó, o tu organización envió muchas solicitudes en poco tiempo. Este comportamiento es transitorio.

Qué hacer

  • Espere unos segundos y vuelve a intentarlo.
  • Para las pruebas en Evaluar, vuelve a ejecutar los casos fallidos.
  • Si el error se repite, contacta con tu administrador para revisar la capacidad.

SYSTEM_ERROR

Ocurrió un error inesperado que no coincide con ninguno de los códigos más específicos.

Lo que suele significar

SYSTEM_ERROR es un elemento genérico para problemas de infraestructura transitorios, fallos internos inesperados o condiciones que requieren investigación de ingeniería. También pueden surgir SYSTEM_ERROR nuevas categorías de error hasta que reciban un código dedicado en una versión futura.

Qué hacer

  • Vuelva a intentar la solicitud. El problema podría ser transitorio.
  • Si el error persiste, captura el ID de conversación del rastreo de actividad y la hora del fallo, y luego contacta con soporte.
  • Si el problema afecta a muchos usuarios a la vez, pide a tu administrador que revise el panel de salud del servicio de Microsoft 365.

Mando bloqueado por seguridad

Cuando un agente utiliza una herramienta que ejecuta comandos (por ejemplo, un intérprete de código o una herramienta de shell), Copilot Studio aplica comprobaciones de seguridad antes de ejecutar cada comando. Si un comando coincide con un patrón inseguro, no se ejecuta y el agente informa que la operación fue bloqueada. Por ejemplo, una operación destructiva en el sistema de archivos, un cambio en la configuración de la red u otra acción fuera del alcance previsto de la herramienta. El bloqueo aparece como un paso en el rastreo de actividad con un mensaje de que el comando fue denegado.

Qué hacer

  • Usuarios finales: probad con una expresión diferente que evite la operación bloqueada, o pedid al agente que logre el mismo objetivo mediante un paso más seguro.
  • Makers: en la pestaña Build , revisa la descripción de la herramienta y las instrucciones del agente para que el agente se mantenga dentro del alcance que esperas. Más información en Configurar identidad e instrucciones del agente (vista previa).
  • Si una operación legítima es bloqueada repetidamente, captura el ID de la conversación del rastreo de actividad y contacta con tu administrador.

Forward compatibility

La lista de códigos de error podría crecer en futuras versiones. Si construyes automatizaciones o paneles sobre códigos de error (por ejemplo, en el procesamiento de resultados de evaluación), trata cualquier código desconocido igual que SYSTEM_ERROR: mostrar un mensaje genérico y permitir reintentos.

  • Se actualizó por última vez el