# Encadeamento de prompts: divida tarefas complexas em etapas

> O encadeamento de prompts usa a saída de um prompt como entrada do próximo e resolve tarefas complexas demais para uma única ida e volta. Conheça os padrões principais e onde eles falham.

Fonte: Promptea — https://www.promptea.me/pt/guides/prompt-chaining · Idioma: Português · Última atualização: 2026-11-14

## O que é encadeamento de prompts e quando usar

- Uma cadeia de prompts é uma sequência de prompts em que cada saída passa a fazer parte da entrada do prompt seguinte.
- Use quando uma tarefa tem fases distintas que ganham com foco separado: pesquisa → estrutura → rascunho → edição.
- Use quando um único prompt ultrapassaria o contexto útil do modelo ou exigiria instruções demais competindo entre si.
- Use quando você precisa validar ou transformar os dados entre as etapas antes de passá-los adiante.
- Evite em tarefas simples — o encadeamento acrescenta complexidade e latência que só se justificam quando a tarefa realmente exige raciocínio sequencial.

## Três padrões de encadeamento

- Sequencial: Etapa A → Etapa B → Etapa C. Cada etapa consome só a saída da anterior. Bom para fluxos lineares, como extrair → validar → formatar.
- Ramificado: uma entrada gera várias saídas em paralelo e uma etapa final as sintetiza. Bom para rascunhos concorrentes ou pesquisa com várias perspectivas.
- Em loop: uma etapa roda repetidamente até que uma condição de qualidade seja atendida (ex.: um prompt revisor avalia a saída e pede uma reescrita até ela ser aprovada). Use com um limite rígido de iterações.
- Combine padrões quando precisar — uma cadeia sequencial pode ter uma etapa ramificada no meio.

## Erros comuns no encadeamento de prompts

- Passar saídas sem validar: se a Etapa A pode gerar um JSON malformado ou dados incompletos, a Etapa B herda o problema. Valide ou limpe as saídas entre as etapas.
- Acumular contexto demais: colar saídas anteriores inteiras em todas as etapas incha o contexto. Passe só o que a próxima etapa realmente precisa.
- Loops sem condição de parada: sempre defina como é o 'pronto' e limite as iterações. Sem isso, uma cadeia em loop pode rodar indefinidamente.
- Pular a verificação intermediária: em cadeias de alto risco, acrescente uma revisão rápida entre as transformações pesadas em vez de descobrir os erros só na etapa final.

## Templates

### Pipeline de extração de dados: extrair → validar → formatar

