Como Criar Prompts para Claude: Tags XML, Exemplos e Documentos Longos

Claude lida especialmente bem com documentos longos e instruções cuidadosas, e a Anthropic publica orientações claras sobre como fazer prompts para ele. O hábito mais útil é estruturar seu prompt com tags XML. Este guia explica o porquê e como combinar tags com exemplos, raciocínio passo a passo e respostas preenchidas.

Seja claro e direto

O próprio conselho da Anthropic é escrever prompts da mesma forma que você instruiria um novo colega inteligente que não sabe nada sobre seu projeto:

• Qual é a tarefa e quem lerá o resultado?
• Como é uma resposta bem-sucedida?
• Quais passos devem ser seguidos, em ordem?

Se um colega precisasse fazer uma pergunta de acompanhamento, Claude provavelmente também precisa dessa informação.

Use tags XML para separar as partes do seu prompt

Claude foi treinado para prestar atenção a tags no estilo XML. Elas não são uma sintaxe especial — qualquer nome de tag descritivo funciona — mas tornam inequívoco qual texto é uma instrução, qual é um dado e qual é um exemplo.

Você é um analista de contratos.

<contract>
{{COLE O CONTRATO AQUI}}
</contract>

<instructions>
1. Liste todas as cláusulas que criam uma obrigação de pagamento.
2. Para cada uma, cite a cláusula e explique-a em uma frase em linguagem simples.
3. Sinalize qualquer cláusula que permita à outra parte alterar os preços.
</instructions>

<output_format>
Retorne uma lista numerada. Coloque as cláusulas sinalizadas em uma seção separada
chamada "Riscos".
</output_format>

Dicas para tags:

• Nomeie-as de acordo com seu conteúdo: <email>, <data>, <style_guide>.
• Refira-se a elas em suas instruções: "Usando o relatório nas tags <report>…".
• Aninhe-as para hierarquia: <examples><example>…</example></examples>.
• Peça saída com tags quando precisar analisar a resposta: "Coloque a resposta final nas tags <answer>."

Coloque documentos longos primeiro, perguntas por último

Para entradas longas (relatórios, transcrições, bases de código), coloque os documentos no início do prompt e sua pergunta no final. A Anthropic observa que essa ordem pode melhorar notavelmente a qualidade da resposta em tarefas de contexto longo.

Para vários documentos, envolva cada um com seus metadados:

<documents>
  <document index="1">
    <source>q3-report.pdf</source>
    <document_content>{{RELATÓRIO}}</document_content>
  </document>
  <document index="2">
    <source>customer-survey.csv</source>
    <document_content>{{PESQUISA}}</document_content>
  </document>
</documents>

Usando apenas os documentos acima, explique por que a rotatividade aumentou no terceiro trimestre.
Cite as passagens que apoiam cada motivo.

Pedir a Claude para citar passagens relevantes antes de responder o mantém fundamentado em seu material.

Dê exemplos (multishot prompting)

Três a cinco exemplos diversos dentro de tags <example> são uma das maneiras mais confiáveis de controlar o tom e o formato:

<examples>
  <example>
    <input>Pedido chegou atrasado</input>
    <output>Categoria: Envio | Sentimento: Negativo | Urgência: Média</output>
  </example>
  <example>
    <input>Adorei as novas opções de cores!</input>
    <output>Categoria: Produto | Sentimento: Positivo | Urgência: Baixa</output>
  </example>
</examples>

Classifique esta mensagem no mesmo formato: {{MENSAGEM}}

Torne os exemplos variados para que Claude aprenda o padrão em vez de copiar um caso.

Deixe Claude pensar primeiro

Para análises, matemática, planejamento ou escrita que exija julgamento, peça a Claude para raciocinar antes de responder e para manter o raciocínio separado:

Pense no problema nas tags <thinking>. Em seguida, dê sua recomendação final
nas tags <answer>.

Isso torna as respostas mais precisas e permite que você verifique o raciocínio. Os modelos mais recentes de Claude também oferecem um modo de pensamento estendido integrado que faz isso automaticamente.

Atribua uma função com um prompt de sistema

Na API, o prompt system é o lugar certo para uma função ("Você é um cientista de dados sênior em uma empresa de tecnologia financeira"). No aplicativo Claude, basta iniciar sua mensagem com a função. Uma função específica muda o vocabulário, a profundidade e o tipo de riscos que Claude aponta.

Encadeie prompts para tarefas complexas

Divida grandes tarefas em uma sequência onde a saída de cada prompt (dentro de tags) se torna a entrada do próximo prompt:

1. Extrair fatos chave de um documento → <facts>
2. Rascunhar um resumo a partir de <facts> → <draft>
3. Revisar <draft> em relação ao original para erros → versão final

Cada etapa é mais simples, mais fácil de depurar e mais precisa do que um único prompt gigante.

Um modelo de prompt Claude reutilizável

Você é {{FUNÇÃO}}.

<context>
{{CONTEXTO, PÚBLICO, OBJETIVO}}
</context>

<input>
{{DOCUMENTO OU DADOS}}
</input>

<instructions>
1. {{PASSO 1}}
2. {{PASSO 2}}
3. {{PASSO 3}}
</instructions>

<constraints>
- Extensão: {{ex: menos de 300 palavras}}
- Tom: {{ex: neutro, linguagem simples}}
- Se a informação estiver faltando, diga isso em vez de adivinhar.
</constraints>

Pense nas tags <thinking> primeiro, depois dê a resposta final nas tags <answer>.

Pule o texto padrão

O Gerador de Prompt do Claude escreve essa estrutura para você: descreva a tarefa em uma frase e ele retorna um prompt com tags e passo a passo com marcadores de posição onde seus próprios documentos devem ser inseridos.