langsmith-data-migration-tool
CLI en Python para migrar usuarios, datasets, experimentos, flotas y trazas entre instancias de LangSmith (self-hosted o SaaS). Requiere uv para instalación y soporta sincronización CSV de acceso.
Ficha actualizada 24 sept 2026, 19:44 · upstream 24 sept 2026, 19:15 · release v0.0.85
Qué es langsmith-data-migration-tool
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Esta herramienta es una línea de comandos diseñada para facilitar la migración de recursos entre diferentes instancias de LangSmith, incluyendo despliegues self-hosted y gestionados por LangChain. Permite transferir usuarios con roles personalizados, datasets con ejemplos y archivos adjuntos, experimentos con feedback, colas de anotación, reglas de proyecto, prompts, gráficos de monitorización, precios de modelos personalizados, problemas del motor y recursos de flota como agentes MCP.
La CLI incluye un asistente interactivo para seleccionar recursos y modos no interactivos para automatización. Soporta migración de trazas de larga duración preservando IDs de ejecución y timestamps, aunque con limitaciones en destinos SaaS respecto a ventanas temporales históricas. Incluye mecanismos de recuperación de estado mediante archivos en .langsmith-migrator/ y exportación a archivo.
La herramienta gestiona mapeo de proyectos, verificación de contenido por muestra y restauración de niveles de retención (long-lived). Requiere configuración previa de variables de entorno para claves API y ventanas temporales si se migran datos históricos.
- Migrar datasets completos con ejemplos y archivos adjuntos entre instancias
- Sincronizar acceso de usuarios mediante CSV en un solo despliegue LangSmith
- Transferir recursos de flota incluyendo agentes MCP, skills compartidos y webhooks
- Migrar trazas de larga duración preservando IDs de ejecución y timestamps
- Soporta migración de datasets con experimentos y feedback mediante flag --include-experiments
- Exporta miembros de organización a CSV para importar en destino con roles ABAC
- Preserva run IDs, trace IDs y dotted_order en migración de trazas históricas
- Incluye verificación por muestra (--verify-content-sample) antes de confirmar completitud
- Migración de trazas requiere destino self-hosted o BYOC con ventana temporal configurable
- No permite re-ingestionar en el mismo workspace (duplica/reescribe datos existentes)
- Trazas cortas no son soportadas por el comando traces
- Los IDs de ejecución no se ajustan automáticamente a nuevos timestamps del destino
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configurar LANGSMITH_OLD_API_KEY y LANGSMITH_NEW_API_KEY antes de ejecutar. Para migración de trazas históricas, verificar V1_INGEST_ENFORCE_TIME_WINDOW_EXCLUDED_ORGS en destinos self-hosted (default: ['*']). Ejecutar langsmith-migrator test para validar conexiones. Ordenar operaciones: model-pricing antes que traces. Usar --since/--until absolutos con ventana de 24h por defecto.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.