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:

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

Campos da tarefa #

CampoSignificado
id, organizationId, engineIdIdentificação da tarefa, da organização e do engine aos quais ela pertence.
statusEstado marcado como Running, Completed ou Failed. Failed inclui message.
kindsResultados do trabalho solicitado para glossary, ruleset e brandVoice. Tipos não solicitados podem estar ausentes.
sourcesProgresso ou relatório de leitura da fonte opcional.
websitePrimeira URL de site fornecida; ausente quando a entrada contém apenas texto.
createdAtData e hora de criação no formato ISO.
finishedAtData 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>._tagCampos e significado
PendingAinda em andamento. O campo opcional step pode ser reading, generating ou saving; startedAt indica quando essa etapa começou.
DonesetId identifica o conjunto vinculado; itemCount é o número de itens gerados.
Skippedreason explica por que o tipo foi mantido sem alterações.
Failedmessage 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:

json
{
  "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/terms para entradas do glossário.
  • GET /v2/rulesets/:id/rules para regras.
  • GET /v2/brand-voices/:id/variations para 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.