API-acties vereisen technisch inzicht in het opzetten van servers of interfaces.
Let op: deze handleiding is alleen beschikbaar in het Engels, omdat deze voornamelijk gericht is op gebruikers met een meer technische achtergrond, voor wie Engels de standaard is.
Met API-acties kunt u externe systemen en services aan uw workflows koppelen door HTTP-verzoeken naar hun endpoints te sturen. Ze stellen u in staat om programmatisch gegevens te verzenden naar of op te halen uit applicaties van derden, databases of aangepaste servers. U kunt de verzoekmethode (GET, PATCH, POST, PUT, DELETE), headers, authenticatie en body-parameters configureren om aan de vereisten van de API te voldoen. API-acties zijn bijzonder nuttig wanneer MCP-integratie niet beschikbaar is of wanneer u directe controle over de HTTP-communicatie nodig heeft. Eenmaal geconfigureerd kunnen deze acties automatisch worden geactiveerd binnen uw workflows of door AI-agents om taken te automatiseren en gegevens tussen platforms te synchroniseren.
Let op!
De kwaliteit van uw gegevens is echt belangrijk! Als u de AI voorziet van informatie van lage kwaliteit, krijgt u ook resultaten van lage kwaliteit terug (denk aan "rommel erin, rommel eruit")
Elk AI-model werkt met contextlimieten, oftewel een beperking van de hoeveelheid gegevens die via externe systemen, bijvoorbeeld via API of via een MCP-server, beschikbaar wordt gesteld.
Om de best mogelijk antwoordkwaliteit te verkrijgen, is het essentieel om de informatie zo sterk mogelijk vooraf te filteren. Het doel is dat het AI-model uitsluitend exact die informatie ontvangt die nodig is om precies dit ene bericht te beantwoorden.
Anders wordt het AI-model "volgeladen" met ongefilterde informatie, en daarmee ook een onnodig grote hoeveelheid gegevens, in de hoop dat de AI daaruit een zinvol antwoord genereert, en dat bij voorkeur ook nog razendsnel. Dit is niet realistisch.
Maak daarom optimaal gebruik van de mogelijkheden om parameters door te geven, zowel op basis van de invoer van de contactpersoon als bij het retourneren van gegevens via API.
Geef uw API-actie een interne naam en geef instructies aan uw AI-agent over wanneer deze actie moet worden geactiveerd.
Voeg de aangewezen endpoint-URL en methode toe.
Configureer indien nodig headers, body en placeholders.
Houd er rekening mee dat u uw nieuwe API-actie moet activeren voor elke AI-agent waarvoor u toegang wilt geven in het tabblad Systeemacties van uw AI-agent instellingenpagina.
Voorbeeldconfiguraties
Voorbeeldconfiguraties