```text
ETAPA 1 — EXTRAIR
Do texto bruto abaixo, extraia todos os itens da nota fiscal.
Retorne APENAS JSON: {"items": [{"description": "string", "quantity": number, "unit_price": number}]}
Se um campo estiver faltando, use null. Não invente valores.

Texto bruto:
"""[cole o texto da nota fiscal aqui]"""

---
ETAPA 2 — VALIDAR (envie aqui a saída da Etapa 1)
Revise o JSON abaixo para conferir se está correto.
- Sinalize os itens em que quantity ou unit_price sejam null.
- Sinalize as descrições que pareçam cabeçalhos ou totais, e não itens.
- Retorne: {"valid_items": [...], "flagged": [...], "issues": ["string"]}

JSON da Etapa 1:
"""[cole aqui a saída da Etapa 1]"""

---
ETAPA 3 — FORMATAR (envie aqui os valid_items da Etapa 2)
Converta os itens validados abaixo em uma tabela Markdown com as colunas: Descrição | Quantidade | Preço unitário | Total da linha.
Calcule Total da linha = quantity × unit_price. Se algum dos dois for null, mostre "—".
Ordene por Total da linha, do maior para o menor.

valid_items:
"""[cole aqui os valid_items da Etapa 2]"""
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=ETAPA+1+%E2%80%94+EXTRAIR%0ADo+texto+bruto+abaixo%2C+extraia+todos+os+itens+da+nota+fiscal.%0ARetorne+APENAS+JSON%3A+%7B%22items%22%3A+%5B%7B%22description%22%3A+%22string%22%2C+%22quantity%22%3A+number%2C+%22unit_price%22%3A+number%7D%5D%7D%0ASe+um+campo+estiver+faltando%2C+use+null.+N%C3%A3o+invente+valores.%0A%0ATexto+bruto%3A%0A%22%22%22%5Bcole+o+texto+da+nota+fiscal+aqui%5D%22%22%22%0A%0A---%0AETAPA+2+%E2%80%94+VALIDAR+%28envie+aqui+a+sa%C3%ADda+da+Etapa+1%29%0ARevise+o+JSON+abaixo+para+conferir+se+est%C3%A1+correto.%0A-+Sinalize+os+itens+em+que+quantity+ou+unit_price+sejam+null.%0A-+Sinalize+as+descri%C3%A7%C3%B5es+que+pare%C3%A7am+cabe%C3%A7alhos+ou+totais%2C+e+n%C3%A3o+itens.%0A-+Retorne%3A+%7B%22valid_items%22%3A+%5B...%5D%2C+%22flagged%22%3A+%5B...%5D%2C+%22issues%22%3A+%5B%22string%22%5D%7D%0A%0AJSON+da+Etapa+1%3A%0A%22%22%22%5Bcole+aqui+a+sa%C3%ADda+da+Etapa+1%5D%22%22%22%0A%0A---%0AETAPA+3+%E2%80%94+FORMATAR+%28envie+aqui+os+valid_items+da+Etapa+2%29%0AConverta+os+itens+validados+abaixo+em+uma+tabela+Markdown+com+as+colunas%3A+Descri%C3%A7%C3%A3o+%7C+Quantidade+%7C+Pre%C3%A7o+unit%C3%A1rio+%7C+Total+da+linha.%0ACalcule+Total+da+linha+%3D+quantity+%C3%97+unit_price.+Se+algum+dos+dois+for+null%2C+mostre+%22%E2%80%94%22.%0AOrdene+por+Total+da+linha%2C+do+maior+para+o+menor.%0A%0Avalid_items%3A%0A%22%22%22%5Bcole+aqui+os+valid_items+da+Etapa+2%5D%22%22%22&purpose=data&target=gpt)

### Cadeia da pesquisa ao relatório: reunir → estruturar → redigir

```text
ETAPA 1 — REUNIR OS PONTOS PRINCIPAIS
Tema: [seu tema]
Público: [quem vai ler]

Liste as 5–7 coisas mais importantes que alguém deste público precisa entender sobre este tema.
Para cada ponto, anote: (a) por que importa para este público, (b) um exemplo concreto ou uma evidência.
Formato: lista numerada. Seja direto — sem frases de enchimento.

---
ETAPA 2 — ESTRUTURAR (envie aqui a saída da Etapa 1)
Com base nos pontos principais abaixo, crie uma estrutura para um [post de blog / relatório / briefing] de aproximadamente [número de palavras] palavras.
Cada seção precisa corresponder a um ou mais pontos principais.
Formato: ## Título da seção → lista em tópicos do que cada parágrafo vai cobrir.

Pontos principais da Etapa 1:
"""[cole aqui a saída da Etapa 1]"""

---
ETAPA 3 — REDIGIR (envie aqui a estrutura da Etapa 2)
Escreva o [post de blog / relatório / briefing] completo seguindo a estrutura abaixo.
Tom: [profissional / conversacional / técnico]
Restrições:
- Fique dentro de [número de palavras] palavras (±10%).
- Não acrescente seções que não estejam na estrutura.
- Não use frases de enchimento como "No mundo de hoje" ou "Vale ressaltar que".
- Termine com uma conclusão ou um próximo passo claro.

