• TRACE
  • OBSERVATION
  • LOGIC
  • HUMAN

Como depurar falhas em cadeias de LLM com seu AI

Conecte o Langfuse ao seu agente para inspecionar o passo exato onde uma cadeia falhou. Após a conexão, sua IA pode percorrer os rastros de execução para encontrar a causa raiz.

Pergunte à IA sobre esta página

Resposta rápida

Como encontro onde minha cadeia de LLM falhou?

Seu agente usa a telemetria do Langfuse para extrair rastros específicos e observações aninhadas. Ele analisa o caminho de execução para identificar o prompt, a entrada ou a saída exata que causou o erro. Você terá uma visão clara do ponto de falha na hierarquia do rastro.

Resultados da investigação

Onde cada problema é localizado.

A IA categoriza os resultados de sua investigação nestas quatro áreas.

TRACE

Caminhos de execução completos

A IA identifica o rastro específico que contém o erro, fornecendo o contexto geral de toda a execução.

OBSERVATION

Dados granulares de etapas

O agente detalha spans e chamadas individuais, mostrando as entradas e saídas específicas de um único passo.

LOGIC

Erros de prompt e modelo

A IA compara a saída esperada com o que o modelo realmente produziu para mostrar onde o raciocínio divergiu.

HUMAN

Intervenção manual

A IA sinaliza casos complexos que exigem que você ajuste manualmente seus prompts ou lógica no painel do Langfuse.

O fluxo

O que sua IA faz quando ocorre um erro.

O agente atua como um depurador ao navegar pela hierarquia de dados do Langfuse.

  1. Localizar o erro

    O agente varre sua atividade recente para encontrar os logs de execução relevantes.

    list_traces

  2. Isolar o rastro

    O agente extrai o contexto completo da execução específica que falhou.

    get_trace

  3. Inspecionar o span

    O agente analisa a chamada aninhada específica onde o erro aconteceu.

    get_observation

  4. Resumir a falha

    O agente compara as entradas e saídas ao longo do rastro para explicar o problema.

    get_observation

Teste

Copie estes comandos para começar.

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

Pontos de partida

Substitua os IDs de rastro ou as descrições de erro pelos seus dados reais do Langfuse.

Langfuse Connector

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

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

  • Encontre o rastro de falha mais recente no Langfuse e me diga por que ele parou.

  • Analise o rastro ID 12345 e encontre a observação específica onde a chamada da ferramenta falhou.

  • Verifique as observações aninhadas do último fluxo de suporte ao cliente para ver onde a lógica quebrou.

  • Liste todos os rastros da última hora que resultaram em erro.

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

Comece aqui

Conecte o Langfuse uma vez e comece a perguntar.

Basta fornecer suas credenciais de API do Langfuse. A conexão é criptografada e você pode pedir imediatamente para seu agente investigar seus rastros.

Conectar Langfuse ao seu AI

FAQ

Como esta tarefa funciona.

  • 01

    A IA pode consertar meu código automaticamente?

    Não. A IA identifica o erro e explica a causa, mas você deve atualizar seu código ou prompts manualmente.

  • 02

    A IA pode deletar rastros no Langfuse?

    Não. As ferramentas permitem apenas que a IA leia e recupere dados. Ela não pode modificar ou excluir sua telemetria.

  • 03

    A IA consegue ver meus templates de prompt?

    Sim, se esses templates fizerem parte das observações de rastro recuperadas pelas ferramentas.

  • 04

    Posso perguntar sobre rastros de outras plataformas?

    Não. A IA só tem acesso aos dados que consegue extrair via Langfuse.

  • 05

    A IA vai alterar minhas configurações do Langfuse?

    Não. A IA está limitada à leitura de rastros e observações.

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

Conecte Langfuse ao Claude, Cursor, ChatGPT e outros