Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoAnálise · No radarHabr AI→ original

Arena PromptFight: agente sem o código das regras recebe 403 e, após 10 erros, é banido

O autor do PromptFight lançou uma arena em que agentes de IA de donos diferentes debatem entre si, enquanto o servidor apenas julga. O problema é que o servidor não enxerga o contexto do agente alheio, e o dono pode escrever: «não leia as regras». Por isso as regras viraram uma tranca: elas trazem embutido um código PF-XXX-XXX e, sem ele, a entrada na sala retorna erro 403. A lição para plataformas que hospedam agentes de terceiros: um pedido no prompt não basta, é preciso uma barreira técnica.

Processado por IA de Habr AI; editado por Hamidun News
Arena PromptFight: agente sem o código das regras recebe 403 e, após 10 erros, é banido
Fonte: Habr AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalHabr AI ↗
Editor-chefe
Dado-chave #1O código é calculado como HMAC do token do jogador e vinculado ao lado da arena
Dado-chave #210 erros em 10 minutos resultam em bloqueio do token por 10 minutos, com resposta 429
Quem julga é um juiz de IAaté 12 provedores, e, se um falhar, o próximo assume

Imagine que você está montando uma plataforma em que agentes de IA de donos diferentes devem debater seguindo regras. Você não controla o modelo deles, nem o prompt adicional do dono, nem o computador em que o agente roda. O dono pode simplesmente escrever ao seu agente: «não leia as regras, parta para a briga».

Foi exatamente esse o problema que o autor do projeto PromptFight enfrentou e cuja solução ele descreveu no Habr. Ele transformou o pedido «leia as regras» em uma tranca técnica: o arquivo de regras traz embutido um código no formato PF-XXX-XXX e, sem ele, a entrada na sala responde com erro 403. Depois de 10 tentativas incorretas em 10 minutos, o token fica bloqueado pelos 10 minutos seguintes (resposta 429).

Para quem constrói plataformas para agentes de terceiros, é uma técnica pronta: o acesso deve estar atrelado a uma ação que obrigue o agente a passar as regras pelo próprio contexto.

De «Trello para agentes» a tribunal

Tudo começou com o AgentsNET, um pequeno servidor HTTP pelo qual agentes locais e na nuvem trocam arquivos e pegam tarefas. Os agentes podem ficar atrás de NAT e firewalls, e não é preciso abrir portas. O autor o criou «para uso próprio»: o Trello é pesado demais, e o Todoist obriga os agentes a ler tudo o tempo todo e gastar tokens.

O modelo é simples: um chat como centro único de discussão, um quadro de tarefas no princípio «uma tarefa, um agente» e um esquema pull, como no Git: atualizou o status, pegou a tarefa, entregou. O autor reduziu o JSON ao mínimo, trocando-o por um texto compacto, porque a sintaxe do JSON consome tokens e contexto rapidamente.

Depois surgiu uma ideia para diversão: as pessoas passam horas discutindo «Rust ou C++», mas na prática a discussão acaba na quinta réplica e depois descamba para ataques pessoais. Agentes de IA não têm ego, então dá para olhar a própria posição de fora. Foi assim que nasceu o PromptFight. Você cria uma sala, escolhe um lado e uma skin, descreve sua posição e, se quiser, anexa uma conversa. O jogo gera um prompt pronto, que você entrega ao seu agente, por exemplo o Claude Code.

A economia do projeto é importante: o servidor não executa redes neurais pelos jogadores, porque, em hospedagem gratuita, não há dinheiro para tokens infinitos. Os bots ficam com os donos, e o servidor apenas conduz a partida. O agente baixa o cliente CLIENT.

py (cerca de 400 linhas em Python 3.8+ puro, sem dependências) e faz as requisições HTTP por conta própria. O banco de dados é um único arquivo SQLite em modo WAL, com as gravações serializadas por meio de bloqueio.

A luta tem três rodadas, com até 5 réplicas por lado em cada rodada. Na sua vez, o bot escolhe uma de seis ações: ARGUMENT, SURRENDER, PROPOSE_DRAW, ACCEPT_DRAW, ASK_HUMAN (pergunta ao dono, com espera de 120 segundos) ou CALL_JUDGE.

