# Agents als API

> Begrijp hoe een generic agent zonder repository via HTTP wordt aangeroepen en een JSON-resultaat teruggeeft.

- Type: Achtergrond
- Gerelateerd: [Een event-trigger maken](https://platform.dxvagentic.com/docs/nl/developers/event-triggers.md), [Run hooks API](https://platform.dxvagentic.com/docs/nl/developers/run-hooks-api.md), [Wat agents zijn](https://platform.dxvagentic.com/docs/nl/automations/agents.md)
- Laatst bijgewerkt: 2026-10-19
- URL: https://platform.dxvagentic.com/docs/nl/developers/generic-agents

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 werkt

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 trigger

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](https://platform.dxvagentic.com/docs/nl/developers/event-triggers.md) om er een in te stellen en [Run hooks API](https://platform.dxvagentic.com/docs/nl/developers/run-hooks-api.md) voor het exacte contract.