Bouw een gepersonaliseerde ervaring voor je gebruikers direct in je GPT. Deze tutorial laat je zien hoe je OAuth kunt gebruiken om een persoonlijke agenda-assistent GPT te creëren.
GPTs zijn geweldig om de ChatGPT-ervaring diepgaand aan te passen voor specifieke gebruikssituaties. Nog beter, het stelt je in staat om direct met je services te communiceren via acties.
In deze tutorial laten we zien hoe je OAuth kunt gebruiken om gebruikers in je GPT-acties te verifiëren. We bouwen een persoonlijke agenda-assistent waarmee gebruikers hun evenementen direct in de GPT kunnen beheren.
De uiteindelijke GPT ziet er als volgt uit:
De linkerkant is de interactie van de gebruiker met de GPT; de rechterkant is de webapp die de agenda van de gebruiker weergeeft. Er zijn meer mogelijkheden met deze benadering, zoals:
De resultaten en bronnen van deze tutorial:
Klik op de knop Maak nieuwe actie onderaan. Op de nieuwe pagina zijn er drie secties:
In deze tutorial hebben we een vooraf gebouwde agenda-app die REST API's blootstelt voor het beheren van de agenda van de gebruiker. Je kunt het OpenAPI-schema vinden in de GitHub-repo.
Zodra je het schema plakt, herkent de GPT automatisch de eindpunten en genereert een tabel voor je. Je kunt op de knop Testen klikken om de eindpunten te testen.
De GPT zal om je toestemming vragen om de API-aanroep uit te voeren. Klik op de knop Toestaan of Altijd Toestaan om door te gaan.
Als je eindpunt authenticatie vereist, zie je een foutmelding zoals hierboven. Wanneer we de serverlogboeken controleren, zien we dat de GPT het verzoek verzendt zonder enige authenticatie-informatie.
ChatGPT vereist dat zowel de acties als de authenticatie-eindpunten in hetzelfde hoofddomein zitten. Bijvoorbeeld, als je acties-eindpunt https://api.example.com/ is, dan moet het authenticatie-eindpunt iets zijn als https://auth.example.com/.
Om aan deze eis te voldoen, moeten we een aangepast domein configureren in Logto Cloud. Nadat je bent aangemeld bij Logto Cloud, klik je op het tabblad Instellingen links en klik je vervolgens op het tabblad Domeinen bovenaan.
Gewoonlijk duurt het slechts een paar minuten om de configuratie te voltooien. Zodra het is voltooid, zie je dat het aangepaste domein in gebruik is.
Om OAuth-authenticatie uit te voeren, moeten we een app maken in Logto Cloud. Nadat je bent aangemeld bij Logto Cloud, klik je op het tabblad Toepassingen links en klik je vervolgens op de knop Applicatie maken rechtsboven.
Op de nieuwe pagina klik je onderaan op "App maken zonder framework". Kies "Traditioneel web" als het applicatietype en voer een naam in voor je app, bijvoorbeeld GPT Agenda Assistent. Klik vervolgens onderaan op "Applicatie maken".
Nadat de app is gemaakt, navigeer je naar de kaart EINDPUNTEN & INLOGGEGEVENS (je moet mogelijk een beetje naar beneden scrollen). Klik op Eindpuntgegevens weergeven om de informatie uit te breiden.
Navigeer nu terug naar de GPT-actiepagina, klik op de sectie Authenticatie, en kies vervolgens OAuth. De formulieritems komen overeen met de informatie in Logto Cloud zoals volgt:
Voor het veld Scope, voer openid offline_access in; voor het veld "Tokenuitwisselingsmethode", houd de standaardwaarde (POST-verzoek) aan.
Klik ten slotte op de knop Opslaan onderaan.
Ga terug naar de GPT-configuratiepagina, nu zie je een veld Callback-URL onder de sectie Acties.
Kopieer die URL en ga dan terug naar de Logto Cloud app-pagina. Plak de URL in de sectie Omleidings-URI's.
Scroll nu naar beneden, schakel Altijd Verversings-Token uitgeven in om verversings-tokenondersteuning in te schakelen voor GPT. Dit kan je gebruikers helpen ingelogd te blijven voor een langere tijd in de GPT.
Klik dan op de knop Opslaan onderaan.
Nu we alles gereed hebben, laten we de OAuth-flow testen om ervoor te zorgen dat alles werkt zoals verwacht. Ga terug naar de GPT-configuratiepagina, klik op de actie die we hebben gemaakt, en klik vervolgens op de knop Testen voor het listItems-eindpunt (de eerste).
Het voorbeeldvenster vraagt je om in te loggen. Klik op de knop Inloggen met [je actienaam] en voltooi de OAuth-flow.
Je kunt de aanmeldingservaring aanpassen, zoals de branding en de aanmeldingsmethoden in de Logto Cloud. Voor meer informatie, zie 🎨 Aanmeldingservaring aanpassen.
Als alles werkt zoals verwacht, zou je backend-server een verzoek moeten ontvangen met de toegangstoken in de Authorization header. In ons geval is de backend-server de agenda-app. Het zal de agenda van de gebruiker retourneren in de responsebody:
Verbazingwekkend genoeg, omdat ons OpenAPI-schema gedetailleerd genoeg is, kan de GPT de API-aanroep uitvoeren zonder enige extra configuratie. Bijvoorbeeld, als je op de knop Testen klikt voor het createItems-eindpunt, zie je dat de GPT het verzoeklichaam voor je genereert (of je vraagt om de ontbrekende informatie te verstrekken, afhankelijk van zijn gemoedstoestand).
Met de werkende OAuth-flow kunnen we nu het toegangstoken in backend-services valideren om ervoor te zorgen dat het verzoek afkomstig is van een geauthenticeerde gebruiker. Aangezien Logto een OIDC-provider is, kunnen we het Userinfo-eindpunt gebruiken om het toegangstoken te valideren. Het eindpunt kan worden gevonden op de Logto Cloud app-pagina.
Stuur eenvoudigweg een GET-verzoek naar het eindpunt met het toegangstoken in de Authorization header. Als het toegangstoken geldig is, zal het eindpunt de informatie van de gebruiker teruggeven in de responsebody. Hier is een voorbeeld met Node.js:
Je kunt de volledige code vinden in de GitHub-repo.
Je hebt mogelijk je eigen agenda-app, en met authenticatie kun je de agenda van de gebruiker in realtime synchroniseren zonder het gesprek te verlaten. Om de realtime synchronisatie in actie te zien, kun je naar de webapp gaan en inloggen met hetzelfde account dat je in de demo GPT hebt gebruikt.
GPT-acties kunnen een krachtig hulpmiddel zijn om een gepersonaliseerde ervaring voor je gebruikers te creëren. Als je vragen of feedback hebt, voel je vrij om deel te nemen aan onze Discord-server voor discussie.