Overzicht

In dit artikel wordt uitgelegd hoe je acties in een GPT configureert, waaronder hoe je verbinding maakt met externe API's, definieert wat de GPT kan doen en authenticatie, schema's en werkruimtebeperkingen beheert.

Om een actie te configureren, heb je de API-gegevens nodig van de service waarmee je verbinding wilt maken, waaronder authenticatiegegevens en een OpenAPI-schema. Een GPT kan apps of acties gebruiken, maar niet beide tegelijk.

Elke actie wordt gedefinieerd door twee hoofdonderdelen: hoe de GPT zich authenticeert bij de API, en een schema dat definieert wat de API kan doen.

Beperkingen

Als je werkruimte nul actiedomeinen toestaat, kunnen aangepaste GPT-acties niet worden uitgevoerd omdat geen actiedomein de allowlist-controles kan doorstaan. Dit betekent niet noodzakelijk dat alle GPT-zichtbaarheid of -toegang is geblokkeerd.

Acties zijn niet beschikbaar voor de Pro-modus. Wanneer je een GPT met aangepaste acties maakt of bewerkt, toont de modelkiezer alleen niet-Pro-modellen die acties ondersteunen.

Migratie naar plug-ins

Aangepaste acties worden niet automatisch overgezet wanneer een GPT naar een plug-in wordt gemigreerd. Stel een vervangende integratie in en test deze voordat je op de plug-in vertrouwt. De onderstaande instructies blijven gelden voor bestaande, niet-gemigreerde GPT's die je mag bewerken. Voor hulp bij de migratie, zie: Veelgestelde vragen over het uitfaseren en migreren van aangepaste GPT's.

Een actie maken

Ga in de GPT-editor naar het gedeelte Acties en selecteer Nieuwe actie maken.

Vervolgens stel je in hoe je GPT verbinding maakt met een externe API en deze gebruikt.

Test de actie na het instellen in Voorbeeld om te controleren of deze werkt zoals verwacht.

Authenticatie

Authenticatie bepaalt hoe je GPT verbinding maakt met een externe API.

Beschikbare opties:

• Geen: Geen authenticatie vereist

• API-sleutel: Gebruikt een geheime sleutel om verzoeken te autoriseren

• OAuth: Gebruikt aanmelding door de gebruiker voor accountgebaseerde toegang

API-sleutel

Gebruik API-sleutelverificatie voor server-naar-servertoegang. Deze kan worden geconfigureerd als:

• Basic

• Bearer

• Aangepaste header

OAuth

Gebruik OAuth wanneer acties gebruikersaccounts vereisen. OAuth vereist:

• Client-ID en clientgeheim

• Autorisatie-URL en token-URL

• Scope en methode voor tokenuitwisseling

De editor biedt een callback-URL om de OAuth-flow te voltooien.

Schema

Het schema definieert wat je API kan doen. Het vertelt ChatGPT:

• Welke server moet worden aangeroepen

• Welke endpoints beschikbaar zijn

• Welke parameters ze accepteren

• Hoe elke actie wordt geïdentificeerd (operation ID's)

Het schema moet worden opgegeven als een OpenAPI-specificatie in JSON of YAML.

Een schema toevoegen

Je kunt op drie manieren een schema toevoegen:

• Plak het rechtstreeks in de editor

• Importeer het vanuit een URL

• Begin met een ingebouwd voorbeeld:

  • Weer (JSON)

  • Dierenwinkel (YAML)

  • Lege sjabloon

Als het schema geldig is, toont de editor de gedetecteerde acties. Als het ongeldig is, worden validatiefouten weergegeven.

Werkruimtebeperkingen (Enterprise en Edu)

Als je het bericht ziet:


‘Er zijn geen domeinen toegestaan door de instellingen van je werkruimte.’

Dan betekent dit dat acties worden beperkt door je werkruimte-instellingen.

• Beheerders kunnen alle domeinen toestaan of acties beperken tot goedgekeurde domeinen.

• Als er geen domeinen zijn toegestaan, kun je geen acties gebruiken.

Zie voor bedieningselementen op werkruimteniveau voor acties en domeinbeperkingen: GPT-toegang beheren in Enterprise- en Edu-werkruimten.

Privacy en gebruikersinstellingen

• Elke actie kan een URL voor privacybeleid bevatten.

• Openbare GPT's (link of GPT Store) met acties moeten een geldige URL voor het privacybeleid bevatten.

• Gebruikers kunnen worden gevraagd acties goed te keuren voordat ze worden uitgevoerd.

• Voor OAuth-acties kunnen gebruikers gekoppelde accounts bekijken en beheren.

Aanvullende hulp

Gebruik de officiële ActionsGPT voor hulp bij het schrijven of debuggen van acties.