0Pricing
AI Prompt Engineering · Aula

Padrões de resultado para entrada

Extraia dados estruturados da Etapa 1 para inseri-los na Etapa 2.

Padrões de resultado para entrada é uma aula grátis de AI Prompt Engineering no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de AI Prompt Engineering, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Prompt Engineering inclui 4 aulas no total.

O Desafio Central: Extração e Injeção

Em uma cadeia de instruções, a Etapa 1 produz texto. A Etapa 2 precisa de uma parte específica desse texto como entrada. O desafio é extrair de forma confiável exatamente o campo correto da saída da Etapa 1 e injetá-lo de forma organizada na instrução da Etapa 2.

Se a Etapa 1 retornar texto corrido não estruturado, a extração será frágil. A solução é projetar as instruções da Etapa 1 para retornar uma saída estruturada — normalmente JSON — que possa ser analisada e injetada programaticamente.

Projetando a Etapa 1 para processamento automático

Uma instrução destinada a alimentar uma cadeia deve sempre produzir dados estruturados. Especifique o esquema JSON exato na instrução:

import anthropic
import json

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

step1_prompt = '''
<task>
Analyze the customer review below.
</task>

<review>
The onboarding was confusing and took 3 hours. The core feature works great though.
</review>

<output_format>
Return ONLY a JSON object. No other text.
{
  "sentiment": "positive|negative|mixed",
  "issues": ["string"],
  "positives": ["string"],
  "priority": "high|medium|low"
}
</output_format>
'''

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=300,
    messages=[{'role': 'user', 'content': step1_prompt}]
)
print(response.content[0].text)

Analisando a saída da Etapa 1

Quando a Etapa 1 retornar JSON, analise-o em Python e extraia os campos necessários para a Etapa 2:

import json

def parse_step1_output(raw_text):
    # Models sometimes wrap JSON in extra text -- strip it
    text = raw_text.strip()
    # Find the first { and last } to extract JSON object
    start = text.find("{")
    end = text.rfind("}")
    if start != -1 and end != -1 and end > start:
        text = text[start:end+1]
    try:
        return json.loads(text)
    except json.JSONDecodeError as e:
        raise ValueError("Step 1 output is not valid JSON: " + str(e))

# Example usage
raw = '{"sentiment": "mixed", "issues": ["confusing onboarding"], "positives": ["core feature"], "priority": "high"}'
parsed = parse_step1_output(raw)
print(parsed['issues'])
print(parsed['priority'])

Inserindo campos extraídos na Etapa 2

Após a análise, insira campos específicos no modelo de instrução da Etapa 2. Use f-strings do Python ou variáveis de modelo:

def build_step2_prompt(parsed_step1):
    issues = '\n'.join(f'- {issue}' for issue in parsed_step1['issues'])
    priority = parsed_step1['priority']
    sentiment = parsed_step1['sentiment']

    return f'''
<context>
A customer review was analyzed. Overall sentiment: {sentiment}. Priority: {priority}.
</context>

<task>
Write a customer support response addressing these specific issues:
{issues}
Acknowledge the positives before addressing the issues.
</task>

<output_format>
Plain text response, 3 sentences maximum, professional tone.
</output_format>
'''

parsed = {'sentiment': 'mixed', 'issues': ['confusing onboarding'], 'priority': 'high', 'positives': ['core feature']}
print(build_step2_prompt(parsed))

Cadeia completa de duas etapas

Combinando análise e inserção em um fluxo completo de duas etapas:

import anthropic, json

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

def call(prompt, max_tokens=500):
    r = client.messages.create(
        model='claude-opus-4-5', max_tokens=max_tokens,
        messages=[{'role': 'user', 'content': prompt}]
    )
    return r.content[0].text

def review_response_chain(review_text):
    # Step 1: Analyze
    step1 = call(f'Analyze this review. Return JSON: {{"sentiment": str, "issues": [str], "priority": str}}\n\nReview: {review_text}')
    parsed = json.loads(step1.strip())

    # Inject into Step 2
    issues_str = ', '.join(parsed['issues'])
    step2_prompt = f'Write a 2-sentence support reply. Issues to address: {issues_str}. Priority: {parsed["priority"]}.'

    # Step 2: Draft response
    reply = call(step2_prompt)
    return reply

print(review_response_chain('Login is broken. App crashes on startup.'))

Tratando a inserção de JSON aninhado

Quando a Etapa 1 retornar objetos aninhados, extraia somente o que a Etapa 2 precisa para manter concisa a instrução inserida:

step1_output = {
    'document': {
        'title': 'Q3 Report',
        'sections': [
            {'name': 'Revenue', 'value': '$4.2M', 'change': '+12%'},
            {'name': 'Users', 'value': '85,000', 'change': '+5%'},
            {'name': 'Churn', 'value': '3.2%', 'change': '-0.8%'}
        ]
    },
    'summary': 'Strong revenue quarter with moderate user growth.'
}

# Extract only what Step 2 needs — not the full nested object
def extract_for_step2(data):
    sections = data['document']['sections']
    metrics = '\n'.join(f"{s['name']}: {s['value']} ({s['change']})" for s in sections)
    return {
        'metrics': metrics,
        'summary': data['summary']
    }

step2_input = extract_for_step2(step1_output)
print(step2_input)

Evitando inserções excessivas

Um erro comum é inserir toda a saída da Etapa 1 na Etapa 2. Isso torna a instrução da Etapa 2 excessivamente grande e pode confundir o modelo com campos irrelevantes.

  • Inadequado: f'Here is the analysis: {str(all_of_step1_output)}'
  • Adequado: Extraia somente os campos específicos de que a Etapa 2 precisa e insira-os com rótulos claros

