Herramienta de Traducción con IA y Human-in-the-Loop: 23 Agent Tools para Calidad de Traducción

Agente de Traducción con IA en Better i18n

Better i18n va más allá de la simple traducción con IA. El dashboard incluye un agente de IA conversacional completo — impulsado por Google Gemini — que comprende el contexto de tu proyecto y ejecuta tareas de traducción mediante lenguaje natural. Pídele que traduzca un namespace, revise inconsistencias o añada un nuevo idioma, y gestiona el flujo de trabajo de principio a fin con tu aprobación en cada paso.

Esto no es un enfoque de "generar y esperar lo mejor". El agente opera con 23 herramientas especializadas, aprobación Human-in-the-Loop para cada operación de escritura, y una caché de contexto de proyecto de 30 segundos que lo mantiene anclado en tus datos reales.

La Arquitectura del Agente de IA

El sistema de chat con IA está construido como un agente que usa herramientas, no como una interfaz simple de pregunta y respuesta. Cuando escribes una solicitud, el agente:

1. Lee el contexto de tu proyecto — idiomas, claves, traducciones, estado de Sync, modelos de contenido
2. Planifica la operación — determina qué herramientas llamar y en qué orden
3. Ejecuta con aprobación — las operaciones de lectura ocurren automáticamente; las operaciones de escritura requieren tu confirmación explícita
4. Renderiza resultados progresivamente — las tablas de traducción se renderizan en tiempo real a medida que llegan los resultados

El agente admite hasta 50 pasos por conversación, con context stripping (slimToolResults) que evita el desbordamiento de tokens en operaciones de gran escala.

23 Herramientas Especializadas

El agente tiene acceso a 23 herramientas de propósito específico, divididas en herramientas de lectura y herramientas de escritura.

Herramientas de Lectura (Ejecución Automática)

Estas herramientas se ejecutan sin requerir aprobación, dándole al agente visibilidad completa de tu proyecto:

• getTranslations — obtiene traducciones para claves, namespaces o idiomas específicos
• getKeyDetails — inspecciona metadatos de claves individuales, notas de contexto y estado de traducción
• getLanguages — lista todos los idiomas configurados y sus porcentajes de completitud
• getProjectStats — cobertura de traducción del proyecto, conteo de claves y estadísticas por idioma
• getDoctorReport — informe de diagnóstico que identifica traducciones faltantes, claves no utilizadas e inconsistencias
• getSyncs — lista todas las integraciones de Sync configuradas (GitHub, GitLab, etc.)
• getSyncDetails — inspecciona la configuración de un Sync específico y su actividad reciente
• getContentModels — lista los modelos de contenido y sus estructuras de campos
• getContentEntries — navega por las entradas de contenido en todos los modelos
• createPlan — genera un plan de ejecución para operaciones complejas de múltiples pasos

Herramientas de Escritura (Aprobación Human-in-the-Loop)

Cada herramienta de escritura requiere tu aprobación explícita antes de ejecutarse. El agente propone cambios, tú los revisas y solo entonces toman efecto:

• proposeTranslations — genera nuevas traducciones para pares de idiomas faltantes
• proposeTranslationEdits — sugiere mejoras a traducciones existentes
• translateBatch — traduce claves en bulk a través de múltiples idiomas en una sola operación
• proposeKeys — sugiere nuevas claves de traducción basándose en los patrones de tu codebase
• proposeDeleteKeys — identifica y propone la eliminación de claves sin uso o duplicadas
• proposeLanguages — sugiere nuevos idiomas a añadir según la demografía de tus usuarios
• proposeLanguageEdits — modifica la configuración de idiomas (nombres de visualización, fallbacks)
• publishChanges — envía las traducciones aprobadas al CDN en producción
• proposeContentEntries — crea o actualiza entradas de contenido en el CMS
• proposeContentModel — sugiere cambios en el schema del modelo de contenido
• proposePublishEntries — pone en cola entradas de contenido para Publish

Human-in-the-Loop: El Diferenciador Clave

La mayoría de las herramientas de traducción con IA operan bajo un modelo de "generar y enviar". Better i18n adopta un enfoque fundamentalmente diferente con aprobación Human-in-the-Loop (HITL).

Cómo funciona HITL en la práctica:

