• RASTRO
  • ERRO
  • LÓGICA
  • HUMANO

Como depurar rastros de execução com sua IA

Conecte o LangSmith ao seu agente para extrair telemetria em tempo real. Você poderá entender exatamente por que uma chamada de ferramenta falhou ou onde o raciocínio se perdeu.

Pergunte à IA sobre esta página

Resposta rápida

Como posso depurar o raciocínio e as chamadas de ferramentas da minha IA?

Sua IA busca dados específicos no LangSmith para mostrar a sequência exata de eventos de um rastreio. Você verá as entradas, saídas e a lógica aninhada de cada etapa da execução.

Resultados da depuração

Onde sua telemetria é organizada.

A IA transforma os dados do LangSmith em caminhos de depuração claros.

RASTRO

Caminhos de execução completos

A IA extrai a sequência completa de eventos. Você visualiza cada chamada aninhada e ponto de decisão em ordem.

ERRO

Pontos de falha identificados

A IA isola as execuções que falharam, apontando exatamente qual chamada de ferramenta ou prompt causou o erro.

LÓGICA

Lacunas de raciocínio encontradas

A IA compara os resultados esperados com os rastros reais para mostrar onde a lógica do agente divergiu.

HUMANO

Revisão manual necessária

A IA sinaliza rastros complexos ou ambíguos. Você assume o controle para inspecionar os dados brutos quando a lógica é difícil de resumir.

O fluxo

O que sua IA faz quando os dados chegam.

A IA serve como uma ponte entre sua interface de chat e a telemetria do LangSmith.

  1. Localizar o projeto

    A IA encontra o projeto correto no LangSmith para iniciar a investigação.

    list_projects

  2. Encontrar a execução

    A IA varre o projeto para encontrar o rastreio exato que você procura.

    list_runs

  3. Extrair detalhes do rastreio

    A IA busca a telemetria completa, incluindo chamadas de ferramentas e passos de raciocínio.

    get_run

  4. Analisar o caminho

    A IA revisa os dados recuperados para explicar o comportamento do agente.

    get_run

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar sua sessão de depuração.

Pontos de partida

Substitua os nomes de projetos ou execuções pelos seus identificadores reais do LangSmith.

LangSmith Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_ixIJrwVWDWlC1bEOf4IyffAPgAEw302Ns6BE1oLo/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-llm-observability-hub-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ixIJrwVWDWlC1bEOf4IyffAPgAEw302Ns6BE1oLo/mcp"
    }
  }
}
Copie no chat04

  • Liste todos os meus projetos no LangSmith para que eu possa escolher um para depurar.

  • Encontre as execuções que falharam mais recentemente no meu projeto 'production-agent'.

  • Obtenha os detalhes do run ID 'abc-123' e explique por que a chamada de ferramenta falhou.

  • Analise as últimas cinco execuções no meu projeto 'test-suite' e me diga se o caminho de raciocínio é consistente.

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

Comece aqui

Conecte o LangSmith uma vez e comece a perguntar.

Basta vincular sua conta do LangSmith. Suas credenciais ficam criptografadas e você pode começar a fazer perguntas sobre seus rastros imediatamente.

Conectar LangSmith à sua IA

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode alterar as configurações do meu projeto no LangSmith?

    Não. A IA só pode ler a telemetria e as listas de projetos. Ela não pode modificar suas configurações ou excluir projetos.

  • 02

    A IA pode consertar o código que causou o erro?

    Não. A IA identifica onde o erro ocorreu no rastreio, mas você deve corrigir o código manualmente no seu ambiente de desenvolvimento.

  • 03

    A IA tem acesso a todos os meus dados?

    A IA só acessa os dados de execução específicos que você solicitar através das ferramentas fornecidas.

  • 04

    Posso perguntar sobre execuções de um projeto diferente?

    Sim, desde que você use a ferramenta para listar e identificar esse projeto primeiro.

  • 05

    A IA vai excluir rastros antigos para economizar espaço?

    Não. A IA não tem capacidade para excluir ou gerenciar o armazenamento dos seus dados no LangSmith.

  • 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