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:
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEYCampos del trabajo #
| Campo | Significado |
|---|---|
id, organizationId, engineId | Identificación del trabajo, junto con la organización y el motor a los que pertenece. |
status | Estado etiquetado como Running, Completed o Failed. Failed incluye message. |
kinds | Resultados de las tareas solicitadas de glossary, ruleset y brandVoice. Los tipos no solicitados pueden no aparecer. |
sources | Progreso o informe de lectura de la fuente opcional. |
website | Primera URL de sitio web proporcionada; no aparece si la entrada contiene solo texto. |
createdAt | Marca de tiempo de creación en formato ISO. |
finishedAt | Marca 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>._tag | Campos y significado |
|---|---|
Pending | Sigue en proceso. El campo opcional step es reading, generating o saving; startedAt indica cuándo comenzó ese paso. |
Done | setId identifica el conjunto adjunto; itemCount indica la cantidad de elementos generados. |
Skipped | reason explica por qué el tipo se dejó sin cambios. |
Failed | message 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ó:
{
"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/termspara las entradas del glosario.GET /v2/rulesets/:id/rulespara las reglas.GET /v2/brand-voices/:id/variationspara 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.