Consultar resultados do provisionamento
Confira a tarefa, os conjuntos gerados, o trabalho ignorado e as falhas parciais.
Consulte uma tarefa de provisionamento usando o ID retornado na criação:
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEYCampos da tarefa #
| Campo | Significado |
|---|---|
id, organizationId, engineId | Identificação da tarefa, da organização e do engine aos quais ela pertence. |
status | Estado marcado como Running, Completed ou Failed. Failed inclui message. |
kinds | Resultados do trabalho solicitado para glossary, ruleset e brandVoice. Tipos não solicitados podem estar ausentes. |
sources | Progresso ou relatório de leitura da fonte opcional. |
website | Primeira URL de site fornecida; ausente quando a entrada contém apenas texto. |
createdAt | Data e hora de criação no formato ISO. |
finishedAt | Data e hora de conclusão no formato ISO, disponíveis após a finalização. |
Estados por tipo #
Verifique cada tipo solicitado, mesmo quando a tarefa de nível superior estiver no estado Completed:
kinds.<kind>._tag | Campos e significado |
|---|---|
Pending | Ainda em andamento. O campo opcional step pode ser reading, generating ou saving; startedAt indica quando essa etapa começou. |
Done | setId identifica o conjunto vinculado; itemCount é o número de itens gerados. |
Skipped | reason explica por que o tipo foi mantido sem alterações. |
Failed | message explica por que não foi possível preencher o tipo. |
Por exemplo, este trecho do resultado contém um glossário gerado e um conjunto de regras cuja geração falhou:
{
"glossary": { "_tag": "Done", "setId": "YOUR_GLOSSARY_ID", "itemCount": 12 },
"ruleset": { "_tag": "Failed", "message": "Could not generate rules from the supplied material." }
}Cada tipo é salvo de forma independente. As orientações geradas com sucesso continuam disponíveis mesmo quando outro tipo falha. Um engine também pode receber um conjunto vinculado durante a geração, fazendo com que o preenchimento restrito a tipos vazios ou o preenchimento da voz da marca seja ignorado.
Inspecionar os registros gerados #
Abra o engine no Studio e acesse o glossário, o conjunto de regras ou a voz da marca vinculados. Para consultas via API, use:
GET /v2/glossaries/:id/termspara entradas do glossário.GET /v2/rulesets/:id/rulespara regras.GET /v2/brand-voices/:id/variationspara variações de voz.
Use o setId correspondente e siga a paginação de cada lista. Verifique a terminologia, a aplicabilidade por idioma, os nomes que não devem ser traduzidos e quaisquer suposições adicionadas pelo modelo. A contagem de itens indica quantos registros foram criados, não se estão corretos.
Para um tipo com falha, consulte nova tentativa e recuperação. Preserve os conjuntos concluídos em vez de criar outro engine para repetir todo o trabalho.