Como encadear chamadas da API do Claude num fluxo de trabalho
3 min de leitura
Ao construir algo automatizado com a API do Claude, você provavelmente começa escrevendo um prompt grande que tenta fazer a tarefa inteira numa única chamada e depois se frustra quando parte da saída não é confiável.
Um fluxo que faz uma coisa por chamada é mais fácil de confiar do que um só prompt tentando fazer tudo de uma vez.
Uma tarefa por chamada, depois componha
Divida o trabalho como faria em código comum: uma chamada extrai ou classifica, uma segunda age sobre esse resultado. Cada chamada é mais simples de acertar, e você pode inspecionar a saída entre as etapas em vez de depurar um prompt longo e emaranhado.
- 1
Identifique a saída única da primeira chamada
Decida exatamente que resultado estruturado a primeira chamada precisa produzir, e nada além. Um trabalho mais estreito é mais fácil de acertar de forma confiável.
- 2
Passe esse resultado como entrada da segunda chamada
O prompt da segunda chamada deve se referir à saída real da primeira, não repetir do zero a entrada bruta original.
- 3
Dê a cada chamada seus próprios critérios claros de sucesso
Se a primeira etapa falhar ou devolver algo inesperado, você quer saber qual etapa quebrou, e não ter de desembaraçar uma resposta gigante.
Projete um fluxo de duas etapas: a primeira chamada lê um ticket de suporte colado e extrai o pedido real do cliente num resumo de uma frase mais uma categoria (cobrança, bug, pedido de recurso). A segunda chamada pega esse resumo e essa categoria e redige uma resposta inicial no nosso tom: direto, sem pedir desculpas a menos que a falha tenha sido nossa. Mostre-me o formato da requisição de cada etapa.
”
Dentro do Claude Tutorial
Dividir o trabalho em etapas menores é uma habilidade do Claude entre muitas
Dividir uma tarefa grande em etapas de propósito único que se apoiam umas nas outras aparece também nas lições do app, não só em fluxos construídos sobre a API.
Onde isso costuma dar errado
O erro mais comum é pular por completo a fronteira entre as chamadas, deixando o texto bruto e não estruturado da primeira alimentar direto a segunda. Peça à primeira chamada um formato específico e estruturado (um resumo curto, uma categoria, um pequeno conjunto de campos) em vez de prosa livre, para a segunda ter algo confiável em que se apoiar.
Atenção
Se você não consegue dizer com clareza o que a primeira chamada deve produzir antes de escrever o prompt dela, o fluxo provavelmente ainda não está dividido corretamente. Conserte a fronteira antes de acrescentar uma segunda chamada.
Continue lendo
- Conectando o Claude aos seus próprios dados e ferramentas com o MCP para ancorar uma etapa do fluxo em dados ao vivo, e não só no que foi colado.
- O que são os Artefatos do Claude? Uma introdução prática para chamar a API do Claude de dentro de um protótipo em execução, em vez do seu próprio código de backend.
- Fazendo uma mudança em vários arquivos com o Claude Code em vez de um arquivo por vez para o mesmo hábito de “descrever o resultado, verificar o resultado” aplicado à edição de código em vez de à composição de chamadas da API.