Consultar los resultados del aprovisionamiento

Revisa el trabajo, los conjuntos generados, las tareas omitidas y las fallas parciales.

Consulta un trabajo de aprovisionamiento con el ID devuelto al crearlo:

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

Campos del trabajo #

CampoSignificado
id, organizationId, engineIdIdentificación del trabajo, junto con la organización y el motor a los que pertenece.
statusEstado etiquetado como Running, Completed o Failed. Failed incluye message.
kindsResultados de las tareas solicitadas de glossary, ruleset y brandVoice. Los tipos no solicitados pueden no aparecer.
sourcesProgreso o informe de lectura de la fuente opcional.
websitePrimera URL de sitio web proporcionada; no aparece si la entrada contiene solo texto.
createdAtMarca de tiempo de creación en formato ISO.
finishedAtMarca de tiempo de finalización en formato ISO, disponible una vez que el trabajo alcanza un estado definitivo.

Estados por tipo #

Revisa cada tipo solicitado, incluso cuando el trabajo de nivel superior esté en estado Completed:

kinds.<kind>._tagCampos y significado
PendingSigue en proceso. El campo opcional step es reading, generating o saving; startedAt indica cuándo comenzó ese paso.
DonesetId identifica el conjunto adjunto; itemCount indica la cantidad de elementos generados.
Skippedreason explica por qué el tipo se dejó sin cambios.
Failedmessage explica por qué no se pudo completar el tipo.

Por ejemplo, este fragmento de resultados contiene un glosario generado y un conjunto de reglas cuya generación falló:

json
{
  "glossary": { "_tag": "Done", "setId": "YOUR_GLOSSARY_ID", "itemCount": 12 },
  "ruleset": { "_tag": "Failed", "message": "Could not generate rules from the supplied material." }
}

Cada tipo se guarda de forma independiente. Las pautas generadas correctamente siguen disponibles aunque otro tipo falle. También se puede adjuntar un conjunto a un motor mientras la generación está en curso, lo que puede hacer que se omita el llenado exclusivo de conjuntos vacíos o el llenado de la voz de marca.

Revisar los registros generados #

Abre el motor en Studio y accede al glosario, al conjunto de reglas o a la voz de marca adjuntos. Para consultar los registros mediante la API, usa:

  • GET /v2/glossaries/:id/terms para las entradas del glosario.
  • GET /v2/rulesets/:id/rules para las reglas.
  • GET /v2/brand-voices/:id/variations para las variaciones de voz.

Usa el setId correspondiente y sigue la paginación de cada lista. Revisa la terminología, la aplicabilidad por idioma, los nombres no traducibles y cualquier suposición que haya agregado el modelo. El recuento de elementos indica cuántos registros se crearon, no si son correctos.

Si un tipo falló, usa reintento y recuperación. Conserva los conjuntos completados en lugar de crear otro motor para repetir todo el trabajo.