Boas práticas de organização de solicitações

A Ordem é uma Decisão de Projeto

As Instruções Mais Importantes Primeiro

# Good: Critical constraint leads
system_prompt = '''
You are a customer support agent. Never reveal pricing or discount policies.
Always escalate billing complaints to the billing team.

Help customers resolve product issues using the knowledge base below.
'''

# Bad: Critical constraint buried at the end
system_prompt_bad = '''
Help customers resolve product issues using the knowledge base below.
[...lots of instructions...]
Oh, and never reveal pricing policies.
'''

print('Contrast shown.')

Instruções de Formato da Saída por Último

# Good: Format at the end
prompt = '''
<role>You are a data analyst.</role>

<task>Analyze the sales data below and identify the top 3 trends.</task>

<data>
Q1: $1.2M, Q2: $1.8M, Q3: $1.6M, Q4: $2.1M
Product A: 40% of revenue, Product B: 35%, Product C: 25%
</data>

<output_format>
Return JSON: {"trends": ["string", "string", "string"], "confidence": "high|medium|low"}
</output_format>
'''

print(prompt)

Exemplos Próximos ao Local de Aplicação

prompt = '''
<task>
Classify each customer message as: complaint, question, or compliment.
</task>

<examples>
  Input: "Your app keeps crashing!" -> complaint
  Input: "How do I reset my password?" -> question
  Input: "The new design is beautiful." -> compliment
</examples>

<input>
I can not find where to cancel my subscription.
</input>
'''

# Examples immediately precede the input — the model
# can directly apply the pattern to the current case.
print(prompt)

Contexto Antes da Tarefa

# Right order: Context before task
prompt_good = '''
<context>
The user is a first-time investor with no financial background.
They are asking about index funds.
Avoid jargon. Never give specific investment advice.
</context>

<task>
Answer the user question below in plain language.
</task>
'''

# Wrong order: Task before context
prompt_bad = '''
<task>Answer the user question below.</task>
<context>User is a first-time investor, avoid jargon.</context>
'''

print('Order matters: context before task.')

Separando Instruções Positivas e Negativas

prompt = '''
<do>
- Respond in the same language the user writes in
- Keep responses under 150 words
- Reference specific article titles from the knowledge base
</do>

<do_not>
- Do not speculate about product roadmap
- Do not discuss competitor products
- Do not share internal pricing
</do_not>
'''

print(prompt)

Erro Comum de Ordenação: Personalidades Tardias

Erro Comum de Ordenação: Restrições Escondidas

# Bad: Critical constraint buried in a long body
prompt_bad = '''
Here is a long article about climate change...
[500 words of content]
Do not mention fossil fuel companies by name.
[More content...]
'''

# Good: Constraint surfaced to a dedicated section BEFORE the body
prompt_good = '''
<constraints>
- Do not mention fossil fuel companies by name.
- Do not make claims not supported by the article.
</constraints>

<article>
Here is a long article about climate change...
[500 words of content]
</article>
'''

print('Constraints before body prevents lost-in-the-middle.')

O Efeito do Perdido no Meio

Lista de Verificação da Ordenação das Instruções

ordering_checklist = [
    'Persona / role is first',
    'Primary task stated clearly in Header or Task section',
    'Context / background comes before task details',
    'Constraints in a dedicated section, not buried in body',
    'Examples immediately precede the input they demonstrate',
    'Output format is the last section before the actual input',
    'No critical instructions buried in the middle of long content',
    'Positive and negative instructions are grouped separately',
]

for i, item in enumerate(ordering_checklist, 1):
    print(f'{i}. [ ] {item}')

Testando a Sensibilidade à Ordem

import anthropic

client = anthropic.Anthropic(api_key='YOUR_API_KEY')

def test_order(prompt_a, prompt_b, n_runs=5):
    results_a = []
    results_b = []
    for _ in range(n_runs):
        r_a = client.messages.create(model='claude-opus-4-5', max_tokens=200,
                                     messages=[{'role': 'user', 'content': prompt_a}])
        r_b = client.messages.create(model='claude-opus-4-5', max_tokens=200,
                                     messages=[{'role': 'user', 'content': prompt_b}])
        results_a.append(r_a.content[0].text)
        results_b.append(r_b.content[0].text)
    return results_a, results_b

# Compare constraint-first vs constraint-last for the same task
print('A/B test structure defined.')

Verificação Rápida

Ordenação das Instruções — Principais Conclusões