Cómo resolver el error 429 de límite de velocidad de Copilot
🔍 WiseChecker

Cómo resolver el error 429 de límite de velocidad de Copilot

Cuando usa Copilot en las aplicaciones de Microsoft 365, puede ver un error 429 con el mensaje Demasiadas solicitudes. Este error impide que Copilot genere respuestas, resuma documentos o responda preguntas. La causa es alcanzar un límite de velocidad impuesto por Microsoft para proteger la estabilidad del servicio. Este artículo explica por qué ocurre el error 429 y proporciona instrucciones paso a paso para resolverlo.

Puntos clave: Cómo solucionar el error 429 de límite de velocidad de Copilot

  • Centro de administración de Microsoft 365 > Copilot > Límites de velocidad: Verifique la configuración actual de límite de velocidad de su inquilino y las métricas de uso.
  • Encabezado de respuesta Retry-After: Espere el número de segundos especificado en este encabezado antes de enviar otra solicitud.
  • Azure API Management > Directivas > Límite de velocidad: Ajuste los límites de velocidad por usuario o por IP si usa integraciones personalizadas de Copilot.

ADVERTISEMENT

Por qué Copilot devuelve un error 429 de límite de velocidad

El error 429 es un código de estado HTTP que significa que el cliente ha enviado demasiadas solicitudes en un período de tiempo determinado. Microsoft aplica límites de velocidad en las API de Copilot para prevenir abusos, garantizar un uso justo y mantener el rendimiento del servicio. Los límites se aplican tanto al Copilot integrado en las aplicaciones de Microsoft 365 como a las integraciones personalizadas construidas con Copilot Studio o Azure OpenAI Service.

Alcance del límite de velocidad

Los límites de velocidad se calculan por usuario, por aplicación y por inquilino. Un solo usuario que ejecuta múltiples sesiones de Copilot simultáneamente puede activar el límite. De manera similar, una organización con muchos usuarios que envían solicitudes en un período corto puede alcanzar el límite a nivel de inquilino.

Valores predeterminados del límite de velocidad

Microsoft no publica números exactos porque los límites varían según el plan de licencia y la región. En la mayoría de los inquilinos de Microsoft 365 E3 o E5, el límite predeterminado es de aproximadamente 600 solicitudes por usuario por minuto. Los suscriptores de Copilot Pro ven un límite más bajo de alrededor de 300 solicitudes por usuario por minuto. Las integraciones personalizadas que usan Azure OpenAI tienen cuotas separadas definidas en el portal de Azure.

Pasos para resolver el error 429 de Copilot

Paso 1: Espere y reintente automáticamente

  1. Verifique el encabezado Retry-After
    Cuando Copilot devuelve un error 429, la respuesta incluye un encabezado Retry-After con un número de segundos. Espere esa duración exacta antes de enviar la siguiente solicitud. La mayoría de las aplicaciones de Microsoft 365 manejan esto automáticamente, pero el código personalizado debe leer el encabezado.
  2. Use backoff exponencial en integraciones personalizadas
    Si construyó un Copilot personalizado usando Copilot Studio o Azure OpenAI, implemente backoff exponencial. Comience con un retraso de 1 segundo, luego duplique el tiempo de espera después de cada respuesta 429 consecutiva hasta un máximo de 60 segundos.

Paso 2: Revise y ajuste los límites de velocidad del inquilino

  1. Abra el centro de administración de Microsoft 365
    Vaya a https://admin.microsoft.com e inicie sesión con una cuenta de administrador global o de facturación.
  2. Navegue a la configuración de Copilot
    Seleccione Configuración > Configuración de la organización > Copilot. Busque la sección Límites de velocidad. Aquí puede ver las métricas de uso actuales y el límite configurado por usuario.
  3. Aumente el límite si está disponible
    Si su inquilino tiene un complemento de licencia de alto uso, es posible que vea una opción para aumentar el límite por usuario. Haga clic en Editar y seleccione un nivel más alto. Guarde el cambio y espere 5 minutos para que surta efecto.

Paso 3: Reduzca la frecuencia de solicitudes en las aplicaciones cliente

  1. Cierre sesiones de Copilot no utilizadas
    Cada pestaña o instancia de aplicación que ejecuta Copilot cuenta para el límite del usuario. Cierre los paneles de Copilot en Word, Excel y Outlook cuando no los esté usando activamente.
  2. Procese por lotes las solicitudes en aplicaciones personalizadas
    Si llama a las API de Copilot desde una aplicación personalizada, combine múltiples indicaciones en una sola solicitud usando la matriz messages. Esto reduce el número total de llamadas a la API.
  3. Espacie las tareas automatizadas
    Programe operaciones masivas de Copilot, como resumir una biblioteca de documentos, para que se ejecuten con al menos 10 segundos de diferencia. Use un sistema de cola para imponer los retrasos.

Paso 4: Monitoree el uso del límite de velocidad

  1. Use los informes de uso de Microsoft 365
    En el centro de administración, vaya a Informes > Uso > Uso de Copilot. Este informe muestra el número de solicitudes por usuario y por aplicación. Identifique usuarios o aplicaciones que excedan el límite.
  2. Habilite Azure Monitor para Copilot Studio
    Si usa Copilot Studio, integre Azure Monitor para rastrear los volúmenes de llamadas a la API. Configure alertas cuando los recuentos de solicitudes se acerquen al 80% del límite.

ADVERTISEMENT

Si Copilot aún devuelve 429 después de estos pasos

El error 429 de Copilot persiste a pesar de esperar

Si el error continúa después de esperar la duración de Retry-After, el límite de velocidad puede aplicarse a nivel de inquilino en lugar de por usuario. Contacte al soporte de Microsoft para solicitar un aumento temporal del límite. Proporcione el rango de tiempo exacto y el número de solicitudes que causaron el error.

La integración personalizada devuelve 429 mientras que Copilot integrado funciona

Esto indica que su código personalizado no está respetando la lógica de reintento. Revise la implementación de su cliente de API. Asegúrese de que lea el encabezado Retry-After y espere los segundos especificados. También verifique que no esté reutilizando la misma clave de API en múltiples hilos sin un semáforo.

Error 429 en la aplicación web de Copilot Studio

Si la interfaz web de Copilot Studio muestra un error 429, significa que el inquilino ha alcanzado su límite de solicitudes por minuto. Reduzca el número de evaluadores concurrentes. Vaya a Copilot Studio > Configuración > General > Límite de velocidad y baje el máximo de solicitudes por conversación.

Límites de velocidad de Copilot integrado vs. integración personalizada

Elemento Copilot integrado en Microsoft 365 Integración personalizada mediante Azure OpenAI
Alcance del límite de velocidad Por usuario y por inquilino Por clave de API y por implementación
Límite predeterminado 600 solicitudes por usuario por minuto Varía según el nivel de suscripción de Azure
Mecanismo de reintento Automático con backoff exponencial Debe implementarse en el código
Ajuste del límite A través del centro de administración de Microsoft 365 A través del portal de Azure > Cuotas

Después de resolver el error 429, puede usar Copilot sin interrupciones. Para prevenir futuros errores de límite de velocidad, monitoree los informes de uso semanalmente y configure alertas de Azure Monitor. Para integraciones personalizadas, siempre implemente backoff exponencial con análisis del encabezado Retry-After. Esto asegura que su aplicación maneje los límites de velocidad correctamente incluso si Microsoft ajusta los umbrales.

ADVERTISEMENT