Resumen general
Este artículo 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 datos de la API del servicio que quieres conectar, incluida la información de autenticación y un esquema 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 Área de trabajo permite cero dominios 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 a GPT estén bloqueados.
Las acciones no están disponibles en el modo Pro; crear un GPT con acciones personalizadas hará que solo los modelos Instant y Thinking estén disponibles para seleccionarlo.
Crear una acción
En el editor de GPT, ve a la sección Actions y selecciona Create new action.
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 Preview para confirmar que se comporta como esperas.
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 autenticación con clave de API para acceso de servidor a servidor. Se puede configurar como:
Basic
Bearer
Custom header
OAuth
Usa OAuth cuando las acciones requieran cuentas de usuario. OAuth requiere:
Client ID y Client Secret
Authorization URL y Token URL
Scope 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 (ID de operación)
El esquema debe proporcionarse como una especificación OpenAPI en JSON o YAML.
Añadir un esquema
Puedes añadir un esquema de tres formas:
Pegándolo directamente en el editor
Importándolo desde una URL
Empezando desde un ejemplo integrado:
Weather (JSON)
Pet Store (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:
«No domains are allowed by your workspace’s settings.»
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 podrás usar acciones.
Para consultar los controles a nivel de Área de trabajo sobre acciones y restricciones de dominios, consulta: Gestionar el acceso a GPT en Áreas de trabajo Enterprise y Edu.
Privacidad y controles del 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 pida a los usuarios que aprueben las acciones antes de ejecutarlas.
En las acciones con OAuth, los usuarios pueden revisar y gestionar las cuentas conectadas.
Ayuda adicional
Si necesitas ayuda para escribir o depurar acciones, usa el ActionsGPT oficial.