ConverterHQDevelopers
API v1

Projetando Jobs e workflows

Modele DAGs, paralelismo e dependências antes da produção.

Um Job é um grafo acíclico direcionado, não um script sequencial. Cada Task nomeada declara operação, entrada, opções e dependências.

Pensar em DAG

Modele Tasks independentes como ramos irmãos para que o scheduler execute em paralelo. Dependencies devem representar apenas pré-requisitos reais.

Paralelizar trabalho independente

Se um arquivo gera PDF, thumbnail e texto, crie três ramos. A concorrência final continua limitada pelo plano e pelo agendamento justo.

Escolher limites de Task

Crie uma Task quando precisar de retry, observabilidade, fan-out/fan-in ou efeito externo separado. Parâmetros do engine ficam em settings.

Validar com Job Builder

O studio verifica ciclos e dependências localmente e produz o body exato de POST /v1/jobs. POST /v1/jobs/validate continua autoritativo para capabilities, settings, quota e conta.