Escreva um prompt que faça um agente construir uma ferramenta: 3 partes

Você pediu a um agente para "fazer uma ferramenta" e recebeu algo vago que não se encaixa no seu app. A solução não é um prompt mais longo, é um prompt com três partes específicas: onde a ferramenta fica, o que ela faz e os detalhes concretos que precisam valer. Espere mais de uma rodada também: até a DeepSeek diz que alguns dos seus plugins de demonstração foram refinados ao longo de várias rodadas de conversa.

A maioria dos prompts da coleção da DeepSeek para o vídeo de demonstração do Harness Creator Mode mostra esse formato de três partes. A página (coleção de prompts do Creator Mode da DeepSeek, verificada em 3 de novembro de 2026, sem data de publicação na página) lista sete plugins: uma galeria 3D de pontos turísticos famosos, uma visualização 3D de Transformer, uma interface DSH pixelada, uma bancada de design de pôsteres, uma bancada de edição de vídeo, um leitor de artigos e estatísticas de conversa. Para usar um deles, você cola o prompt no DeepSeek Harness e seleciona a opção Creator Mode. Cada prompt é fornecido em inglês e chinês.

Como as três partes aparecem em um prompt real#

Pegue o prompt de visualização 3D de Transformer dessa página. Ele começa com "Create a DeepSeek Harness plugin with a left sidebar entry". Essa é a parte um: onde a ferramenta fica. Depois descreve a função: um jogo de demonstração 3D interativo que explica a computação do Transformer. Parte dois. Termina com um requisito fácil de esquecer e chato de corrigir depois: o título do painel e a barra de ferramentas não podem se sobrepor aos botões nativos da janela do macOS. Parte três.

Os outros prompts da página seguem o mesmo formato, com diferenças. O ponto de entrada varia: uma entrada na barra lateral esquerda em três deles, um ponto acessado a partir da conversa em dois, a barra lateral direita no leitor de artigos. O final é onde eles ficam concretos: cinco estilos, um deles pixelado, ou um título de página padrão "Everything is a plugin". Esse é o padrão que vale copiar, e a diferença aparece rápido:

A primeira versão deixa o agente adivinhando tudo. Onde ela fica? Uma barra lateral, um comando, uma janela separada? O que conta como "para as minhas conversas"? A segunda responde a essas perguntas antes que o agente precise fazê-las.

Escreva o seu, uma parte de cada vez#

Digamos que você quer um painel pequeno que lê um artigo e permite fazer perguntas sobre ele. Percorra as partes em ordem.

Onde ela fica. Uma frase, e nomeie o lugar exato: "um plugin com uma entrada na barra lateral esquerda", "um botão na barra de ferramentas", "uma página aberta pelo menu". Se você omitir, o agente escolhe por você.

O que ela faz. Descreva o que você vê e clica, não como é construído. "Você arrasta um PDF, o lado esquerdo mostra o texto, o lado direito tem um chat sobre ele." Pule o framework, a menos que você tenha um motivo para nomear um.

Requisitos concretos. É aqui que entram as coisas que deram errado da última vez. Regras de layout, coisas que não podem se sobrepor, um idioma, um formato de arquivo, um limite como "sem chamadas de rede". Linhas curtas e verificáveis. Se você não consegue dizer se um requisito foi atendido olhando o resultado, reescreva-o até conseguir.

Juntando tudo:

Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file

Envie pela API#

O Creator Mode é um recurso do DeepSeek Harness; o prompt em si é texto simples, então qualquer coisa que leia um prompt pode executá-lo, incluindo um script que chama a API da CheapTokens. O prompt abaixo é o de cima, enviado ao DeepSeek-V4-Flash (id completo deepseek-ai/DeepSeek-V4-Flash-0731, contexto de 380K, até 32.768 tokens em uma resposta, o que deixa espaço para um plugin inteiro em uma única resposta):

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

prompt = """Create a plugin with a left sidebar entry.
It is a paper reader: I open a PDF, the text is shown
on the left, and a chat about the paper is on the right.
Requirements:
- the panel title must not overlap the window buttons
- the chat answers only from the paper's text
- keep everything in one file"""

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=8000,
)
print(resp.choices[0].message.content)
print(resp.choices[0].finish_reason, resp.usage)

A chave vai em uma variável de ambiente, nunca no arquivo. Se finish_reason imprimir length, o plugin foi cortado por max_tokens: aumente o limite. Configurar o próprio DeepSeek Harness com um provedor personalizado é uma tarefa separada, abordada em conectando o DeepSeek Harness à CheapTokens. O básico da primeira requisição está na documentação da CheapTokens.

Por que um prompt raramente basta#

A DeepSeek diz claramente: alguns dos plugins de demonstração foram refinados ao longo de várias rodadas de conversa, então um único prompt pode não reproduzir o vídeo exatamente. Pense nisso como briefar um empreiteiro. O primeiro desenho resolve a maior parte do cômodo, e você percorre e diz "a porta abre para o lado errado".

E é aí que o dinheiro vai. Um agente reenvia a conversa a cada rodada (o mesmo efeito de por que um chat longo custa mais), então a quinta rodada carrega o prompt, quatro respostas anteriores e todo o código até então.

Quanto custa uma sessão de construção#

Aqui está uma sessão hipotética, não uma medição: cinco rodadas, cerca de 12.000 tokens enviados por rodada (prompt, histórico, código atual) e cerca de 6.000 tokens escritos de volta. A tabela abaixo usa os preços ao vivo da CheapTokens para cada modelo; a coluna OpenRouter está lá para comparar a mesma sessão no total, com entrada e saída contadas juntas.

Para uma rodada do DeepSeek-V4-Flash, os mesmos números dão $0.00078. Se o seu plugin for maior, o histórico cresce a cada rodada, então altere os dois números e refaça a estimativa. Mais sobre estimar contas de agentes em como estimar o custo de um agente de IA, e a lista de modelos está na página de preços.

Verifique antes de enviar#

Escreva o primeiro prompt, leia o que volta e coloque cada correção na próxima versão dos requisitos. Depois de duas ou três sessões você terá uma lista curta de linhas que cola em todo novo prompt, e a primeira rodada sairá mais próxima do que você queria. Para os hábitos por trás de qualquer prompt, veja como escrever um bom prompt.