ConverterHQDevelopers
API v1

Projektowanie Jobs i workflows

Modeluj DAG, równoległość i zależności przed produkcją.

Job jest directed acyclic graph, nie sekwencyjnym skryptem. Każda Task deklaruje operation, input, options i dependencies.

Myśl DAG-iem

Niezależne Tasks modeluj jako sibling branches, by scheduler mógł je wykonywać równolegle. Dependencies niech oznaczają tylko prawdziwe wymagania danych.

Równolegle wykonuj niezależną pracę

Jeśli jeden upload daje PDF, thumbnail i tekst, utwórz trzy branches. Rzeczywista concurrency nadal zależy od planu i fair scheduling.

Wybierz granice Task

Twórz Task tam, gdzie potrzebujesz retry, observability, fan-out/fan-in lub osobnego efektu zewnętrznego. Parametry engine należą do settings.

Waliduj Job Builderem

Studio lokalnie sprawdza cycles i dependencies oraz generuje dokładny body POST /v1/jobs. POST /v1/jobs/validate pozostaje autorytatywny dla capabilities, settings, quota i konta.