Agents als API

Een generic agent heeft geen repository. Je roept hem via HTTP aan in plaats van met een gewoon verzoek. Er is geen preview en geen wijziging om te beoordelen. De agent geeft een JSON-resultaat terug.

Hoe het werktCopy Anchor Link

Je maakt een event-trigger voor de agent. Dat kan op de pagina Automatiseringen van een project, of op het tabblad Integration van de agent zelf. Daarna:

1. Afvuren. POST willekeurige JSON naar de hook-URL van de trigger, met het secret. De aanroep geeft direct 202 terug met featureRequestId en dispatched, voordat de agent heeft gedraaid.
2. Pollen. GET /api/hooks/runs/:id met hetzelfde secret om id, status, createdAt, updatedAt en result te lezen. result is null totdat de run een eindstatus bereikt.

De ruwe payload van de aanroep gaat als gestructureerde invoer naar de agent.

Wat anders is dan bij een gewone triggerCopy Anchor Link

Elke aanroep van een generic agent is een aparte run. De controle op lopende runs en de afkoelperiode van een gewone event-trigger gelden niet. Elke run staat nog steeds onder het tabblad Runs van het project. Het HTTP-contract is een alternatieve ingang, geen apart systeem.

Zie Een event-trigger maken om er een in te stellen en Run hooks API voor het exacte contract.