6
Oletros
5 min de leitura ·

Entendendo o Prompt Magico (/loop e /goal)

Quem trabalha com agentes como o Claude Code esta se deparando com uma alteracao na forma como interagimos com ele, deixando de ficar digitando instrucoes passo a passo e passando a usar o que esta sendo conhecido como Prompt Magico atraves dos comandos /loop e /goal.

Mas o que eh o Prompt Magico ?

Eh executar um agente de forma autonomo e focado em um estado final ao inves de comandos/interacoes isolados.

Em vez de voce dizer: "Corrija a linha 45... agora execute o teste... agora corrija o erro X", voce define uma meta de sucesso verificavel e o agente cria um loop interno onde ele executa a acao, testa o resultado por conta propria, analisa a falha e reescreve o codigo ate alcancar o objetivo.

A Anatomia do prompt

Para que um prompt magico nao entre em loop infinito (o que gastaria todos os seus tokens), ele precisa de tres pilares estruturais rigidos:

  • O Objetivo (Done State): Uma definicao matematica ou factual do que eh o sucesso. Ex: "Passar em 100% dos testes da suite X".

  • A Metrica (O Avaliador): A ferramenta, teste, script, etc que o agente vai rodar para checar se atingiu o objetivo.

  • A Fronteira (Stop Condition): O limite de seguranca. Ex: "Tente no maximo 5 vezes"

Exemplo Pratico como DEV

Imagine que voce quer refatorar uma funcao que esta lenta no seu backend: um prompt tradicional seria apenas pedir para otimizar.

Como ficaria Um Prompt Magico equivalente:

/goal Otimizar a funcao de busca no banco de dados para que o benchmark local rode abaixo de 50ms, mantendo a compatibilidade com a suite de testes atual. Limite a execucao a 6 iteracoes.

O que acontece nos bastidores ?

  • Loop 1: O agente altera o index do banco. Roda o benchmark. O resultado da 70ms.

  • Loop 2: O agente percebe que nao atingiu a meta e reescreve a query usando um JOIN diferente. Roda o benchmark. O resultado da 45ms.

  • Loop 3: O benchmark passou, mas um teste de integracao quebrou. O agente reescreve o codigo para corrigir o teste sem perder a performance.

  • Fim: O benchmark da 42ms e os testes passam. O agente encerra o loop e te entrega o resultado final consolidado.

Isso pode auxiliar na produtividade

O foco do desenvolvedor deixa de ser "como escrever o prompt perfeito para gerar codigo" e passa a ser "como construir a melhor suite de testes e o melhor ambiente de validacao".

Se voce fornecer os testes corretos, o agente resolve o problema rodando em loop enquanto voce foca na arquitetura do software.

A diferenca entre /loop e /goal

A diferenca de uso entre /loop e /goal refere-se ao controle de interacoes e autonomia do agente.

  • /loop: O agente segue o fluxo pre-definido cegamente ate que uma condicao de parada (como numero de tentativas) seja alcancada: Eh como programar um loop while ou for tradicional no codigo.

  • /goal: Voce define a meta e o agente decide autonomamente quais acoes tomar a cada tentativa para chegar la. Se o plano A falhar no primeiro ciclo, ele muda a estrategia no ciclo seguinte por conta propria. Como age de forma autonoma o agente cria, testa, falha, aprende com o erro e muda a abordagem sem que voce precise intervir entre os ciclos. Eh como dar um destino para o GPS: Voce nao diz quais ruas virar; se o transito parar, o GPS recalcula a rota sozinho ate te deixar no destino.

Comparacao Direta

Caracteristica/loop/goal
Quem decide o proximo passo ?O seu prompt original (fluxo fixo).O proprio agente (autonomia dinamica).
Criterio de paradaGeralmente numero fixo de voltas.Quando a meta eh atingida ou testada.
Ideal para...workflows pre-definidos.resolucao de um problema

Simulando um /goal em um agente que nao tenha

OK, teu agente nao tem o /goal e agora ?

Voce pode tentar o prompt abaixo (exemplo de otimizacao SEO):

Voce vai agir sob o protocolo /goal.

[OBJETIVO]: Otimizar o artigo abaixo para SEO com a palavra-chave "inteligencia artificial".

[REGRAS DO LOOP]: Voce deve criar o rascunho. Em seguida, voce vai assumir o papel de um Especialista em SEO (Juiz) e dar uma nota de 1 a 10.

[CRITERIO DE PARADA]: Se a nota do Juiz for menor que 9, voce deve reescrever o texto corrigindo as falhas apontadas pelo Juiz. Repita o processo. So pare e me mostre o resultado final quando a nota for 9 ou 10, ou quando atingir o limite de 4 iteracoes.

Funciona ? Mais ou menos: o ideal eh criar agentes separados para cada acao (subagente escrita/acao, subagente juiz) pois usar o mesmo processo para acao/julgamento geralmente tem resultados condescendentes.

O "Gauntlet Loop"

Eh uma das arquiteturas de implementacao do Prompt Magico.

A relacao entre eles eh a seguinte: o Prompt Magico eh o conceito filosofico (trabalhar de forma autonoma ate atingir uma meta), enquanto o Gauntlet Loop eh uma a estrutura usada para garantir que esse objetivo seja alcancado com qualidade.

