Consultar los resultados del aprovisionamiento

Revisa la tarea, los conjuntos generados, el trabajo omitido y los fallos parciales.

Consulta una tarea de aprovisionamiento con el ID devuelto al crearla:

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

Campos de la tarea #

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

Estados por tipo #

Revisa cada tipo solicitado, incluso cuando la tarea principal esté en estado Completed:

kinds.<kind>._tagCampos y significado
PendingEl trabajo sigue en curso. El campo opcional step puede ser reading, generating o saving; startedAt indica cuándo comenzó ese paso.
DonesetId identifica el conjunto asociado; itemCount indica el número 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 los resultados contiene un glosario generado y un conjunto de reglas cuya generación ha fallado:

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 directrices generadas correctamente siguen disponibles aunque falle otro tipo. También puede asociarse un conjunto a un motor mientras la generación está en curso, lo que puede hacer que se omita el rellenado limitado a conjuntos vacíos o el 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 asociados. Para consultar los datos mediante la API, utiliza:

  • 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 variantes de voz.

Utiliza el setId correspondiente y recorre las páginas de cada lista. Comprueba la terminología, la aplicabilidad por idioma, los nombres que no deben traducirse y cualquier suposición que haya añadido el modelo. El número de elementos indica cuántos registros se han creado, no si son correctos.

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