● Comunidad
OthmanAdi
⚡ Instantáneo
langsmith-fetch-skill
por OthmanAdi · OthmanAdi/langsmith-fetch-skill
Depura agentes de LangChain / LangGraph desde tu terminal — obtiene trazas de LangSmith Studio en Claude Code y analiza fallos, latencia y llamadas a herramientas.
Una Skill de observabilidad enfocada. Cuando le pides a Claude que depure un agente, ejecuta langsmith-fetch contra LangSmith Studio, obtiene datos de trazas, analiza patrones de ejecución e identifica fallos, causas raíz, puntos críticos de latencia y problemas en llamadas a herramientas. Exporta sesiones para revisión posterior.
Por qué usarlo
Características clave
- Obtiene trazas directamente de LangSmith Studio a través de CLI
- Se activa automáticamente con prompts orientados a depuración
- Rastrea fallos y causas raíz
- Análisis de latencia y uso de tokens
- Revisión de llamadas a herramientas y operaciones de memoria
- Exportación de sesiones
Demo en vivo
Cómo se ve en la práctica
langsmith-fetch-skill.replay
▶ listo
Casos de uso
Usos del mundo real: langsmith-fetch-skill
Cuándo usarlo: Un agente que solía ser rápido ahora es lento; quieres conocer la causa raíz.
Flujo
-
Pide a Claude que diagnostique
¿Por qué mi agente <name> es lento? Obtén las últimas 20 trazas de LangSmith e identifica el punto crítico.✓ Copiado
→ La Skill obtiene trazas; reporta latencia por paso
-
Profundiza
Enfócate en la traza <id> — desglose los tiempos de llamadas a herramientas.✓ Copiado
→ Latencia por herramienta con el valor atípico resaltado
Resultado: Un paso específico para optimizar, no una suposición.
Errores comunes
- Optimizar el promedio cuando la latencia de cola es el problema — Solicita específicamente p95/p99
Cuándo usarlo: Un usuario reportó un error; tienes el ID de la traza.
Flujo
-
Obtén + analiza
Depura la traza <id>. ¿Cuál fue el error inmediato, cuál es la causa raíz en el grafo?✓ Copiado
→ Paso del error + decisión anterior que la provocó
Resultado: Una corrección dirigida al punto de decisión real, no al síntoma.
Cuándo usarlo: Revisión mensual del gasto en agentes.
Flujo
-
Agrega el uso de tokens
Across trazas de los últimos 7 días, clasifica nodos del grafo por uso total de tokens.✓ Copiado
→ Tabla clasificada con % de participación
-
Propone optimización
Para los 3 principales, propón opciones de compresión de prompts o degradación de modelo.✓ Copiado
→ Lista de optimización dirigida
Resultado: Reducción medible de gasto sin perseguir ahorros insignificantes.
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
Guarda exportaciones junto al código del agente para rastreabilidad
Exporta la sesión de depuración a debugging/traces/<date>.json.✓ Copiado
langsmith-fetch-skill +
githubAdjunta resumen de traza a un reporte de bug
Resume la traza <id> y publícala como comentario en el issue #42 de GitHub.✓ Copiado
Coste y límites
Lo que cuesta ejecutarlo
- Cuota de API
- LangSmith: depende del plan; Studio tiene cuotas generosas
- Tokens por llamada
- Bajo — las trazas están estructuradas
- Monetario
- Skill gratuita; el nivel gratuito de LangSmith cubre la mayoría de desarrolladores
- Consejo
- Usa fetch_recent con una ventana estrecha, no el historial completo
Seguridad
Permisos, secretos, alcance
Ámbitos mínimos: LangSmith: lectura en tus proyecto(s)
Almacenamiento de credenciales: LANGCHAIN_API_KEY en env
Salida de datos: Solo a LangSmith (donde las trazas ya residen)
No conceder nunca: Escribir en LangSmith — la Skill solo lee
- Las trazas pueden incluir entradas y salidas de usuarios — trátalas como datos de usuario bajo tu política de privacidad.
Resolución de problemas
Errores comunes y soluciones
langsmith-fetch: command not found
Instala LangSmith CLI o asegúrate de que esté en PATH
Verificar: which langsmith-fetch
Resultados vacíos
Verifica el nombre del proyecto y la ventana de tiempo; las trazas están limitadas al proyecto
Alternativas
langsmith-fetch-skill vs otros
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| LangSmith web UI | Prefieres hacer clic | Sin análisis de Claude |