A Etapa 2 deve receber exatamente as informações de que precisa — nem mais, nem menos.

Ramificação condicional com base na saída

A saída analisada da Etapa 1 pode controlar qual instrução da Etapa 2 será executada — transformando uma cadeia linear em um fluxo ramificado:

def route_chain(user_message):
    # Step 1: Classify intent
    classification = json.loads(call(
        f'Classify this message as billing, technical, or general. Return JSON: {{"intent": str}}\n\nMessage: {user_message}'
    ))

    intent = classification['intent']

    # Route to specialized Step 2 prompt
    if intent == 'billing':
        prompt = f'You are a billing specialist. Address: {user_message}'
    elif intent == 'technical':
        prompt = f'You are a senior engineer. Provide technical guidance for: {user_message}'
    else:
        prompt = f'You are a general support agent. Respond to: {user_message}'

    return call(prompt)

print(route_chain('My invoice shows a wrong amount.'))

Acumulando estado entre etapas

Para cadeias mais longas, mantenha um dicionário de estado que acumule as saídas de cada etapa:

def run_pipeline(initial_input):
    state = {'input': initial_input}

    # Step 1
    state['entities'] = json.loads(call(
        f'Extract entities as JSON: {{"people": [], "companies": []}}\n\n{state["input"]}'
    ))

    # Step 2 uses entities from Step 1
    companies_str = ', '.join(state['entities'].get('companies', []))
    state['company_types'] = call(
        f'Classify these companies as startup/enterprise: {companies_str}'
    )

    # Step 3 uses output from Steps 1 and 2
    state['summary'] = call(
        f'Write a 2-sentence summary.\nEntities: {state["entities"]}\nClassifications: {state["company_types"]}'
    )

    return state

result = run_pipeline('Apple and OpenAI announced a partnership with Elon Musk.')
print(result['summary'])

Utilitários de extração de JSON

Crie um utilitário de extração reutilizável para a infraestrutura da sua cadeia:

import re, json

def extract_json(text):
    "Extract JSON from model output, handling extra text around the object."
    # Try direct parse first
    try:
        return json.loads(text.strip())
    except json.JSONDecodeError:
        pass
    # Try finding JSON object by bracket matching
    start = text.find("{")
    end = text.rfind("}")
    if start != -1 and end != -1 and end > start:
        try:
            return json.loads(text[start:end+1])
        except json.JSONDecodeError:
            pass
    # Try finding JSON array
    start = text.find("[")
    end = text.rfind("]")
    if start != -1 and end != -1 and end > start:
        try:
            return json.loads(text[start:end+1])
        except json.JSONDecodeError:
            pass
    raise ValueError("Could not extract JSON from: " + text[:200])

print(extract_json('{"key": "value"}'))

Testando padrões de saída para entrada

Os fluxos de saída para entrada precisam de dois níveis de testes:

  • Teste cada etapa individualmente: A Etapa 1 retorna JSON analisável de forma confiável? A Etapa 2 produz a saída correta para uma determinada entrada extraída?
  • Teste de integração da cadeia: O fluxo de ponta a ponta produz resultados corretos para entradas representativas?

Mantenha as instruções das etapas determinísticas usando temperatura=0 nas etapas de classificação e extração em que a consistência é importante.

def test_step1(review_text, expected_sentiment):
    raw = call(f'Analyze review. Return JSON: {{"sentiment": str}}\n\n{review_text}')
    parsed = extract_json(raw)
    assert parsed['sentiment'] == expected_sentiment, f'Expected {expected_sentiment}, got {parsed["sentiment"]}'
    print(f'PASS: sentiment={parsed["sentiment"]}')

# Run unit test for Step 1
test_step1('The product is excellent!', 'positive')
test_step1('This is terrible.', 'negative')

Verificação rápida

Qual é o formato de saída recomendado para a Etapa 1 de uma cadeia de instruções quando o resultado será extraído programaticamente e inserido na Etapa 2?

Da saída à entrada — principais conclusões

Padrões confiáveis de saída para entrada são o que tornam as cadeias de instruções prontas para produção:

  • Projete as instruções da Etapa 1 para retornarem JSON com um esquema explícito — não prosa
  • Analise a saída da Etapa 1 antes de inseri-la: remova os delimitadores Markdown e trate erros de decodificação JSON
  • Insira somente os campos específicos de que a Etapa 2 precisa — evite inserções excessivas
  • Use dicionários de estado para acumular e transmitir dados entre cadeias mais longas
  • A saída analisada pode conduzir uma ramificação condicional para encaminhar a execução a instruções especializadas da Etapa 2
  • Crie utilitários reutilizáveis de extração de JSON que tratem inconsistências na saída do modelo
  • Teste cada etapa individualmente e, depois, faça um teste de integração do fluxo completo

Perguntas Frequentes

A aula “Padrões de resultado para entrada” é grátis?

Sim — o texto completo de “Padrões de resultado para entrada” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de AI Prompt Engineering, atualize para CoddyKit PRO. O curso de AI Prompt Engineering inclui 4 aulas no total.

O que vou aprender em “Padrões de resultado para entrada”?

Extraia dados estruturados da Etapa 1 para inseri-los na Etapa 2. Você pratica AI Prompt Engineering com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar AI Prompt Engineering?

Nenhuma experiência prévia é necessária. AI Prompt Engineering no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Padrões de resultado para entrada”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de AI Prompt Engineering?

Sim. Cada aula de AI Prompt Engineering inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. O que é encadeamento de solicitações?
  2. Padrões de resultado para entrada
  3. Cadeias de transformação sequencial
  4. Tratamento de erros em cadeias de solicitações
← Voltar para AI Prompt Engineering