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.