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:
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEYCampos de la tarea #
| Campo | Significado |
|---|---|
id, organizationId, engineId | Identificación de la tarea, la organización y el motor a los que pertenece. |
status | Estado etiquetado como Running, Completed o Failed. Failed incluye message. |
kinds | Resultados del trabajo solicitado para glossary, ruleset y brandVoice. Los tipos no solicitados pueden no aparecer. |
sources | Progreso o informe de lectura de las fuentes opcional. |
website | Primera URL de sitio web proporcionada; no aparece si la entrada solo contiene texto. |
createdAt | Marca de tiempo de creación en formato ISO. |
finishedAt | Marca 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>._tag | Campos y significado |
|---|---|
Pending | El trabajo sigue en curso. El campo opcional step puede ser reading, generating o saving; startedAt indica cuándo comenzó ese paso. |
Done | setId identifica el conjunto asociado; itemCount indica el número 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 los resultados contiene un glosario generado y un conjunto de reglas cuya generación ha fallado:
{
"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/termspara las entradas del glosario.GET /v2/rulesets/:id/rulespara las reglas.GET /v2/brand-voices/:id/variationspara 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.