Consulter les résultats du provisionnement
Examinez la tâche, les ensembles générés, les opérations ignorées et les échecs partiels.
Consultez une tâche de provisionnement à l’aide de l’identifiant renvoyé lors de sa création :
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEYChamps de la tâche #
| Champ | Signification |
|---|---|
id, organizationId, engineId | Identité de la tâche, organisation et moteur auxquels elle appartient. |
status | État identifié par l’étiquette Running, Completed ou Failed. Failed inclut message. |
kinds | Résultats des opérations demandées pour glossary, ruleset et brandVoice. Les types non demandés peuvent être absents. |
sources | Progression ou rapport de lecture des sources facultatif. |
website | Première URL de site web fournie ; absente si l’entrée ne contient que du texte. |
createdAt | Horodatage de création au format ISO. |
finishedAt | Horodatage de fin au format ISO, présent une fois la tâche terminée. |
États par type #
Examinez chaque type demandé, même lorsque la tâche globale est Completed :
kinds.<kind>._tag | Champs et signification |
|---|---|
Pending | Traitement toujours en cours. Le champ facultatif step vaut reading, generating ou saving ; startedAt indique quand cette étape a commencé. |
Done | setId identifie l’ensemble associé ; itemCount indique le nombre d’éléments générés. |
Skipped | reason explique pourquoi le type est resté inchangé. |
Failed | message explique pourquoi le type n’a pas pu être renseigné. |
Par exemple, cet extrait de résultat contient un glossaire généré et un ensemble de règles dont la génération a échoué :
{
"glossary": { "_tag": "Done", "setId": "YOUR_GLOSSARY_ID", "itemCount": 12 },
"ruleset": { "_tag": "Failed", "message": "Could not generate rules from the supplied material." }
}Chaque type est enregistré indépendamment. Les consignes générées avec succès restent disponibles même si un autre type échoue. Un ensemble peut aussi être associé à un moteur pendant la génération, ce qui peut entraîner l’omission du remplissage réservé aux ensembles vides ou du remplissage de la voix de marque.
Examiner les enregistrements générés #
Ouvrez le moteur dans Studio, puis accédez au glossaire, à l’ensemble de règles ou à la voix de marque associés. Pour consulter les données via l’API, utilisez :
GET /v2/glossaries/:id/termspour les entrées du glossaire.GET /v2/rulesets/:id/rulespour les règles.GET /v2/brand-voices/:id/variationspour les variantes de voix.
Utilisez le setId correspondant et suivez la pagination de chaque liste. Vérifiez la terminologie, l’applicabilité par langue, les noms non traduisibles et les éventuelles hypothèses ajoutées par le modèle. Le nombre d’éléments indique combien d’enregistrements ont été créés, pas s’ils sont corrects.
Pour un type en échec, suivez la procédure de nouvelle tentative et récupération. Conservez les ensembles terminés plutôt que de créer un moteur de remplacement pour tout recommencer.