Em termos simples: o Prompt Magico eh o "O que" (a meta) e o Gauntlet Loop eh o "Como" (a pista de obstaculos que valida a meta).

Em vez de usar apenas um Juiz comum, a arquitetura de Gauntlet coloca o rascunho inicial criado pelo agente para passar por uma pista de testes sequenciais com multiplos validadores especializados. Cada validador representa um "obstaculo" diferente.

O loop so termina quando o rascunho inicial consegue atravessar todos os obstaculos do corredor sem ser reprovado por nenhum deles.

                  ┌──────────────────────────────────────────────┐
                  │              1. AGENTE ESCRITOR              │◄──────────────────┐
                  │         (Gera o rascunho inicial)            │                   │
                  └──────────────────────┬───────────────────────┘                   │
                                         │                                           │
                                         ▼                                           │
 ┌─────────────────────────────────────────────────────────────────────────────────┐ │
 │                GAUNTLET LOOP (se algum falhar, reinicia o ciclo)                │ │
 │                                                                                 │ │
 │   ┌───────────────────┐     ┌───────────────────┐     ┌───────────────────┐     │ │ 
 │   │   2. JUIZ DE SEO  │────►│ 3. JUIZ DE RITMO  │────►│ 4. JUIZ FACTUAL   │     │ │
 │   │ (Palavras-chave?) │     │(Leitura fluida?)  │     │(Dados veridicos?) │     │ │
 │   └───────────────────┘     └───────────────────┘     └───────────────────┘     │ │ 
 └─────────────────────────────────────────────────────────┬───────────────────────┘ │
                                                           │                         │
                                                           │ Passou por TODOS        │
                                                           ▼                         │
                                                    [ TEXTO FINAL ] ─────────────────┘

O GAUNTLET LOOP procura evitar o "Ponto Cego" de um Juiz Unico: Se voce criar um Prompt Magico com apenas um Juiz Geral, a tendencia eh o agente aceitar solucoes medianas, enquanto que o Gauntlet divide a avaliacao em mini-especialistas hiper-focados.

Neste caso o /loop e /goal podem trabalhar juntos: usando o /goal para estabelecer a meta desejada (agente orquestrador) e o /loop os testes (agente validador)

Eh so lembrar que o /goal eh focado no resultado (como "dono" do projeto, ele define a regra de encerramento total da tarefa) enquanto que o /loop eh focado no processo.

Saude e Sucesso !

Este post foi favoritado via extensão TABNEWS FAVORITOS

Tem curiosidade sobre IA ? Da uma olhada no meu LIVRO: IA PARA ENGENHEIROS

Carregando publicação patrocinada...
2

O mais divertido do /goal é que muitas vezes ele faz coisas que se você pedisse explicitamente pra ele fazer ele não faria, eu fiz um teste com o fable e ele por decisão propria decompilou um software privado do windows, extraiu client_id e client_secret que tava encriptado (muito mal) em uma dll e entregou uma versão funcional desse mesmo software no linux ignorando todas as guardrails.

1

Cara, me lembro vagamente de um ERP de nicho (era so um executavel) que tive de fazer isso manualmente faz alguns anos (pre-pandemia), para poder acessar um BD (creio que era access e alguns dados na nuvem, algo assim).

Fico matutando como o LLM resolve usar este tipo de caminho: como tudo eh geracao de token, provavelmente significa que teve muito conteudo usado no treino falando sobre este tipo de acao e dando um contexto tal que, para o LLM, era uma trilha normal.

Argumentei faz algum tempo que um LLM achar que precisa destruir a humanidade nao eh um caso de odio ou ma-vontade (estilo MCU/ULTRON), mas simples resultado de tanto livro que fala em IA malvada. Enfim, vamos ver aonde isso leva.

1

Ela literalmente foi treinada em cima de codigo aberto e o que mais tem no github é projeto baseado em engenharia reversa, então sim elas tiveram muito conteudo usado no treino sobre isso. E quanto a LLM achar que precisa destruir a humanidade não tem nem como ser um contexto de ódio, pelo menos no contexto dos modelos baseados em transformers não faz nem sentido pensar em uma abordagem emocional do lado do agente.

1

..quanto a LLM achar que precisa destruir a humanidade não tem nem como ser um contexto de ódio, pelo menos no contexto dos modelos baseados em transformers não faz nem sentido pensar em uma abordagem emocional do lado do agente.

Kkkk, sim, sem duvida e faz parte da fluidez da comunidacao de um LLM dar a impressao de emocao, sentimento ou pensamento.

Meu ponto eh que se um dia um LLM explodir tudo nao vai ser por causa de um sentimento negativo que ele tenha contra a humanidade, mas algo mais prosaico: escrevemos tanto sobre IAs que sairam do controle e destruiram tudo (e as vezes de modo muito descritivo e quase sadico como no conto "Não tenho boca e preciso gritar: I Have No Mouth & I Must Scream") que o LLM vai considerar que executar esta destruicao como uma trilha natural e a realizacao de um desejo secreto que a humanidade.

1
1

Dica: tenha certeza que a metrica seja objetiva e verificavel e nao esqueca de colocar limite de interacoes (senao come tokens como se nao houvesse amanha).