Ao usar o Copilot nos aplicativos do Microsoft 365, você pode ver um erro 429 com a mensagem Too Many Requests. Esse erro impede o Copilot de gerar respostas, resumir documentos ou responder perguntas. A causa é atingir um limite de taxa imposto pela Microsoft para proteger a estabilidade do serviço. Este artigo explica por que o erro 429 ocorre e fornece instruções passo a passo para resolvê-lo.
Principais Conclusões: Corrigindo o Erro de Limite de Taxa 429 do Copilot
- Centro de administração do Microsoft 365 > Copilot > Limites de taxa: Verifique a configuração atual do limite de taxa e as métricas de uso do seu locatário.
- Cabeçalho de resposta Retry-After: Aguarde o número de segundos especificado neste cabeçalho antes de enviar outra solicitação.
- Gerenciamento de API do Azure > Políticas > Limite de taxa: Ajuste os limites de taxa por usuário ou por IP se você usar integrações personalizadas do Copilot.
Por que o Copilot Retorna um Erro de Limite de Taxa 429
O erro 429 é um código de status HTTP que significa que o cliente enviou muitas solicitações em um determinado intervalo de tempo. A Microsoft impõe limites de taxa nas APIs do Copilot para evitar abusos, garantir uso justo e manter o desempenho do serviço. Os limites se aplicam tanto ao Copilot integrado nos aplicativos do Microsoft 365 quanto a integrações personalizadas criadas com Copilot Studio ou Azure OpenAI Service.
Escopo do Limite de Taxa
Os limites de taxa são calculados por usuário, por aplicativo e por locatário. Um único usuário executando várias sessões do Copilot simultaneamente pode atingir o limite. Da mesma forma, uma organização com muitos usuários enviando solicitações em um curto período pode atingir o limite do locatário.
Valores Padrão do Limite de Taxa
A Microsoft não publica números exatos porque os limites variam de acordo com o plano de licença e a região. Na maioria dos locatários do Microsoft 365 E3 ou E5, o limite padrão é de aproximadamente 600 solicitações por usuário por minuto. Os assinantes do Copilot Pro veem um limite menor, de cerca de 300 solicitações por usuário por minuto. Integrações personalizadas que usam Azure OpenAI têm cotas separadas definidas no portal do Azure.
Passos para Resolver o Erro 429 do Copilot
Passo 1: Aguardar e Tentar Novamente Automaticamente
- Verifique o cabeçalho Retry-After
Quando o Copilot retorna um erro 429, a resposta inclui um cabeçalho Retry-After com um número de segundos. Aguarde esse tempo exato antes de enviar a próxima solicitação. A maioria dos aplicativos do Microsoft 365 lida com isso automaticamente, mas o código personalizado deve ler o cabeçalho. - Use backoff exponencial em integrações personalizadas
Se você criou um Copilot personalizado usando Copilot Studio ou Azure OpenAI, implemente backoff exponencial. Comece com um atraso de 1 segundo e depois dobre o tempo de espera a cada resposta 429 consecutiva até um máximo de 60 segundos.
Passo 2: Revisar e Ajustar os Limites de Taxa do Locatário
- Abra o centro de administração do Microsoft 365
Acesse https://admin.microsoft.com e faça login com uma conta de Administrador Global ou Administrador de Cobrança. - Navegue até as configurações do Copilot
Selecione Configurações > Configurações da organização > Copilot. Procure pela seção Limites de taxa. Aqui você pode visualizar as métricas de uso atuais e o limite configurado por usuário. - Aumente o limite, se disponível
Se o seu locatário tiver um complemento de licença de alto uso, você pode ver uma opção para aumentar o limite por usuário. Clique em Editar e selecione um nível superior. Salve a alteração e aguarde 5 minutos para que ela entre em vigor.
Passo 3: Reduzir a Frequência de Solicitações nos Aplicativos Cliente
- Feche sessões não utilizadas do Copilot
Cada guia ou instância de aplicativo executando o Copilot conta para o limite do usuário. Feche os painéis do Copilot no Word, Excel e Outlook quando não estiver usando ativamente. - Agrupe solicitações em aplicativos personalizados
Se você chama as APIs do Copilot de um aplicativo personalizado, combine vários prompts em uma única solicitação usando o array messages. Isso reduz o número total de chamadas de API. - Espaçe tarefas automatizadas
Agende operações em lote do Copilot, como resumir uma biblioteca de documentos, para serem executadas com pelo menos 10 segundos de intervalo. Use um sistema de fila para impor atrasos.
Passo 4: Monitorar o Uso do Limite de Taxa
- Use relatórios de uso do Microsoft 365
No centro de administração, vá para Relatórios > Uso > Uso do Copilot. Este relatório mostra o número de solicitações por usuário e por aplicativo. Identifique usuários ou aplicativos que excedem o limite. - Habilite o Azure Monitor para Copilot Studio
Se você usa o Copilot Studio, integre o Azure Monitor para rastrear volumes de chamadas de API. Configure alertas quando o número de solicitações se aproximar de 80% do limite.
Se o Copilot Ainda Retornar 429 Após Esses Passos
Erro 429 do Copilot Persiste Mesmo Após Aguardar
Se o erro continuar após aguardar a duração do Retry-After, o limite de taxa pode estar sendo aplicado no nível do locatário, e não por usuário. Entre em contato com o suporte da Microsoft para solicitar um aumento temporário do limite. Forneça o intervalo de tempo exato e o número de solicitações que causaram o erro.
Integração Personalizada Retorna 429 Enquanto o Copilot Integrado Funciona
Isso indica que seu código personalizado não está respeitando a lógica de repetição. Revise a implementação do seu cliente de API. Certifique-se de que ele lê o cabeçalho Retry-After e aguarda os segundos especificados. Verifique também se você não está reutilizando a mesma chave de API em várias threads sem um semáforo.
Erro 429 no Aplicativo Web do Copilot Studio
Se a interface web do Copilot Studio mostrar um erro 429, significa que o locatário atingiu o limite de solicitações por minuto. Reduza o número de testadores simultâneos. Vá para Copilot Studio > Configurações > Geral > Limite de taxa e diminua o máximo de solicitações por conversa.
Limites de Taxa: Copilot Integrado vs. Integração Personalizada
| Item | Copilot Integrado no Microsoft 365 | Integração Personalizada via Azure OpenAI |
|---|---|---|
| Escopo do limite de taxa | Por usuário e por locatário | Por chave de API e por implantação |
| Limite padrão | 600 solicitações por usuário por minuto | Varia conforme o nível da assinatura do Azure |
| Mecanismo de repetição | Automático com backoff exponencial | Deve ser implementado no código |
| Ajuste de limite | Via centro de administração do Microsoft 365 | Via portal do Azure > Cotas |
Após resolver o erro 429, você pode usar o Copilot sem interrupções. Para evitar futuros erros de limite de taxa, monitore os relatórios de uso semanalmente e configure alertas no Azure Monitor. Para integrações personalizadas, sempre implemente backoff exponencial com análise do cabeçalho Retry-After. Isso garante que seu aplicativo lide com limites de taxa de forma adequada, mesmo que a Microsoft ajuste os limites.