Jobs

As ferramentas de jobs permitem que um assistente acompanhe o trabalho que o Nodaro faz para ele. Quase toda ferramenta de geração inicia um job e retorna o ID dele na hora; get_job e wait_for_job informam quando ele termina e onde está o resultado, list_jobs lista os seus jobs recentes e diagnose_run explica uma falha. As quatro precisam da permissão jobs:read e não custam créditos.

Status dos jobs

Um job retido termina como completed quando o revisor o aprova, ou como failed, com um motivo de política, quando o revisor o rejeita. Um cliente que acompanha o job pela API tasks do MCP vê um job retido como input_required: a decisão cabe ao revisor, então não peça novos parâmetros ao usuário.

O envelope do job

get_job e wait_for_job retornam o mesmo resultado estruturado, o envelope do job. get_asset também o retorna, sem input.

input é um subconjunto seguro da requisição, suficiente para conferir o que o modelo recebeu. Nada fora desta lista é incluído:

• prompt, o prompt final, depois de incorporados os seletores, os assuntos e as referências, e userPrompt, as suas próprias palavras.
• negativePrompt e os IDs dos seletores direction e subject.
• provider, model, duration, resolution e aspectRatio.
• imageUrl, endFrameUrl e as URLs das imagens, vídeos e áudios de referência.
• O type do job.

get_job

Retorna um dos seus jobs pelo ID, como envelope do job. Use-a para verificar um job a cada 5 a 10 segundos até ele terminar.

Permissão: jobs:read. Créditos: grátis.

Retorna: o envelope do job.

wait_for_job

Fica em espera até um dos seus jobs terminar e então retorna o envelope do job. Use-a em vez de um loop de chamadas seguidas a get_job.

Permissão: jobs:read. Créditos: grátis.

Retorna: o envelope do job. Quando o job ainda está em execução no fim do prazo, o status é timeout. Isso não é um erro: chame wait_for_job de novo ou consulte get_job periodicamente. Um job retido responde pending_review na hora. Para a renderização longa de um vídeo, consultar get_job a cada 5 a 10 segundos é melhor do que esperas repetidas.

list_jobs

Lista os seus jobs recentes como dados estruturados: status, tipo, URL da saída, erro, créditos e marcas de data e hora. Use-a para perguntas como “quantas gerações falharam ontem”. Quando o usuário quiser ver os resultados, use browse_gallery, que mostra uma grade.

Permissão: jobs:read. Créditos: grátis.

Retorna: uma página de jobs e um next_cursor para a página seguinte.

diagnose_run

Explica por que uma execução de workflow ou um job avulso falhou. Informe qualquer um dos dois IDs: a ferramenta tenta primeiro uma execução de workflow e, se não encontrar, um job.

Permissão: jobs:read. Créditos: grátis.

Retorna: para uma execução de workflow, cada nó com o ID do job, o tipo e o status (nodes). Esta é a única ferramenta que relaciona os nós de uma execução aos IDs dos jobs deles. Cada nó com falha também traz a mensagem de erro, o modelo, os créditos efetivamente cobrados (creditsActual), uma classe de falha e uma dica de como corrigi-la.

A classe é uma estimativa feita a partir do texto do erro, então trate-a como orientação. Os créditos reservados são reembolsados automaticamente em todas as classes, exceto post_processing, porque, nesse caso, o modelo já entregou o trabalho.

Quando um job falha

1. Leia retryable. false significa que a mesma requisição, sem mudanças, vai falhar de novo. Isso acontece depois de um bloqueio por política de conteúdo ou quando o modelo recusou a combinação de configurações e mídias de entrada.
2. Siga suggestedProvider. Quando um filtro de segurança bloqueou o resultado e o catálogo tem um modelo alternativo, o job o indica. Execute o mesmo prompt e as mesmas referências nesse modelo, em vez de adivinhar outro.
3. Mude a requisição quando o modelo a recusar. Um erro que diz que o modelo rejeitou essas configurações significa que a duração, a proporção, a resolução ou um arquivo de referência não serve para esse modelo. Mude esses valores ou escolha um modelo cuja ficha de recursos em list_models permita a combinação.
4. Tente de novo nos outros casos. Um erro temporário do serviço do modelo continua retryable, mesmo quando a mensagem parece um problema de validação.

Mais soluções estão em Solução de problemas.