Resumen

En este artículo se explica cómo configurar acciones en un GPT, incluido cómo conectarse a API externas, definir qué puede hacer el GPT y gestionar la autenticación, los esquemas y las restricciones del área 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 qué puede hacer la API.

Limitaciones

Si tu área 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 de GPT estén bloqueados.

Las acciones no están disponibles en el modo Pro. Cuando creas o editas un GPT con acciones personalizadas, el selector de modelos solo muestra 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 nueva acción.

A continuación, configurarás cómo se conecta tu GPT a una API externa y cómo la usa.

Después de configurar una acción, pruébala en Vista previa para confirmar que se comporta 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

• Ámbito 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 qué puede hacer tu API. 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 (ID de operación)

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

Añadir un esquema

Puedes añadir un esquema de tres formas:

• Pégalo directamente en el editor

• Impórtalo desde una URL

• Empieza 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 área de trabajo (Enterprise y Edu)

Si ves el mensaje:


«La configuración de tu área de trabajo no permite ningún dominio.»

Esto significa que las acciones están restringidas por la configuración de tu área 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 ver controles de acciones y restricciones de dominios en el nivel del área de trabajo, consulta: Gestionar el acceso a GPT en áreas de trabajo Enterprise y Edu.

Privacidad y controles de usuario

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

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

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

• En las acciones con OAuth, los usuarios pueden revisar y gestionar las cuentas conectadas.

Ayuda adicional

Para obtener ayuda al escribir o depurar acciones, usa el ActionsGPT oficial.