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 :

http
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEY

Champs de la tâche #

ChampSignification
id, organizationId, engineIdIdentité de la tâche, organisation et moteur auxquels elle appartient.
statusÉtat identifié par l’étiquette Running, Completed ou Failed. Failed inclut message.
kindsRésultats des opérations demandées pour glossary, ruleset et brandVoice. Les types non demandés peuvent être absents.
sourcesProgression ou rapport de lecture des sources facultatif.
websitePremière URL de site web fournie ; absente si l’entrée ne contient que du texte.
createdAtHorodatage de création au format ISO.
finishedAtHorodatage 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>._tagChamps et signification
PendingTraitement toujours en cours. Le champ facultatif step vaut reading, generating ou saving ; startedAt indique quand cette étape a commencé.
DonesetId identifie l’ensemble associé ; itemCount indique le nombre d’éléments générés.
Skippedreason explique pourquoi le type est resté inchangé.
Failedmessage 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é :

json
{
  "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/terms pour les entrées du glossaire.
  • GET /v2/rulesets/:id/rules pour les règles.
  • GET /v2/brand-voices/:id/variations pour 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.