Descripción general

En este artículo se explica cómo configurar acciones en un GPT, incluida la forma de conectarse a API externas, definir qué puede hacer el GPT y administrar la autenticación, los esquemas y las restricciones del Espacio de trabajo.

Para configurar una acción, necesitarás los detalles de la API del servicio al que quieres conectarte, incluida la información de autenticación y un esquema de OpenAPI. Un GPT puede usar aplicaciones o acciones, pero no ambas al mismo tiempo.

Cada acción se define mediante dos componentes principales: cómo se autentica el GPT con la API y un esquema que define lo que puede hacer la API.

Limitaciones

Si tu Espacio de trabajo no permite ningún dominio de acción, las acciones personalizadas de GPT no pueden ejecutarse porque ningún dominio de acción puede superar las comprobaciones de la lista de permitidos. Esto no significa necesariamente que toda la visibilidad o el acceso al GPT estén bloqueados.

Las acciones no están disponibles para el modo Pro. Cuando creas o editas un GPT con acciones personalizadas, el selector de modelos muestra solo los modelos que no son Pro y que admiten acciones.

Crear una acción

En el editor de GPT, ve a la sección Acciones y selecciona Crear acción nueva.

Luego configurarás cómo tu GPT se conecta a una API externa y la usa.

Después de configurar una acción, pruébala en Vista previa para confirmar que se comporte como se espera.

Autenticación

La autenticación controla cómo se conecta tu GPT a una API externa.

Opciones disponibles:

• Ninguna: no se requiere autenticación

• Clave de API: usa una clave secreta para autorizar solicitudes

• OAuth: usa el inicio de sesión del usuario para el acceso basado en cuentas

Clave de API

Usa la autenticación con clave de API para el acceso de servidor a servidor. Se puede configurar como:

• Basic

• Bearer

• Encabezado personalizado

OAuth

Usa OAuth cuando las acciones requieran cuentas de usuario. OAuth requiere:

• ID de cliente y secreto de cliente

• URL de autorización y URL de token

• Alcance y método de intercambio de tokens

El editor proporciona una URL de devolución de llamada para completar el flujo de OAuth.

Esquema

El esquema define lo que puede hacer tu API. Le indica a ChatGPT:

• A qué servidor llamar

• Qué puntos de acceso están disponibles

• Qué parámetros aceptan

• Cómo se identifica cada acción (IDs de operación)

El esquema debe proporcionarse como una especificación de OpenAPI en JSON o YAML.

Agregar un esquema

Puedes agregar un esquema de tres maneras:

• Pégalo directamente en el editor

• Impórtalo desde una URL

• Comienza con un ejemplo integrado:

  • Clima (JSON)

  • Tienda de mascotas (YAML)

  • Plantilla en blanco

Si el esquema es válido, el editor muestra las acciones detectadas. Si no es válido, se muestran errores de validación.

Restricciones del Espacio de trabajo (Enterprise y Edu)

Si ves el mensaje:


“La configuración de tu Espacio de trabajo no permite ningún dominio.”

Esto significa que las acciones están restringidas por la configuración de tu Espacio de trabajo.

• Los administradores pueden permitir todos los dominios o restringir las acciones a dominios aprobados.

• Si no se permite ningún dominio, no puedes usar acciones.

Para conocer los controles de acciones y restricciones de dominio a nivel del Espacio de trabajo, consulta: Administrar el acceso a GPT en Espacios de trabajo Enterprise y Edu.

Privacidad y controles de usuario

• Cada acción puede incluir una URL de Política de privacidad.

• Los GPT públicos (enlace o GPT Store) con acciones deben incluir una URL válida de política de privacidad.

• Es posible que se les pida a los usuarios aprobar las acciones antes de que se ejecuten.

• Para las acciones de OAuth, los usuarios pueden revisar y administrar las cuentas conectadas.

Ayuda adicional

Para obtener ayuda con la escritura o depuración de acciones, usa el ActionsGPT oficial.