• TRACE
  • OBSERVATION
  • LOGIC
  • HUMAN

Cómo depurar cadenas de LLM fallidas con tu IA

Conecta Langfuse a tu agente para inspeccionar el paso exacto donde una cadena falló. Una vez conectado, tu IA puede recorrer las trazas de ejecución para encontrar la causa raíz.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo encuentro dónde falló mi cadena de LLM?

Tu agente utiliza la telemetría de Langfuse para extraer trazas específicas y observaciones anidadas. Analiza la ruta de ejecución para localizar el prompt, la entrada o la salida exacta que causó el error. Obtendrás una visión clara del punto de fallo en la jerarquía de la traza.

Resultados de la investigación

Dónde se clasifica cada problema.

La IA categoriza los resultados de su investigación en estas cuatro áreas.

TRACE

Rutas de ejecución completas

La IA identifica la traza específica que contiene el error. Obtienes el contexto general de toda la ejecución.

OBSERVATION

Datos detallados de pasos

El agente profundiza en spans y llamadas individuales. Esto muestra las entradas y salidas específicas de un solo paso.

LOGIC

Errores de prompt y modelo

La IA compara la salida esperada con lo que el modelo produjo realmente. Verás exactamente dónde falló el razonamiento.

HUMAN

Intervención manual

La IA señala casos complejos que requieren que ajustes manualmente tus prompts o la lógica en el panel de Langfuse.

El flujo

Lo que hace tu IA cuando ocurre un error.

El agente actúa como un depurador navegando por la jerarquía de datos de Langfuse.

  1. Localizar el error

    El agente escanea tu actividad reciente para encontrar los registros de ejecución relevantes.

    list_traces
  2. Aislar la traza

    El agente extrae todo el contexto de la ejecución fallida específica.

    get_trace
  3. Inspeccionar el span

    El agente analiza la llamada anidada específica donde ocurrió el error.

    get_observation
  4. Resumir el fallo

    El agente compara las entradas y salidas en la traza para explicar la interrupción.

    get_observation

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para iniciar tu sesión de depuración.

Puntos de partida

Sustituye los IDs de las trazas o las descripciones de errores por tus datos reales de Langfuse.

Langfuse Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_sTXOynCd5hRTA7WbjY0nBUsTjmjwRIVY989VA7VU/mcp

Claude Desktop

Sigue los pasos siguientes para conectarte en 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.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "langfuse-llm-tracing-evals-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_sTXOynCd5hRTA7WbjY0nBUsTjmjwRIVY989VA7VU/mcp"
    }
  }
}
Copia en el chat04
  • Busca la traza fallida más reciente en Langfuse y dime por qué se detuvo.

  • Analiza la traza con ID 12345 y encuentra la observación específica donde falló la llamada a la herramienta.

  • Revisa las observaciones anidadas del último flujo de trabajo de atención al cliente para ver dónde falló la lógica.

  • Lista todas las trazas de la última hora que resultaron en un error.

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

Empieza aquí

Conecta Langfuse una vez y luego pregunta.

Solo necesitas tus credenciales de la API de Langfuse. La conexión está cifrada y podrás pedirle a tu agente que investigue tus trazas de inmediato.

Conecta Langfuse a tu IA

FAQ

Cómo funciona esta tarea.

  • 01

    ¿Puede la IA arreglar mi código automáticamente?

    No. La IA puede identificar el error y explicar la causa, pero tú debes actualizar manualmente tu código o tus prompts.

  • 02

    ¿Puede la IA borrar trazas en Langfuse?

    No. Las herramientas solo permiten a la IA leer y recuperar datos. No puede modificar ni eliminar tu telemetría.

  • 03

    ¿La IA puede ver mis plantillas de prompts?

    Sí, siempre que esas plantillas formen parte de las observaciones de la traza recuperadas mediante las herramientas.

  • 04

    ¿Puedo preguntar sobre trazas de otras plataformas?

    No. La IA solo tiene acceso a los datos que puede extraer a través de Langfuse.

  • 05

    ¿Cambiará la IA mi configuración de Langfuse?

    No. La IA está limitada a la lectura de trazas y observaciones.

  • ¿Tienes más dudas sobre Langfuse? La página del Connector las responde. Ver todo lo que puede hacer el Connector de Langfuse

Conecta Langfuse a Claude, Cursor, ChatGPT y más