Le provisioning s’appuie sur vos contenus existants pour les transformer en configuration de moteur. Le choix qui influence le plus le résultat, c’est ce que vous mettez dans le tableau sources de la requête, car la qualité du moteur obtenu dépend directement de ce vers quoi vous le dirigez.
Chaque entrée relève de l’un des deux types. Une source link est une URL que la plateforme récupère et explore pour vous ; une source content est du texte brut ou du markdown que vous fournissez directement. Vous pouvez combiner les deux dans une même requête, avec un maximum de dix sources au total. Cette page présente les deux types, ce que la plateforme fait avec chacun, et comment choisir des sources qui produisent une configuration utile plutôt qu’une configuration vide. Le champ sources se trouve dans la requête de création — voir Créer une tâche de provisioning pour la charge utile complète et la réponse 202.
Les deux types de sources#
Chaque source est un objet avec un type et un payload. Le type détermine la manière dont la plateforme lit le payload.
| Type | Charge utile | À privilégier quand |
|---|---|---|
link | Une URL à explorer | Le contexte existe déjà sur le web — votre page de marque, votre documentation publique, un guide de style publié, une page de glossaire. |
content | Texte brut ou markdown | Le contexte se trouve dans votre tête ou dans un document privé — listes de terminologie, règles de ton, conventions de nommage produit, bonnes pratiques et erreurs à éviter en traduction. |
{
"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."
}
]
}Deux liens et un bloc de contenu dans le même tableau. Les liens pointent vers des pages qui contiennent déjà le contexte ; le bloc de contenu apporte des règles qui n’existent nulle part publiquement. Les deux alimentent la même étape d’extraction.
Ce que la plateforme fait avec chaque type#
Les deux types ne diffèrent qu’à une étape — mettre le texte à disposition de l’agent IA — puis suivent ensuite le même parcours.
Une source link est d’abord récupérée, puis convertie en markdown avant l’analyse. La plateforme explore les sources de type lien en parallèle : dix URL ne donnent donc pas lieu à dix allers-retours séquentiels, mais à dix lectures concurrentes, ensuite transmises à l’agent sous forme de texte. Vous fournissez l’URL ; la plateforme se charge de la récupération et de la conversion du HTML en markdown pour que l’agent lise du contenu rédigé, et non le balisage de la page.
Une source content saute cette étape. Le texte que vous envoyez est transmis directement à l’agent IA, exactement tel qu’il a été écrit. Il n’y a ni exploration, ni conversion, ni intermédiaire entre vos mots et l’agent — c’est pourquoi une source de contenu reste la façon la plus précise d’énoncer une règle que vous connaissez déjà.
À partir de là, les deux types deviennent la même entrée : l’agent lit l’ensemble et en extrait des voix de marque, des éléments de glossaire et des instructions. Ce qu’il produit à partir de ce texte, ainsi que le résumé qu’il renvoie, est un sujet à part entière — voir Ce que l’IA extrait.
Jusqu’où l’exploration d’un lien va-t-elle ?
Une source link est récupérée puis convertie en markdown avant d’être analysée par l’agent. La question de savoir si le crawler suit les liens au-delà de l’URL fournie — et jusqu’à quelle profondeur — n’est pas précisée ici. Si vous avez besoin qu’un ensemble précis de pages soit analysé, l’approche la plus fiable consiste à lister chacune d’elles comme sa propre source link, plutôt que de compter sur une seule URL pour étendre l’exploration.
Choisissez des sources riches en signal#
C’est ce qui détermine si le provisioning vaut vraiment la peine d’être lancé. La qualité de l’extraction dépend de la qualité de l’entrée, et l’échec ici est silencieux : une tâche lancée sur des sources faibles se termine quand même, crée quand même un moteur — mais un moteur presque vide, et vous ne vous en rendez compte que plus tard, lorsque les traductions passent à côté de conventions que vous pensiez avoir capturées. La fin du traitement arrive comme n’importe quelle autre — voir Livraison des webhooks — donc rien ne vous alerte sur ce manque.
Fournissez des sources utiles
La qualité de la configuration extraite dépend de la qualité de vos entrées. Les sources de type lien doivent pointer vers des pages contenant un contexte utile — directives de marque, guides de style, documentation produit, glossaires. Les sources de contenu brut doivent contenir une terminologie concrète, des indications de ton ou des règles de traduction. Les pages marketing génériques ou les écrans de connexion produisent peu de configuration exploitable.
Le principe derrière cet encadré est simple : l’agent extrait ce qui est énoncé, pas ce qui est seulement suggéré. Une page qui dit "nous écrivons dans un allemand amical et direct, en utilisant Sie, jamais Du" produit une voix de marque. Une page de glossaire qui liste "workspace → Arbeitsbereich" produit un élément de glossaire. Une landing page soignée qui montre un bon ton sans formuler la moindre règle ne produit presque rien, car il n’y a aucune règle explicite à en extraire. En cas de doute, privilégiez la source qui dit la règle clairement à voix haute — et c’est souvent un bloc content que vous rédigez vous-même dans une phrase, plutôt qu’une page depuis laquelle vous espérez que l’agent l’infère.
Une source faible ne fera pas échouer la tâche#
Une inquiétude naturelle surgit quand plusieurs sources sont envoyées en même temps : si une URL est morte ou si un bloc est trop léger, est-ce que toute la requête échoue ? Non. Les sources sont lues indépendamment, et un échec sur un élément est consigné sans être fatal : un lien mort ou un bloc illisible est ignoré, et l’agent travaille à partir de ce qu’il a pu lire. La tâche n’échoue dans son ensemble que lorsqu’aucune source n’a pu être lue, et qu’il ne reste donc rien à analyser. Les formes exactes de ces résultats — les échecs par élément consignés en cas de succès, et la charge utile d’échec quand rien n’a pu être lu — relèvent de Ce que l’IA extrait et de Livraison des webhooks.
Vous pouvez donc lister un ensemble de candidats sans auditer chaque URL à l’avance : les sources solides contribuent, les plus faibles tombent d’elles-mêmes, et vous consultez le résumé de sortie pour voir ce qui a réellement été pris en compte. Pointez le système vers ce que vous avez déjà — puis vérifiez ce qui est revenu.
