Visió general
Aquest article explica com configurar accions en un GPT, incloent-hi com connectar-se a API externes, definir què pot fer el GPT i gestionar l’autenticació, els esquemes i les restriccions de l’espai de treball.
Per configurar una acció, necessitaràs els detalls de l’API del servei al qual et vols connectar, inclosa la informació d’autenticació i un esquema OpenAPI. Un GPT pot utilitzar aplicacions o accions, però no totes dues alhora.
Cada acció es defineix amb dos components principals: com s’autentica el GPT amb l’API i un esquema que defineix què pot fer l’API.
Limitacions
Si el teu espai de treball no permet cap domini d’acció, les accions personalitzades de GPT no es poden executar perquè cap domini d’acció pot superar les comprovacions de la llista de permesos. Això no vol dir necessàriament que tota la visibilitat o l’accés als GPT estigui bloquejat.
Les accions no estan disponibles per al mode Pro. Quan crees o edites un GPT amb accions personalitzades, el selector de models només mostra models no Pro que admeten accions.
Crear una acció
A l’editor de GPT, ves a la secció Accions i selecciona Crea una acció nova.
A continuació, configuraràs com el teu GPT es connecta a una API externa i la utilitza.
Després de configurar una acció, prova-la a Previsualització per confirmar que es comporta com s’esperava.
Autenticació
L’autenticació controla com es connecta el teu GPT a una API externa.
Opcions disponibles:
Cap: No cal autenticació
Clau d’API: Fa servir una clau secreta per autoritzar sol·licituds
OAuth: Fa servir l’inici de sessió de l’usuari per a l’accés basat en comptes
Clau d’API
Fes servir l’autenticació amb clau d’API per a l’accés de servidor a servidor. Es pot configurar com a:
Bàsic
Portador
Capçalera personalitzada
OAuth
Fes servir OAuth quan les accions requereixin comptes d’usuari. OAuth requereix:
ID de client i secret de client
URL d’autorització i URL del testimoni
Abast i mètode d’intercanvi de testimonis
L’editor proporciona un URL de retorn de trucada per completar el flux d’OAuth.
Esquema
L’esquema defineix què pot fer la teva API. Indica a ChatGPT:
A quin servidor ha de cridar
Quins punts finals hi ha disponibles
Quins paràmetres accepten
Com s’identifica cada acció (identificadors d’operació)
L’esquema s’ha de proporcionar com una especificació OpenAPI en JSON o YAML.
Afegir un esquema
Pots afegir un esquema de tres maneres:
Enganxa’l directament a l’editor
Importa’l des d’un URL
Comença a partir d’un exemple integrat:
Temps (JSON)
Botiga d’animals (YAML)
Plantilla en blanc
Si l’esquema és vàlid, l’editor mostra les accions detectades. Si no és vàlid, es mostren els errors de validació.
Restriccions de l’espai de treball (Enterprise i Edu)
Si veus el missatge:
«La configuració del teu espai de treball no permet cap domini.»
Això vol dir que les accions estan restringides per la configuració del teu espai de treball.
Els administradors poden permetre tots els dominis o restringir les accions als dominis aprovats.
Si no es permet cap domini, no pots utilitzar accions.
Per als controls a nivell d’espai de treball sobre accions i restriccions de domini, consulta: Gestionar l’accés als GPT en espais de treball Enterprise i Edu.
Privacitat i controls d’usuari
Cada acció pot incloure un URL de política de privacitat.
Els GPT públics (enllaç o GPT Store) amb accions han d’incloure un URL de política de privacitat vàlid.
És possible que es demani als usuaris que aprovin les accions abans que s’executin.
Per a les accions OAuth, els usuaris poden revisar i gestionar els comptes connectats.
Ajuda addicional
Per obtenir ajuda per escriure o depurar accions, fes servir l’ActionsGPT oficial.