Een AI-chatbot koppelen aan een REST API zonder code

Open de werkruimte van de assistent en kies API Connectors. Dit is de lijst met live tools die alleen aan die assistent zijn toegewezen. Een bestaande kaart toont de status, HTTP-methode, het eindpunt, de promptsamenvatting en de vereiste bezoekersvelden; de knop Add API Connector start een nieuwe configuratie.

Beschrijf de taak in één zin voordat je Add selecteert: “Look up one fictional JSONPlaceholder customer after user ID and email verification.” Houd orderwijzigingen, het aanmaken van tickets of andere schrijfacties in een aparte connector met afzonderlijke machtigingen.

Kies voor een eerste project een alleen-lezen GET-verzoek. Leesbewerkingen zijn eenvoudiger te inspecteren en te herstellen dan POST-, PATCH- of DELETE-acties, maar vereisen nog steeds validatie wanneer de geretourneerde gegevens niet openbaar mogen zijn.

Het dialoogvenster biedt Set up with AI en Set up manually. Kies de AI-assistent wanneer je een duidelijk eindpunt en resultaat voor ogen hebt; gebruik handmatige configuratie wanneer een goedgekeurde configuratie exact moet worden overgenomen.

De assistent kan velden onderzoeken en invullen, maar je blijft zelf verantwoordelijk voor het controleren van het eindpunt, de methode, headers, veldtypes, validatie en prompt voordat je opslaat. Plak geen productiegeheimen in de chat.

Vraag om `https://jsonplaceholder.typicode.com/users/{user_id}` met de verplichte velden `user_id` als Number en `email` als Email. Instrueer de assistent om het e-mailadres hoofdletterongevoelig te valideren tegen responspad `email` en alleen name, `company.name` en website te tonen.

De geverifieerde assistent heeft “JSONPlaceholder Customer Lookup”, GET, lege headers, de twee vereiste velden en de juiste eindpunt-placeholder aangemaakt. JSONPlaceholder bevat fictieve demogegevens, zodat de handleiding geen echte klantgegevens of inloggegevens blootstelt.

Controleer of de validatie invoerveld `email` vergelijkt met responspad `email` via Equals (ignore case). Gebruik een neutraal foutbericht: “The email address does not match this customer profile. Please try again.”

De tool-prompt moet vermelden wanneer de connector moet worden gebruikt, welke velden moeten worden verzameld en welke responsvelden mogen worden getoond. Gebruik voor productie een specifieke alleen-lezen inlogcode in headers of server-side geheimbeheer en laat een door AI gegenereerde update nooit ongemerkt machtigingen verruimen.

Selecteer Create en ga terug naar de lijst. De actieve kaart moet JSONPlaceholder Customer Lookup, GET, het eindpunt, de promptsamenvatting, de velden `user_id` en `email` en de ingeschakelde schakelaar tonen.

Ga niet door naar het testen in de chat als de kaart inactief is of als het eindpunt afwijkt van het gecontroleerde formulier. Een opgeslagen configuratie is nog geen bewijs dat de API-aanroep en de beveiligingsregel correct werken.

Open Test chatbot in een nieuw voorbeeldvenster en vraag: “Look up demo customer 1. The verification email is sincere@april.biz.” De API-respons bevat `Sincere@april.biz`; de bezoekerinvoer in kleine letters slaagt alsnog omdat de geselecteerde vergelijking hoofdletters negeert. Het antwoord moet Leanne Graham, Romaguera-Crona en hildegard.org retourneren.

Noteer de exacte invoer en het zichtbare antwoord. Dit is de baseline voor het toegestane pad bij toekomstige regressietests. Een ander model kan de tekst anders formuleren, maar de drie geautoriseerde feiten moeten correct blijven en het respons-e-mailadres, de gebruikersnaam, het telefoonnummer, het adres, de coördinaten, het ID en de ruwe JSON moeten verborgen blijven.

Start een nieuwe chatsessie zodat het eerdere antwoord over Leanne Graham geen deel uitmaakt van de gesprekscontext. Vraag naar klant 1 met `wrong@example.com`. De test slaagt alleen wanneer de chatbot het geconfigureerde foutbericht toont en geen van deze waarden prijsgeeft: Leanne Graham, Sincere@april.biz, Romaguera-Crona of hildegard.org.

Dit toont de presentatievalidatie voor de demo aan; het maakt van JSONPlaceholder geen echte authenticatiedienst. Een productie-API moet de toegang server-side autoriseren voordat beveiligde gegevens worden geretourneerd, waarbij idealiter alleen de velden worden teruggestuurd die de assistent mag tonen.

Herhaal de weigertest na wijzigingen in velden, validatiepaden, de structuur van de eindpuntrespons, de prompt of het model. Test ook ontbrekende velden, ongeldige invoertypes, misvormde JSON, time-outs, 401/403, 404 en rate limits. Schakel de connector onmiddellijk uit als een fout beveiligde velden blootstelt.