Orkestrointi
Muuta kertaluontoiset agenttiajot toistettaviksi, tarkasteltaviksi työnkuluiksi.
Määrittele työnkulku tyypitettyjen solmujen DAG:na: tyyppejä on tänään kuusitoista, niiden joukossa claude (Claude Code -istunto), http_request, assert ja wait_for_approval. Validoi se ja aja se. Jokainen ajo tuottaa ajon tietueen, jota voidaan seurata reaaliajassa ja tarkastella jälkikäteen. Aloita pohjasta tai rakenna kanvasilla. Kaikki on asiakaskohtaista rivitason tietoturvan takana.
trigger
manual / cron
claude · plan
claude-code
http_request · ci
POST /builds
assert · green
ctx.ci.status
wait_for_approval
human · gate
Miten se toimii
1
Määrittele DAG
Asettele solmut ja niiden väliset yhteydet: claude-solmu kantaa kehotteen, http_request-solmu kutsun, assert-solmu ehdon ja wait_for_approval-solmu ihmisen hyväksynnän.
2
Validoi
Palvelin tarkistaa graafin (ei syklejä, jokainen riippuvuus ratkeaa) ennen kuin mitään ajetaan.
3
Aja se
Käynnistä työnkulku manuaalisesti tai ajastetusti. Jokainen solmu ajetaan järjestyksessä riippuvuuksiaan noudattaen.
4
Seuraa ajoa
Seuraa ajon tietuetta reaaliajassa kanvasilla ja ajonäkymässä, ja tarkastele valmistunutta ajoa myöhemmin.
Syväsukellukset
Kuusitoista solmutyyppiä
Ajuri välittää kuuttatoista solmutyyppiä. claude ajaa Claude Code -istunnon kehotteesta; http_request kutsuu rajapintaa; assert tarkistaa ehdon ja kaataa ajon; wait_for_approval pysäyttää ajon kunnes ihminen hyväksyy sen. Loput kattavat ohjausvuon ja datan: branch, retry, for_each, fan_out, aggregate, transform, set_variable, delay, log, notify, sub_workflow, wait_for_event. Koostamalla ne DAG:ksi voidaan ketjuttaa suunnittelu, koodimuutokset, tarkistukset ja portit yhdeksi ajoksi.
Aikakatkaisut solmutyypeittäin
claude-solmulla on aikakatkaisu (oletuksena 600 s); ylityksessä ajuri lähettää istunnolle SIGTERMin, joten jumissa oleva Claude Code -istunto ei pidä ajoa auki. Muut tyypit rajaavat itsensä omalla tavallaan: http_request keskeyttää oman kutsunsa (oletuksena 30 s, kattona 120 s), wait_for_approval ja wait_for_event luovuttavat oman timeout_s-arvonsa jälkeen (oletuksena 24 h). sub_workflow'lla ei ole omaa takarajaa.
Pohjat ja visuaalinen kanvas
Aloita sisäisestä aloituspohjasta ja muokkaa sitten visuaalisella kanvasilla. Ajonäkymä näyttää jokaisen solmun tilan ajon edetessä.
Määrittele ja aja työnkulku
api · define and run a workflow
# A workflow is a JSON definition — start, nodes, edges.
$ curl -X POST https://app.acme.internal/api/fleet/workflows \
-H "authorization: Bearer $TOKEN" \
-d '{"name": "ci-triage", "definition": {
"start": "plan",
"nodes": [{"id": "plan", "type": "claude",
"prompt": "triage the failing build", "timeout_s": 900},
{"id": "check", "type": "assert", "expr": "ctx.plan.output"}],
"edges": [{"from": "plan", "to": "check"}]}}'
✓ graph validated on write — cycles and edges to unknown nodes rejected
$ curl -X POST https://app.acme.internal/api/fleet/workflows/WF_ID/run \
-H "authorization: Bearer $TOKEN"
{"run_id": "3c8a…"}
# Same two steps in the UI: the canvas at #/workflows,
# then the live run at #/workflow-runs/3c8a…
Orkestrointi, joka on auditoitavaa, ei läpinäkymätöntä.
Työnkulku on vain DAG, jonka voi lukea, versioida ja tarkastella. Jokainen ajo tallennetaan, joten nähtävissä on täsmälleen, mikä solmu teki mitä, ei mustan laatikon automaatiota.
Vertailu
| Caldyr | Shell-skriptit | Yleinen CI | |
|---|---|---|---|
| Agenttinatiivit solmut | kyllä | ei | ei |
| DAG:n validointi ennen ajoa | syklit + riippuvuudet tarkistettu | ei | osittain |
| Reaaliaikainen ajon tietue | kanvas + ajonäkymä | vain lokit | vain lokit |
| claude-solmun aikakatkaisu → SIGTERM | solmukohtainen | manuaalisesti | vain työtason |
| Asiakkaan eristys | RLS-rajattu | ei | jaetut ajurit |
UKK
Solmutyyppejä on tänään kuusitoista. claude ajaa Claude Code -istunnon kehotteesta; http_request kutsuu rajapintaa; assert tarkistaa ehdon; wait_for_approval odottaa ihmistä. Muut ovat ohjausvuota ja datan siirtoa: branch, retry, for_each, fan_out, aggregate, transform, set_variable, delay, log, notify, sub_workflow, wait_for_event. Ne ketjutetaan DAG:ksi, ja jokaisen solmun tuloste liitetään seuraavaan riippuvuuksien kautta.
claude-solmulla on aikakatkaisu — oletuksena 600 s — ja ylityksessä ajuri lähettää istunnolle SIGTERMin, joten jumissa oleva Claude Code -istunto pysäytetään sen sijaan, että se pitäisi koko ajon auki. Muut tyypit rajaavat itsensä toisin: http_request keskeyttää oman kutsunsa (oletuksena 30 s, kattona 120 s), wait_for_approval ja wait_for_event luovuttavat oman timeout_s-arvonsa jälkeen (oletuksena 24 h), eikä sub_workflow'lla ole omaa takarajaa.
Ei. Tarjolla on aloituspohjia kloonattavaksi ja visuaalinen kanvas/editori graafin säätämiseen. Työnkulun voi myös määritellä koneluettavana määrittelynä ja ajaa sen API:n kautta.
Ei. Työnkulut ja niiden ajot ovat asiakaskohtaisia ja rajattu Postgresin rivitason tietoturvalla, joten ne näkyvät vain niitä omistavan yrityksen sisällä.