El aprovisionamiento lee tu material existente y lo convierte en configuración del motor. La decisión que más condiciona el resultado es qué incluyes en el array sources de la solicitud, porque el motor que recibes de vuelta solo será tan bueno como las fuentes que le indiques.
Cada entrada es de uno de dos tipos. Una fuente link es una URL que la plataforma obtiene y rastrea por ti; una fuente content es texto sin procesar o markdown que proporcionas directamente. Puedes combinar ambas en la misma solicitud, hasta un máximo de diez fuentes en total. En esta página se explican los dos tipos, qué hace la plataforma con cada uno y cómo elegir fuentes que generen una configuración útil en lugar de una vacía. El campo sources en sí forma parte de la solicitud de creación; consulta Crear un trabajo de aprovisionamiento para ver la carga útil completa y la respuesta 202.
Los dos tipos de fuente#
Cada fuente es un objeto con un type y un payload. El type determina cómo la plataforma interpreta el payload.
| Tipo | Carga útil | Cuándo usarlo |
|---|---|---|
link | Una URL para rastrear | Cuando el contexto ya está en la web: tu página de marca, documentación pública, una guía de estilo publicada o una página de glosario. |
content | Texto sin procesar o markdown | Cuando el contexto está en tu cabeza o en un documento privado: listas de terminología, reglas de tono, convenciones de nombres de producto o qué hacer y qué no hacer en traducción. |
{
"sources": [
{ "type": "link", "payload": "https://acme.com/brand-guidelines" },
{ "type": "link", "payload": "https://acme.com/docs/style-guide" },
{
"type": "content",
"payload": "Brand name 'Acme' is never translated. Use formal tone in German (Sie-form). Product names: AcmeFlow, AcmeSync, AcmeVault - always keep in English."
}
]
}Dos enlaces y un bloque de contenido en el mismo array. Los enlaces apuntan a páginas que ya contienen el contexto; el bloque de contenido aporta reglas que no están en ningún sitio público. Ambos alimentan el mismo paso de extracción.
Qué hace la plataforma con cada uno#
Los dos tipos difieren en un paso —poner el texto delante del agente de IA— y, a partir de ahí, convergen.
Una fuente link se obtiene y se convierte a markdown antes del análisis. La plataforma rastrea las fuentes de enlace en paralelo, así que diez URL no suponen diez viajes de ida y vuelta secuenciales: se leen al mismo tiempo y luego se entregan al agente como texto. Tú proporcionas una URL; la plataforma se encarga de obtenerla y de convertir el HTML a markdown para que el agente lea prosa, no el marcado de la página.
Una fuente content se salta ese paso. El texto que envías pasa directamente al agente de IA, exactamente tal como está escrito. No hay rastreo, no hay conversión, no hay nada entre tus palabras y el agente, por eso una fuente de contenido es la forma más precisa de formular una regla que ya conoces.
A partir de ahí, ambos tipos son la misma entrada: el agente lo lee todo y extrae voces de marca, términos de glosario e instrucciones. Lo que produce a partir de ese texto, y el resumen que devuelve, es un tema aparte; consulta Qué extrae la IA.
¿Hasta dónde llega el rastreo de un enlace?
Una fuente link se obtiene y se convierte a markdown antes de que el agente la analice. Aquí no se especifica si el rastreador sigue enlaces más allá de la URL que proporcionas, ni hasta qué profundidad lo hace. Si necesitas que se analice un conjunto concreto de páginas, la opción más fiable es enumerar cada una como su propia fuente link en lugar de confiar en que una sola URL se expanda por sí sola.
Elige fuentes que aporten valor#
Este es el movimiento que decide si merece la pena ejecutar el aprovisionamiento. La extracción solo es tan buena como su entrada, y aquí el fallo es silencioso: un trabajo con fuentes flojas sigue completándose, sigue creando un motor, pero casi vacío, y te das cuenta más tarde, cuando las traducciones ignoran convenciones que dabas por hechas. La finalización llega como cualquier otra —consulta Entrega de webhooks—, así que nada te avisa de esa carencia.
Proporciona fuentes con contenido útil
La calidad de la configuración extraída depende de la calidad de lo que le des como entrada. Las fuentes de enlace deben apuntar a páginas con contexto útil: directrices de marca, guías de estilo, documentación del producto o glosarios. Las fuentes de contenido sin procesar deben incluir terminología concreta, pautas de tono o reglas de traducción. Las páginas de marketing genéricas o las pantallas de inicio de sesión aportan muy poca configuración útil.
La idea detrás del aviso es esta: el agente extrae lo que se dice, no lo que se insinúa. Una página que dice "escribimos en un alemán amable y directo en el que usamos Sie, nunca Du" genera una voz de marca. Una página de glosario que enumera "workspace → Arbeitsbereich" genera un término de glosario. Una landing page cuidada que demuestra un buen tono sin mencionar ni una sola regla no genera casi nada, porque no hay ninguna regla que extraer. En caso de duda, prioriza la fuente que exprese la regla de forma explícita, que a menudo será un bloque content escrito por ti en una frase, en lugar de una página de la que esperas que el agente la deduzca.
Una fuente floja no hunde el trabajo#
Al usar varias fuentes a la vez, surge una duda lógica: si una URL está caída o un bloque tiene poco contenido, ¿falla toda la solicitud? No. Las fuentes se leen de forma independiente, y un fallo por elemento se registra en lugar de ser fatal: un enlace roto o un bloque ilegible se omite, y el agente trabaja con lo que sí ha podido leer. El trabajo en su conjunto solo falla cuando no se ha podido leer ninguna fuente, y entonces no queda nada que analizar. Las formas exactas de esos resultados —los fallos por elemento registrados en caso de éxito y la carga útil de error cuando no se pudo leer nada— se explican en Qué extrae la IA y Entrega de webhooks.
Así que puedes incluir un conjunto de candidatas sin auditar antes cada URL: las fuentes sólidas aportan, las débiles se quedan fuera, y tú lees el resumen de salida para ver qué acabó entrando realmente. Apúntalo a lo que ya tienes y luego comprueba qué te devolvió.
