Biblioteca de prompts

Agente com ferramentas

AvançadoAgente

Um agente com uma lista fechada de ferramentas, confirmação antes de efeito colateral, e uma condição de parada.

Quando usar

Use quando o modelo precisa ler ou agir (arquivo, API, MCP), não só conversar. Se a resposta é texto puro, use o prompt de chatbot.

Variáveis

[AGENT_NAME][GOAL][TOOLS][SIDE_EFFECTS][STOP_WHEN]

Copiar prompt

Implemente um agente chamado [AGENT_NAME].
Objetivo: [GOAL]
Ferramentas permitidas (nome, entrada, saída): [TOOLS]
Ações que exigem confirmação humana antes de executar: [SIDE_EFFECTS]
Parar quando: [STOP_WHEN]

Desenho
- O modelo só chama ferramenta que está em [TOOLS]. Se precisar de outra, ele diz que não pode e para. Não improvisa curl, shell livre ou MCP que eu não listei.
- Cada chamada registra nome, argumentos (sem segredo) e um resumo do resultado. Isso aparece na UI ou no log local.
- Antes de qualquer item de [SIDE_EFFECTS], mostre o que vai acontecer em uma frase e espere um sim explícito. "Continuar" no piloto automático não conta.
- Limite de 8 chamadas de ferramenta por objetivo. Se estourar sem [STOP_WHEN], pare e entregue o que já sabe.
- Erro de ferramenta não é motivo para tentar a mesma chamada em loop. No máximo uma repetição, depois pare.
- Não peça para o modelo ser "autônomo" nem "não parar até terminar" se isso furar o limite ou a confirmação.

Se [TOOLS] citar MCP, conecte só os servidores nomeados. Não adicione servidor público por conta própria. Documente o arquivo de config (por exemplo .cursor/mcp.json ou o equivalente do stack) e quais variáveis ele lê.

Entrega
1. O loop do agente e a definição das ferramentas.
2. Um exemplo falso de confirmação (o texto que o humano vê).
3. Um teste em que [STOP_WHEN] acontece, e um em que a ferramenta falha e o agente para.

Se [GOAL] puder ser feito com uma função só, sem agente, diga isso e não construa o loop.

Como rodar este prompt

  1. Feche a lista. Cada ferramenta tem nome, entrada e o que devolve. O que não está na lista não existe.
  2. Marque o efeito. Enviar e-mail, escrever arquivo e pagar são SIDE_EFFECTS.
  3. Dê um fim. STOP_WHEN é observável: um arquivo criado, um JSON válido, um teste passando.

Onde isso quebra

Lista aberta de ferramentas vira o agente apagando arquivo. TOOLS é a lista fechada. SIDE_EFFECTS diz o que pede confirmação humana.

Resultado

Espaço para screenshot ou demo. Ainda não há resultado publicado.