• TRACE
  • ERROR
  • INPUT
  • HUMAN

Como depurar execuções de agentes com seu IA usando LangSmith

Conecte o LangSmith ao seu agente para inspecionar rastros de execução. Com essa conexão, sua IA acessa dados específicos para identificar onde a lógica falhou.

Pergunte à IA sobre esta página

Resposta rápida

Como posso usar minha IA para descobrir por que uma execução de agente falhou?

Sua IA utiliza o LangSmith para buscar rastros de erro e detalhes de execução. Ela identifica o passo exato onde o fluxo travou, entregando o contexto necessário para você corrigir o problema.

Resultados da depuração.

Para onde sua investigação leva.

A IA categoriza os dados encontrados em resultados claros.

TRACE

Caminhos de execução

A IA extrai a sequência de eventos de uma execução. Você vê exatamente quais ferramentas foram chamadas e o que elas retornaram.

ERROR

Causa raiz

A IA isola a mensagem de erro específica. Você recebe o motivo exato pelo qual a execução parou.

INPUT

Validação de dados

A IA verifica os dados enviados em cada etapa. Você descobre onde dados malformados causaram a falha.

HUMAN

Ajustes manuais

A IA sinaliza execuções que exigem mudanças nos seus prompts ou na lógica das ferramentas. Esses ajustes ficam sob seu controle.

O fluxo

O que sua IA faz quando uma execução falha.

A IA atua como uma ferramenta de perícia para seus dados do LangSmith.

  1. Localizar a falha

    A IA varre seu histórico recente para encontrar a execução específica que você deseja analisar.

    langsmith_list_runs

  2. Recuperar o rastro

    A IA extrai os detalhes granulares e os metadados daquela execução que falhou.

    langsmith_get_run

  3. Analisar o erro

    A IA compara o resultado esperado com o erro real retornado pelo sistema.

    langsmith_get_run

  4. Resumir a correção

    A IA explica por que a execução falhou e sugere como ajustar a lógica do seu agente.

    langsmith_get_run

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar sua investigação.

Pontos de partida

Substitua o texto entre colchetes pelos IDs de execução ou descrições de erro reais.

LangSmith Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_JBueIzhraYvzf2S9aR0UP9Q6bjldfIBgmwxTvRHt/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 — LangSmith capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "langsmith-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_JBueIzhraYvzf2S9aR0UP9Q6bjldfIBgmwxTvRHt/mcp"
    }
  }
}
Copie no chat04

  • Encontre a última execução que falhou no LangSmith e me diga por que ela travou.

  • Pegue os detalhes da execução 'run_123abc' e explique o erro na chamada da ferramenta.

  • Liste todas as execuções que falharam na última hora para eu identificar o padrão.

  • Analise o rastro da execução 'run_456def' e me diga qual foi o input do último passo.

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

Comece aqui

Conecte o LangSmith uma vez e pronto.

Informe sua chave de API do LangSmith para começar. Suas credenciais ficam criptografadas e o guia completo está na página do Connector.

Conectar LangSmith à sua IA

FAQ

Como esta tarefa funciona.

  • 01

    A IA pode consertar meu código automaticamente?

    Não. A IA identifica o erro e sugere uma correção, mas você precisa atualizar seu código manualmente.

  • 02

    A IA pode deletar execuções do LangSmith?

    Não. Este MCP tem permissão apenas para ler e listar dados de execução.

  • 03

    Como a IA encontra a execução certa para depurar?

    Ela usa a ferramenta de listagem para varrer seu histórico e depois busca o rastro específico que você identificou.

  • 04

    A IA pode criar novos rastros no LangSmith?

    Não. A IA serve estritamente para inspecionar e analisar dados de execução já existentes.

  • 05

    A IA tem acesso a todo o meu projeto no LangSmith?

    A IA pode acessar qualquer execução que ela tenha permissão para listar e recuperar usando sua chave de API.

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

Conecte LangSmith ao Claude, Cursor, ChatGPT e outros