Biblioteca de detectoresLimite de taxa atingido

Limite de taxa atingido

À espera do fornecedor.

Separe recusas de capacidade do trabalho produtivo do agente.

Veja o problema. Entenda o resultado.

Narração em inglês com legendas.

Como passa despercebido

O seu agente não terminou, mas também não está realmente a pensar. Os pedidos continuam a retornar com um erro de capacidade. Sem um sinal claro, o throttling do fornecedor pode parecer uma sessão lenta ou sem resposta.

Imagine duas recusas do fornecedor enquanto uma tarefa está a correr. O agente pode tentar novamente silenciosamente ou parar de fazer progresso útil. Mais espera não resolverá todos os problemas de cota ou capacidade, especialmente quando várias sessões partilham os mesmos limites.

O que o ClawMetry deteta

O ClawMetry procura recusas de capacidade nos resultados de ferramentas e eventos de erro de API explícitos. Reconhece códigos de estado como HTTP 429 e HTTP 529, além de texto de limite de taxa e sobrecarga. Recusas repetidas geram um aviso.

A diferença que muda o resultado

Exemplo de acionamento

2 recusas de capacidade

Descoberta de aviso

Comparação silenciosa

1 recusa de capacidade

Sem resultado para este detetor.

No exemplo verificado, dois eventos de erro HTTP 429 produzem uma descoberta de limite de taxa atingido. Uma recusa fica abaixo do limiar padrão. A descoberta inclui a contagem de recusas, para que você possa distinguir um problema recorrente de uma resposta transitória.

Inspecionar o resultado do detetor
{
  "kind": "rate_limited",
  "severity": "warning",
  "evidence": {
    "refusals": 2,
    "threshold": 2,
    "threshold_source": "static",
    "observed": "HTTP 429/529 status or rate-limit text on tool results and API error events",
    "sample": ""
  }
}
Descarregar entradas e resultados completos (JSON)
Como o exemplo foi verificado

Estes exemplos avaliam o detetor publicado com dados de eventos criados ou ficheiros de configuração descartáveis. Os vídeos ilustram esses comportamentos. Não são gravações de agentes reais ou da interface do produto. Nenhum comando nos exemplos foi executado.

O resultado estabelece o comportamento para estas entradas. Não estabelece ingestão em runtime, prevenção ou um compromisso real. Inspecionar o contrato de fonte fixado.

O que verificar a seguir

Verifique o estado do fornecedor e os limites da conta ou modelo em uso. Reduza o trabalho concorrente ou aguarde o reset do limite relevante quando apropriado. Depois confirme que os pedidos se recuperam em vez de assumir que o agente retomou.

  1. Verifique o estado do fornecedor
  2. Revise cota e concorrência
  3. Confirme que os pedidos se recuperam

O que este sinal estabelece

Isto é um sintoma de capacidade, não um diagnóstico de causa raiz. Não aumenta automaticamente as cotas nem troca de fornecedor.

Mantenha os momentos importantes visíveis.

Acompanhe a atividade do agente, inspecione os resultados e decida o que precisa da sua atenção.