• OBSERVAR
  • AUDITAR
  • REPARAR
  • MANUAL

Como depurar estados de threads do LangGraph com sua IA

Conecte seu agente ao LangGraph Cloud para analisar threads ativos. Você identifica exatamente onde um processo travou e o corrige sem precisar recomeçar do zero.

Pergunte à IA sobre esta página

Resposta rápida

Como posso depurar o estado da thread do meu agente?

Sua IA utiliza ferramentas do LangGraph Cloud para buscar o estado atual de qualquer thread ou listar todas as threads ativas. Ao encontrar o erro, você pode enviar um novo estado para a thread para contornar o bug ou corrigir a lógica. Isso oferece um caminho direto para destravar agentes.

Onde seu esforço de depuração foca.

Correção da lógica do agente.

A IA cuida da recuperação de dados e da injeção de estado para que você foque apenas na lógica.

OBSERVAR

Identificar o gargalo

A IA busca o estado atual de uma thread específica. Você visualiza claramente as variáveis e o histórico que causaram a interrupção.

AUDITAR

Localizar a thread correta

A IA varre suas sessões ativas. Você encontra rapidamente o ID da thread específica que precisa de atenção.

REPARAR

Injetar estado corrigido

A IA envia uma atualização manual para a thread. Isso permite sobrescrever dados incorretos e manter o agente em execução.

MANUAL

Intervenção humana

A IA identifica o erro, mas você decide se a mudança de estado é segura. Você detém o controle final sobre a lógica do agente.

O fluxo

O que sua IA faz quando a demanda chega.

A IA atua como uma ponte entre sua interface de chat e o runtime do LangGraph Cloud.

  1. Localizar a thread

    A IA encontra a conversa ou processo específico que você precisa analisando todas as threads existentes.

    list_threads

  2. Inspecionar os dados

    A IA lê os valores exatos, o histórico de checkpoints e as variáveis atuais armazenadas naquela thread.

    get_thread_state

  3. Analisar o erro

    Seu agente compara o estado atual com a lógica esperada para encontrar onde ocorreu o loop ou o erro.

    get_thread_state

  4. Corrigir o estado

    A IA escreve novos dados na thread para corrigir um erro ou pular um nó quebrado.

    update_thread_state

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar a depuração imediatamente.

Pontos de partida

Substitua os IDs de thread e os nomes de variáveis pelos seus dados reais do LangGraph.

LangGraph Cloud Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — LangGraph Cloud capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "langgraph-cloud-stateful-ai-agents-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_W9eYJ3x7BufqP9zavlkhkY5HUux0v9z8z0xZYWei/mcp"
    }
  }
}
Copie no chat04

  • Liste todas as minhas threads ativas do LangGraph para eu encontrar a que está travada.

  • Mostre o estado atual da thread id 'abc-123' para eu entender por que o agente parou.

  • Atualize o estado da thread 'xyz-789' definindo a variável 'user_input' como 'retry'.

  • Verifique o estado da thread 'debug-456' e me diga qual foi o último nó executado com sucesso.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o LangGraph Cloud uma vez e pronto.

Basta vincular sua conta. Suas credenciais ficam criptografadas e você pode começar a depurar threads pelo seu cliente de IA preferido na hora.

Conectar LangGraph Cloud à sua IA

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode deletar uma thread?

    Não. A IA só pode listar, ler ou atualizar estados de threads. Deletar threads deve ser feito manualmente no LangGraph Cloud.

  • 02

    Atualizar um estado dispara um novo nó imediatamente?

    A IA atualiza o estado, mas a execução real do próximo nó depende da sua configuração do LangGraph e de como você dispara o grafo.

  • 03

    A IA consegue ver meu banco de dados inteiro?

    Não. A IA só acessa os estados de threads específicos e os metadados fornecidos pelas ferramentas do LangGraph Cloud.

  • 04

    A IA pode alterar o código do grafo?

    Não. A IA só pode modificar os dados dentro de uma thread em execução, não a lógica Python ou a estrutura do grafo.

  • 05

    Como encontro um ID de thread específico?

    Você pode pedir para a IA listar todas as threads, o que retornará os IDs disponíveis para você escolher.

  • Mais dúvidas sobre o LangGraph Cloud? A página do Connector responde. Veja tudo o que o LangGraph Cloud Connector pode fazer

Conecte LangGraph Cloud ao Claude, Cursor, ChatGPT e outros