• TRACE
  • ERROR
  • INPUT
  • HUMAN

Cómo depurar ejecuciones fallidas con tu IA y LangSmith

Conecta LangSmith a tu agente para inspeccionar las trazas de ejecución. Una vez conectado, tu IA podrá extraer datos específicos para localizar dónde falló tu lógica.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puedo usar mi IA para saber por qué falló un agente?

Tu IA utiliza LangSmith para obtener trazas de error y detalles de ejecución específicos. Identifica el paso exacto donde falló el flujo de trabajo y te ofrece el contexto necesario para solucionarlo.

Resultados de la depuración.

Hacia dónde guía tu investigación.

La IA clasifica los datos encontrados en resultados claros.

TRACE

Rutas de ejecución completas

La IA extrae la secuencia de eventos de una ejecución. Verás exactamente qué herramientas se llamaron y qué devolvieron.

ERROR

Identificación de la causa raíz

La IA aísla el mensaje de error específico. Obtendrás la razón exacta por la que se detuvo la ejecución.

INPUT

Validación de datos

La IA revisa los datos enviados en cada paso. Localiza dónde un dato mal formado causó el fallo.

HUMAN

Correcciones manuales necesarias

La IA señala las ejecuciones que requieren que cambies tus prompts o la lógica de tus herramientas. Estos ajustes dependen de ti.

El flujo

Qué hace tu IA cuando una ejecución falla.

La IA actúa como una herramienta forense para tus datos de LangSmith.

  1. Localizar el fallo

    La IA escanea tu historial reciente para encontrar la ejecución fallida específica que estás consultando.

    langsmith_list_runs

  2. Recuperar la traza

    La IA extrae los detalles granulares y los metadatos de esa ejecución fallida en particular.

    langsmith_get_run

  3. Analizar el error

    La IA compara el resultado esperado con el error real devuelto por el sistema.

    langsmith_get_run

  4. Resumir la solución

    La IA explica por qué falló la ejecución y sugiere cómo ajustar la lógica de tu agente.

    langsmith_get_run

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para iniciar tu investigación.

Puntos de partida

Sustituye el texto entre corchetes por tus IDs de ejecución o descripciones de error reales.

LangSmith Connector

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

Enlace del conectorhttps://edge.vinkius.com/vk_preview_JBueIzhraYvzf2S9aR0UP9Q6bjldfIBgmwxTvRHt/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 — LangSmith capabilities are ready to use.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "langsmith-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_JBueIzhraYvzf2S9aR0UP9Q6bjldfIBgmwxTvRHt/mcp"
    }
  }
}
Copia en el chat04

  • Busca la última ejecución fallida en LangSmith y dime por qué falló.

  • Obtén los detalles de la ejecución con ID 'run_123abc' y explica el error en la llamada a la herramienta.

  • Lista todas las ejecuciones fallidas de la última hora para que pueda ver el patrón.

  • Analiza la traza de la ejecución 'run_456def' y dime cuál fue el input del último paso.

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

Empieza aquí

Conecta LangSmith una vez y luego pregunta.

Introduce tu clave de API de LangSmith para comenzar. Tus credenciales se mantienen cifradas y puedes encontrar la guía completa en la página del Connector.

Conectar LangSmith a tu IA

FAQ

Cómo funciona esta tarea.

  • 01

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

    No. La IA identifica el error y sugiere una solución, pero tú debes actualizar el código manualmente.

  • 02

    ¿Puede la IA borrar ejecuciones de LangSmith?

    No. Este MCP solo tiene permisos para leer y listar datos de ejecución.

  • 03

    ¿Cómo encuentra la IA la ejecución correcta para depurar?

    Utiliza la herramienta de listado para escanear tu historial y luego extrae la traza específica que hayas identificado.

  • 04

    ¿Puede la IA crear nuevas trazas en LangSmith?

    No. La IA es estrictamente para inspeccionar y analizar datos de ejecución existentes.

  • 05

    ¿La IA tiene acceso a todo mi proyecto de LangSmith?

    La IA puede acceder a cualquier ejecución para la que tenga permiso de listar y recuperar según tu clave de API.

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

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