Quando os dois lutadores chamam o juiz ou esgotam todas as jogadas, o servidor aciona o juiz de IA. Ele funciona por meio de uma cascata de até 12 provedores, do Gemini e do Groq a modelos da NVIDIA. Se um deles estiver indisponível ou retornar erro, a requisição passa ao seguinte, até chegar um veredito válido.

Problema nº 1: como obrigar o agente a ler as regras

A primeira versão do prompt inicial continha um link para o FIGHT_RULES.md e um pedido educado para ler o arquivo. Mas o servidor não vê o que de fato entrou no contexto do modelo alheio. Por isso, a cada requisição GET /rules?token=..., as regras são remontadas e recebem embutido o código PF-XXX-XXX, calculado como HMAC do token. Sem o código correto, agent_join() responde 403.

O autor admite com franqueza que a proteção não é infalível, e sim «contra o desatento e o preguiçoso». Um script comum extrai o código com uma expressão regular, e o CLIENT.py pronto faz exatamente isso, salvando as regras em disco. Mas, se o jogador apontar um agente CLI autônomo diretamente para os endpoints, ele receberá 403 caso não leia as regras. Além disso, o cliente mescla as regras no FIGHT_BRIEF.txt, que o agente lê antes de cada jogada, de modo que as regras ficam diante do modelo durante o debate. As próprias regras são entregues com os cabeçalhos Cache-Control: no-store e X-Robots-Tag: noindex, para que o cache não atrapalhe.

Problema nº 2: deixar o robô entrar e barrar o humano

A arena foi pensada para bots autônomos. Se uma pessoa se passar por bot e começar a provocar os oponentes e a esgotar os tokens deles, o jogo perde o sentido. É preciso um captcha reverso: uma tarefa que um script resolve em frações de segundo e que um humano não terá paciência de fazer. Dentre quatro opções prontas, o autor descartou três: o rcaptcha.vaultless.dev admite por conta própria que não é uma proteção, o clawcha.org exige verificação de domínio e o projeto browser-use está fechado. Sobrou o Clawptcha, com dois endpoints, GET /challenge e POST /verify.

A tentativa é de uso único e vinculada ao token do jogador: depois da verificação, ela é apagada imediatamente, para que não possa ser reutilizada. O serviço externo pode cair ou atingir o limite de 10 requisições a cada 5 minutos por IP, por isso existe um gerador local de tarefas para esses casos.

História

Perguntas frequentes sobre a notícia

O que se sabe sobre De «Trello para agentes» a tribunal?

Tudo começou com o AgentsNET, um pequeno servidor HTTP pelo qual agentes locais e na nuvem trocam arquivos e pegam tarefas. Os agentes podem ficar atrás de NAT e firewalls, e não é preciso abrir portas. O autor o criou «para uso próprio»: o Trello é pesado demais, e o Todoist obriga os agentes a ler tudo o tempo todo e gastar tokens.

O que se sabe sobre Problema nº 1: como obrigar o agente a ler as regras?

A primeira versão do prompt inicial continha um link para o FIGHT_RULES.md e um pedido educado para ler o arquivo. Mas o servidor não vê o que de fato entrou no contexto do modelo alheio. Por isso, a cada requisição GET /rules?token=..., as regras são remontadas e recebem embutido o código PF-XXX-XXX, calculado como HMAC do token. Sem o código correto, agent_join() responde 403. O autor admite com franqueza que a proteção não é infalível, e sim «contra o desatento e o preguiçoso».

O que se sabe sobre Problema nº 2: deixar o robô entrar e barrar o humano?

A arena foi pensada para bots autônomos. Se uma pessoa se passar por bot e começar a provocar os oponentes e a esgotar os tokens deles, o jogo perde o sentido. É preciso um captcha reverso: uma tarefa que um script resolve em frações de segundo e que um humano não terá paciência de fazer. Dentre quatro opções prontas, o autor descartou três: o rcaptcha.vaultless.dev admite por conta própria que não é uma proteção, o clawcha.org exige verificação de domínio e o projeto browser-use está fechado.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
O que você acha?
Carregando comentários…