Estás poniendo en marcha un motor de localización. El motor que traduce bien no es el que está vacío, sino el que trae tu voz de marca, tu glosario y tus instrucciones, para que cada traducción suene como tu producto y nunca estropee un término que ya decidiste cómo manejar.
Ese conocimiento normalmente existe antes que el motor. Está en una página de guías de marca, una guía de estilo, una hoja de terminología, o en unos cuantos párrafos de reglas que alguna vez se le compartieron a un traductor. Crear el motor a mano implica leer todo eso y volver a cargarlo como registros de voz de marca, glosario e instrucciones, uno por uno: un trabajo tedioso que es fácil empezar y fácil dejar a medias.
La API de aprovisionamiento asíncrono cierra esa brecha: apúntala a lo que ya tienes. Envías por POST enlaces y texto sin procesar en una sola solicitud, recibes de inmediato un ID de motor, y un agente de IA rastrea las fuentes, extrae voces de marca, términos del glosario e instrucciones, y aplica cada uno al nuevo motor a medida que los encuentra. El motor se puede usar desde el momento en que recibes el ID: la configuración se va completando mientras avanza el trabajo.
En esta página
El problema#
Un motor de localización es tan bueno como su configuración. La selección del modelo te da una traducción; las voces de marca, los términos del glosario y las instrucciones son lo que hace que esa traducción refleje la forma en que tu producto ya se comunica: el nivel de formalidad que elegiste, los nombres de producto que nunca traduces, el formato de fecha que siempre usas. Esos son los mismos componentes base que, de otro modo, crearías a mano: voces de marca, términos del glosario e instrucciones en un motor.
El problema es que todo eso ya existe en algún lado. Un equipo que ya lanzó un producto en un idioma tiene una página de guías de marca, una guía de estilo, un glosario de términos que a los agentes de soporte se les indica no traducir nunca. Para configurar el motor a mano, lees esos documentos y los transcribes en registros, decisión por decisión, idioma por idioma. Es lento, y la parte más lenta es la menos interesante: copiar conocimiento que ya está escrito a otro formato.
El aprovisionamiento elimina ese paso. Le entregas a la plataforma los documentos tal cual, ya sea como URL para rastrear o como texto sin procesar, y un agente de IA se encarga de leerlos y transcribirlos. Crea por ti los registros de voz de marca, glosario e instrucciones en un motor real, aplicando cada uno a medida que lo identifica. Después los revisas y ajustas en el panel, igual que editarías cualquier cosa que hubieras creado tú mismo. El punto de partida es un motor configurado, no uno en blanco.
El aprovisionamiento configura un motor; no traduce.
Esta API crea y configura el motor. Para traducir con el motor una vez que exista, usa la API de Localization asíncrona para muchos idiomas a la vez, o el endpoint sincrónico Localize para un solo par de idiomas. El aprovisionamiento es el paso de configuración que hace que esas llamadas lleven tu voz de marca y tu glosario desde la primera traducción.
Cómo funciona#
Son tres pasos, y solo el primero ocurre dentro de tu solicitud. Los otros dos se ejecutan en la plataforma, a su propio ritmo, por eso la llamada regresa de inmediato y el motor se puede usar antes de que el trabajo termine.
Envía tus fuentes
Envía por POST un nombre para el nuevo motor y un arreglo de fuentes —URL para rastrear, texto sin procesar para analizar, o ambos— a /jobs/provisioning. La API crea el motor de inmediato y devuelve 202 con el ID del motor (eng_) y el ID del trabajo (pjb_). Tu aplicación puede seguir; nada de la respuesta espera a la extracción. Consulta Crear un trabajo de aprovisionamiento para ver la estructura completa de la solicitud y la respuesta, y Tipos de fuentes para saber qué hace que una fuente valga la pena enviar.
El agente de IA rastrea y extrae
Las fuentes de enlace se rastrean en paralelo y se convierten en texto; el contenido sin procesar se lee directamente. Luego, un agente de IA analiza todo y extrae tres tipos de configuración —voces de marca, términos del glosario e instrucciones—, aplicando cada uno al motor a medida que lo identifica. Una fuente que no se puede rastrear, o un solo elemento que no se puede crear, no detiene lo demás. Lo que extrae la IA cubre los tres componentes y cómo se asignan a los idiomas.
El motor está listo
Cuando termina la extracción, el motor queda completamente configurado y listo para traducir mediante la API de Localization. La plataforma informa la finalización —con un resumen de todo lo que se creó— a tu URL de webhook, o en vivo a través del WebSocket del trabajo si quieres mostrar el progreso mientras se ejecuta.
El ID del motor se puede usar de inmediato.
El ID de eng_ en 202 corresponde a un motor real desde el instante en que lo recibes. Puedes guardarlo, consultarlo y traducir con él de inmediato; la configuración se aplica mientras se ejecuta el trabajo, así que una traducción hecha al principio verá menos registros extraídos que una hecha después de que el trabajo termine. No tienes que esperar a que termine el aprovisionamiento para empezar a usar el motor.
Autenticación
Cada solicitud —REST y WebSocket— se autentica con tu encabezado X-API-Key. Las claves tienen alcance a nivel de organización y funcionan con todos los motores de la organización. Consulta Authentication para ver los detalles, y API Keys para crear una.
Qué recibes de vuelta#
Un lector escéptico ya se está haciendo las dos preguntas que determinan si es seguro depender de esto: ¿qué pasa si una fuente es mala?, ¿y esto es una caja negra que no puedo corregir?
Ninguna de las dos respuestas está oculta. El aprovisionamiento no devuelve un blob propietario: crea registros normales de voz de marca, glosario e instrucciones en un motor real, exactamente los mismos objetos que crearías a mano, y todos se pueden editar después en el panel. Cuando termina el trabajo, te devuelve un resumen que enumera cada registro que creó y cada error que encontró, para que puedas confirmar la configuración en lugar de asumirla. Lo que extrae la IA explica ese resumen y cómo un elemento fallido se aísla en una lista de errors mientras el resto del motor sigue configurándose.
Las fuentes también son opcionales. Envía un nombre sin sources y obtendrás un motor limpio con la configuración predeterminada para configurarlo tú mismo. Crear un trabajo de aprovisionamiento cubre ese flujo junto con la estructura de la respuesta 202. El aprovisionamiento es la forma de saltarte la configuración manual, no un requisito previo para tener un motor.
Las páginas genéricas producen configuraciones genéricas.
La configuración solo será tan buena como lo que envíes: las guías de marca y las listas de terminología le dan al agente algo concreto que extraer; una página principal de marketing casi no produce nada. Tipos de fuentes explica a qué apuntarlo.
Ese es el intercambio que ofrece el aprovisionamiento: inviertes una solicitud y una espera breve, y a cambio te ahorras transcribir conocimiento que ya habías dejado por escrito. Apúntalo a lo que ya tienes y empieza con un motor configurado. Las páginas de abajo desglosan esa idea.
