Pare, retome e reinicie

Stop interrompe a execução, Resume tenta continuar a partir do estado salvo e Restart começa novamente. Isso é importante quando as ações têm efeitos.

Estas etapas referem-se aos recursos identificados no código do aplicativo. Este material não foi validado em uma instância ativa; verifique a documentação e as opções da sua versão.

Como funciona, passo a passo

O contexto é a bancada

O contexto inclui instruções, a solicitação atual, histórico relevante, documentos recuperados e resultados da ferramenta. A janela de contexto tem capacidade limitada; reserve espaço para a resposta também. Mais texto não melhora automaticamente a precisão. Informações irrelevantes e contradições podem ocultar provas importantes. Resuma o histórico da conversa com cuidado e preserve a origem dos fatos. O estado descreve a execução atual, um ponto de verificação salva um ponto recuperável e a memória persistente retém informações entre as execuções. São diferentes mecanismos gerenciados pelo aplicativo.

Erros precisam de caminhos explícitos

Um tempo limite é diferente de um erro de permissão. Tente novamente apenas erros transitórios, com tentativas limitadas e atrasos crescentes. Uma operação com efeitos colaterais pode ser executada antes que sua resposta seja perdida; tentar novamente sem uma chave de idempotência pode duplicar o efeito. O streaming mostra o progresso, mas não garante a conclusão. Os pontos de verificação podem permitir que estágios com falha sejam retomados dentro dos limites de tempo de execução. Armazene o identificador de execução, estágio, duração e erro enquanto remove segredos dos logs. Meça caminhos lentos, bem como médias.

O modelo propõe, a ferramenta executa

A chamada da ferramenta produz uma solicitação de chamada com nome e argumentos. A aplicação valida o esquema, as permissões e os limites antes da execução. O resultado retorna ao contexto para a próxima etapa. Por exemplo, get_product_stock pega um SKU e retorna uma quantidade; sua descrição deverá explicar que não reserva produtos. Distinguir resultados vazios, erros de validação, falta de acesso e tempos limite. JSON válido não prova que os argumentos estão corretos ou que a ação está autorizada. Para efeitos externos, considere também a execução duplicada.

O esquema explicativo

Siga as setas sólidas para o fluxo principal. As setas azuis tracejadas fornecem dados ou contexto; setas rosa tracejadas mostram feedback ou retorno de resultados. Cores e formas distinguem modelos, lojas, decisões e resultados. Resume usa a execução salva; A reinicialização inicia uma nova. Um ponto de verificação não é uma memória persistente. Em telas pequenas, role na horizontal para acompanhar o esquema completo.

Um exemplo completo

Um fluxo de trabalho recupera a política e, em seguida, atinge uma ferramenta indisponível. O currículo pode reter o trabalho concluído quando existe um ponto de verificação. A reinicialização pode repetir a recuperação e outras operações.

Experimente você mesmo

1. Teste a interrupção em um fluxo de trabalho somente leitura e compare Retomar com Reiniciar.
2. Registre a entrada, a fonte e o resultado esperado antes de executar o experimento. Use apenas os dados fictícios do exemplo.
3. Siga as etapas do diagrama. A cada passo registre quais informações são recebidas e produzidas; não confunda o resultado intermediário com o resultado final.
4. Repita após remover as informações necessárias ou tornar a entrada ambígua. Verifique se o sistema esclarece, interrompe ou inventa uma resposta.
5. Compare com a solução explicada. Guarde a configuração, data, resultado e explicação das diferenças. Mude uma coisa e teste novamente.

Uma solução explicada

Escolha a recuperação após verificar as etapas concluídas e seus efeitos. Um exercício bem-sucedido permite mostrar a conexão entre entradas, etapas e resultados. Quando falta informação, uma resposta cautelosa é mais útil do que detalhes inventados. Compare mais do que estilo: verifique também as condições, fontes e operações.

Quando esta abordagem ajuda e quais são seus limites

Parar não desfaz operações concluídas. Escolha esta abordagem quando ela melhorar uma necessidade medida. Mantenha uma linha de base simples e compare os resultados usando dados idênticos. Um exemplo de sucesso não estabelece confiabilidade em todas as situações.

Verifique o que aprendeu

Um ponto de verificação é uma memória de usuário permanente?

Não. Salvar uma corrida não implica manter preferências entre conversas.

O tempo limite prova que a operação não foi executada?

Não. Verifique o estado antes de tentar novamente uma ação com efeitos colaterais.

Que resultado este exercício deve produzir?

Escolha a recuperação após verificar as etapas concluídas e seus efeitos.

Termos para lembrar

• Ponto de verificação: estado salvo usado para retomar uma execução.
• Idempotência: Repetição controlada sem duplicar um efeito.
• Chamada de ferramenta: uma solicitação estruturada para usar um recurso externo.

Fontes e sua próxima etapa

• LangGraph — Fluxos de trabalho e agentes

Para preparar: U02 — Playground como laboratório