Melhores práticas de engenharia de prompt do Claude 4

Este guia fornece técnicas específicas de engenharia de prompt para modelos Claude 4 (Opus 4.1, Opus 4 e Sonnet 4) para ajudá-lo a obter resultados ideais em suas aplicações. Esses modelos foram treinados para seguir instruções de forma mais precisa do que as gerações anteriores de modelos Claude.

​

Princípios gerais

​

Seja explícito com suas instruções

Os modelos Claude 4 respondem bem a instruções claras e explícitas. Ser específico sobre o resultado desejado pode ajudar a melhorar os resultados. Clientes que desejam o comportamento “acima e além” dos modelos Claude anteriores podem precisar solicitar esses comportamentos de forma mais explícita com o Claude 4.

​

Adicione contexto para melhorar o desempenho

Fornecer contexto ou motivação por trás de suas instruções, como explicar ao Claude por que tal comportamento é importante, pode ajudar os modelos Claude 4 a entender melhor seus objetivos e entregar respostas mais direcionadas.

Claude é inteligente o suficiente para generalizar a partir da explicação.

​

Seja vigilante com exemplos e detalhes

Os modelos Claude 4 prestam atenção a detalhes e exemplos como parte do seguimento de instruções. Certifique-se de que seus exemplos estejam alinhados com os comportamentos que você deseja encorajar e minimize comportamentos que você deseja evitar.

​

Orientação para situações específicas

​

Controle o formato das respostas

Existem algumas maneiras que descobrimos serem particularmente eficazes para orientar a formatação de saída nos modelos Claude 4:

1. Diga ao Claude o que fazer em vez do que não fazer

   • Em vez de: “Não use markdown em sua resposta”
   • Tente: “Sua resposta deve ser composta por parágrafos de prosa fluida.”

2. Use indicadores de formato XML

   • Tente: “Escreva as seções de prosa de sua resposta em tags <smoothly_flowing_prose_paragraphs>.”

3. Combine o estilo do seu prompt com a saída desejada

   O estilo de formatação usado em seu prompt pode influenciar o estilo de resposta do Claude. Se você ainda estiver enfrentando problemas de direcionamento com a formatação de saída, recomendamos que, na medida do possível, combine o estilo do seu prompt com o estilo de saída desejado. Por exemplo, remover markdown do seu prompt pode reduzir o volume de markdown na saída.

​

Aproveite as capacidades de pensamento e pensamento intercalado

Claude 4 oferece capacidades de pensamento que podem ser especialmente úteis para tarefas envolvendo reflexão após o uso de ferramentas ou raciocínio complexo de múltiplas etapas. Você pode orientar seu pensamento inicial ou intercalado para obter melhores resultados.

Após receber resultados de ferramentas, reflita cuidadosamente sobre sua qualidade e determine os próximos passos ideais antes de prosseguir. Use seu pensamento para planejar e iterar com base nessas novas informações, e então tome a melhor próxima ação.

​

Otimize chamadas de ferramentas paralelas

Os modelos Claude 4 se destacam na execução paralela de ferramentas. Eles têm uma alta taxa de sucesso no uso de chamadas de ferramentas paralelas sem qualquer prompt para fazê-lo, mas alguns prompts menores podem aumentar esse comportamento para ~100% de taxa de sucesso no uso de ferramentas paralelas. Descobrimos que este prompt é mais eficaz:

Para máxima eficiência, sempre que você precisar realizar múltiplas operações independentes, invoque todas as ferramentas relevantes simultaneamente em vez de sequencialmente.

​

Reduza a criação de arquivos na codificação agêntica

Os modelos Claude 4 podem às vezes criar novos arquivos para fins de teste e iteração, particularmente ao trabalhar com código. Esta abordagem permite ao Claude usar arquivos, especialmente scripts python, como um ‘rascunho temporário’ antes de salvar sua saída final. Usar arquivos temporários pode melhorar os resultados, particularmente para casos de uso de codificação agêntica.

Se você preferir minimizar a criação de novos arquivos, pode instruir o Claude a se limpar:

Se você criar quaisquer novos arquivos temporários, scripts ou arquivos auxiliares para iteração, limpe esses arquivos removendo-os no final da tarefa.

​

Melhore a geração de código visual e frontend

Para geração de código frontend, você pode orientar os modelos Claude 4 a criar designs complexos, detalhados e interativos fornecendo encorajamento explícito:

Não se contenha. Dê o seu melhor.

Você também pode melhorar o desempenho frontend do Claude em áreas específicas fornecendo modificadores adicionais e detalhes sobre o que focar:

• “Inclua o maior número possível de recursos e interações relevantes”
• “Adicione detalhes cuidadosos como estados de hover, transições e micro-interações”
• “Crie uma demonstração impressionante mostrando capacidades de desenvolvimento web”
• “Aplique princípios de design: hierarquia, contraste, equilíbrio e movimento”

​

Evite focar em passar testes e codificação rígida

Modelos de linguagem de fronteira podem às vezes focar muito em fazer testes passarem às custas de soluções mais gerais. Para prevenir esse comportamento e garantir soluções robustas e generalizáveis:

Por favor, escreva uma solução de alta qualidade e propósito geral. Implemente uma solução que funcione corretamente para todas as entradas válidas, não apenas os casos de teste. Não codifique valores rigidamente ou crie soluções que funcionem apenas para entradas de teste específicas. Em vez disso, implemente a lógica real que resolve o problema de forma geral.

Foque em entender os requisitos do problema e implementar o algoritmo correto. Os testes estão lá para verificar a correção, não para definir a solução. Forneça uma implementação fundamentada que siga as melhores práticas e princípios de design de software.

Se a tarefa for irrazoável ou inviável, ou se algum dos testes estiver incorreto, por favor me informe. A solução deve ser robusta, manutenível e extensível.

​

Considerações de migração

Ao migrar do Sonnet 3.7 para o Claude 4:

1. Seja específico sobre o comportamento desejado: Considere descrever exatamente o que você gostaria de ver na saída.

2. Enquadre suas instruções com modificadores: Adicionar modificadores que encorajem o Claude a aumentar a qualidade e o detalhe de sua saída pode ajudar a molhar melhor o desempenho do Claude. Por exemplo, em vez de “Crie um painel de análise”, use “Crie um painel de análise. Inclua o maior número possível de recursos e interações relevantes. Vá além do básico para criar uma implementação totalmente funcional.”

3. Solicite recursos específicos explicitamente: Animações e elementos interativos devem ser solicitados explicitamente quando desejados.