Estrutura:
"""[cole aqui a estrutura da Etapa 2]"""
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=ETAPA+1+%E2%80%94+REUNIR+OS+PONTOS+PRINCIPAIS%0ATema%3A+%5Bseu+tema%5D%0AP%C3%BAblico%3A+%5Bquem+vai+ler%5D%0A%0AListe+as+5%E2%80%937+coisas+mais+importantes+que+algu%C3%A9m+deste+p%C3%BAblico+precisa+entender+sobre+este+tema.%0APara+cada+ponto%2C+anote%3A+%28a%29+por+que+importa+para+este+p%C3%BAblico%2C+%28b%29+um+exemplo+concreto+ou+uma+evid%C3%AAncia.%0AFormato%3A+lista+numerada.+Seja+direto+%E2%80%94+sem+frases+de+enchimento.%0A%0A---%0AETAPA+2+%E2%80%94+ESTRUTURAR+%28envie+aqui+a+sa%C3%ADda+da+Etapa+1%29%0ACom+base+nos+pontos+principais+abaixo%2C+crie+uma+estrutura+para+um+%5Bpost+de+blog+%2F+relat%C3%B3rio+%2F+briefing%5D+de+aproximadamente+%5Bn%C3%BAmero+de+palavras%5D+palavras.%0ACada+se%C3%A7%C3%A3o+precisa+corresponder+a+um+ou+mais+pontos+principais.%0AFormato%3A+%23%23+T%C3%ADtulo+da+se%C3%A7%C3%A3o+%E2%86%92+lista+em+t%C3%B3picos+do+que+cada+par%C3%A1grafo+vai+cobrir.%0A%0APontos+principais+da+Etapa+1%3A%0A%22%22%22%5Bcole+aqui+a+sa%C3%ADda+da+Etapa+1%5D%22%22%22%0A%0A---%0AETAPA+3+%E2%80%94+REDIGIR+%28envie+aqui+a+estrutura+da+Etapa+2%29%0AEscreva+o+%5Bpost+de+blog+%2F+relat%C3%B3rio+%2F+briefing%5D+completo+seguindo+a+estrutura+abaixo.%0ATom%3A+%5Bprofissional+%2F+conversacional+%2F+t%C3%A9cnico%5D%0ARestri%C3%A7%C3%B5es%3A%0A-+Fique+dentro+de+%5Bn%C3%BAmero+de+palavras%5D+palavras+%28%C2%B110%25%29.%0A-+N%C3%A3o+acrescente+se%C3%A7%C3%B5es+que+n%C3%A3o+estejam+na+estrutura.%0A-+N%C3%A3o+use+frases+de+enchimento+como+%22No+mundo+de+hoje%22+ou+%22Vale+ressaltar+que%22.%0A-+Termine+com+uma+conclus%C3%A3o+ou+um+pr%C3%B3ximo+passo+claro.%0A%0AEstrutura%3A%0A%22%22%22%5Bcole+aqui+a+estrutura+da+Etapa+2%5D%22%22%22&purpose=text&target=claude)

## Perguntas frequentes

### Quantas etapas são demais em uma cadeia de prompts?

Não existe um máximo fixo, mas cada etapa acrescenta latência, custo e um novo ponto de falha. Na prática, a maioria das tarefas se resolve bem com 2–4 etapas. Se a sua cadeia passar de 6 etapas, reavalie se algumas podem ser unidas ou se a tarefa deveria ser dividida em subtarefas independentes, com cadeias separadas.

### Preciso enviar todas as saídas anteriores para cada etapa seguinte?

Não — e normalmente não deveria. Envie só o que a próxima etapa precisa para fazer o trabalho dela. Passar o histórico completo de todas as etapas anteriores incha o contexto, aumenta o custo e pode confundir o modelo, dando a ele raciocínios anteriores irrelevantes para 'considerar'. Extraia e passe só o subconjunto relevante.