1. Le preguntas al agente: "Traduce todas las claves faltantes en el namespace de configuración al alemán y francés"
2. El agente lee tu proyecto, identifica 47 traducciones faltantes y las genera
3. Aparece una propuesta estructurada en el chat — mostrando cada string fuente, la traducción de la IA y cualquier término de glosario aplicado
4. Revisas la propuesta: aprueba todo, aprueba selectivamente o solicita cambios
5. Solo las traducciones aprobadas se escriben en tu proyecto

Este flujo de trabajo garantiza que la calidad de la traducción con IA cumpla tus estándares antes de llegar a producción. El agente nunca escribe datos sin tu consentimiento.

Por qué esto importa:

• Sin errores silenciosos — cada traducción generada por IA se revisa antes de publicarse
• Cumplimiento del glosario — la IA respeta tus definiciones de terminología, y tú verificas que lo haya hecho
• Registro de auditoría — cada aprobación queda registrada con quién la aprobó y cuándo
• Reversibilidad — como apruebas cada cambio, no hay un batch de calidad desconocida en producción

Renderizado Progresivo

Cuando el agente genera traducciones, los resultados se transmiten a la interfaz de chat en tiempo real. La tabla de traducción se renderiza progresivamente — ves cómo se completa cada columna de idioma a medida que la IA produce resultados, en lugar de esperar a que todo el batch termine.

Esto es especialmente valioso para operaciones de gran escala. Al traducir 200 claves en 8 idiomas, puedes empezar a revisar los primeros resultados mientras el agente todavía está generando el resto.

Historial de Chat y Persistencia

El agente mantiene el historial de conversación mediante un sistema de almacenamiento dual:

• IndexedDB (local) — proporciona acceso instantáneo a conversaciones recientes con latencia cero
• Postgres (servidor) — mantiene un registro de auditoría persistente de todas las interacciones con el agente

Esto significa que tus conversaciones se cargan instantáneamente cuando vuelves al dashboard, y también están disponibles para auditorías de equipo y cumplimiento normativo.

Ejemplos Prácticos

Añadir un Nuevo Idioma

Tú: "Añade japonés al proyecto y traduce todas las claves existentes"

El agente llama a getLanguages para verificar la configuración actual, proposeLanguages para añadir japonés, y luego translateBatch para generar traducciones de todas las claves existentes. Cada paso te muestra qué está ocurriendo, y las operaciones de escritura esperan tu aprobación.

Encontrar Problemas de Traducción

Tú: "¿Hay alguna inconsistencia en las traducciones al francés?"

El agente llama a getDoctorReport y getTranslations, luego analiza los resultados en busca de inconsistencias terminológicas, formas plurales faltantes o claves sin traducir. Presenta un resumen con las claves específicas que necesitan atención.

Revisión de Traducción en Bulk

Tú: "Muéstrame todas las claves sin traducir en el namespace de checkout para español"

El agente llama a getTranslations con los filtros apropiados y presenta una tabla de traducciones faltantes. Luego puedes pedirle que genere traducciones para todas ellas, revisar las propuestas y aprobar en bulk.

Gestión del Modelo y el Contexto

El agente utiliza Google Gemini como modelo base, seleccionado por sus sólidas capacidades multilingües y su tamaño de ventana de contexto. Detalles técnicos clave:

• 50 pasos por conversación — suficiente para operaciones complejas de múltiples pasos
• Context stripping — el sistema slimToolResults reduce automáticamente el uso de tokens recortando las respuestas API de gran tamaño a los datos esenciales
• Caché de proyecto de 30 segundos — el contexto del proyecto se almacena en caché durante 30 segundos, evitando llamadas API redundantes durante operaciones de múltiples pasos

Primeros Pasos con el Agente de IA

1. Abre el dashboard de Better i18n y haz clic en el icono de chat de IA
2. Empieza con una operación de lectura: "Muéstrame el estado de traducción de este proyecto"
3. Prueba una tarea de traducción: "Traduce todas las claves faltantes en el namespace común al español"
4. Revisa las propuestas del agente y aprueba o edita según necesites
5. Usa "Publish changes" cuando estés listo para enviar las traducciones al entorno de producción

El agente de IA está disponible en todos los planes. Crea tu cuenta para probarlo con tu proyecto.