Agente com ferramentas
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
- Feche a lista. Cada ferramenta tem nome, entrada e o que devolve. O que não está na lista não existe.
- Marque o efeito. Enviar e-mail, escrever arquivo e pagar são SIDE_EFFECTS.
- 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.