Cómo conectar APIs externas a un Custom GPT con GPT Actions y OpenAPI
Cómo conectar APIs externas a un Custom GPT con GPT Actions y OpenAPI
Aprende a conectar APIs externas a un Custom GPT usando GPT Actions y esquemas OpenAPI para crear asistentes capaces de ejecutar tareas y consultar datos en tiempo real.
Aprender a conectar API a Custom GPT es el paso definitivo para transformar a ChatGPT de un modelo conversacional tradicional a un asistente operativo capaz de interactuar con plataformas externas, recuperar información en tiempo real y ejecutar acciones en tus herramientas habituales.
Claves esenciales de las GPT Actions
- Tecnología subyacente: Funcionan mediante la capacidad de Function Calling de OpenAI para traducir lenguaje natural en peticiones estructuradas.
- Estándar requerido: Utilizan la especificación OpenAPI (v3.0 o v3.1) en formato YAML o JSON.
- 3 esquemas de autenticación: Compatibilidad con accesos anónimos (None), claves globales (API Key) y credenciales individuales por usuario (OAuth 2.0).
- Operaciones HTTP: Ejecución de llamadas REST mediante verbos estándar como GET, POST, PUT y DELETE.
¿Qué son las GPT Actions y cómo funcionan?
Las GPT Actions representan el puente técnico entre el procesamiento de lenguaje natural de OpenAI y el software externo. A través de este mecanismo, el modelo no se limita únicamente al conocimiento con el que fue entrenado o a los archivos que subes como contexto; adquiere la capacidad de invocar endpoints REST para enviar y recibir datos en vivo.
La arquitectura operativa se basa en el sistema de OpenAI Function Calling Actions. Cuando un usuario interactúa con el Custom GPT, el modelo analiza si la petición requiere consultar o modificar un servicio externo. Si es necesario, genera automáticamente una carga útil (payload en JSON) adaptada al esquema técnico que configuraste y ejecuta la solicitud HTTP correspondiente.
Métodos de autenticación soportados (None, API Key, OAuth 2.0)
Verbos HTTP estándar integrables (GET, POST, PUT, DELETE)
Versiones del estándar OpenAPI requeridas para los esquemas
Anatomía de un esquema OpenAPI para Custom GPTs
Para que el modelo comprenda cuándo y cómo comunicarse con un servicio externo, necesita una definición estructurada. Esta definición se entrega en un OpenAPI esquema Custom GPT, redactado en YAML o JSON, que describe con precisión los componentes del servicio.
Un esquema funcional debe contener las siguientes secciones esenciales:
- info: Nombre de la API, versión y una descripción general de su propósito.
- servers: La URL base del servidor donde se alojan los endpoints.
- paths: Las rutas individuales a las que el GPT puede enviar solicitudes, especificando el método HTTP (GET, POST, etc.).
- parameters y schema: Variables que espera el endpoint (como IDs, filtros o fechas), definiendo su tipo de dato (string, integer, etc.).
- operationId: Un identificador único y descriptivo para cada función.
Métodos de autenticación: ¿Cuál elegir para tu GPT?
OpenAI ofrece tres modalidades para gestionar el acceso seguro a los servicios web:
| Método | Mecanismo técnico | Caso de uso ideal |
|---|---|---|
| None | Sin credenciales requeridas. | APIs públicas de consulta libre (clima, tipos de cambio abiertos, datos gubernamentales). |
| API Key | Bearer token, Basic o Custom Header configurado por el creador. | Servicios donde el creador comparte una clave global para todos los usuarios del GPT. |
| OAuth 2.0 | Client ID, Client Secret, Auth URL, Token URL y Callback URL única. | Aplicaciones donde cada usuario debe acceder a sus propios datos privados (cuentas personales). |
Tutorial paso a paso: Cómo conectar una API a tu Custom GPT
Sigue este proceso estructurado para integrar y probar tu primera acción:
Antes de configurar el asistente, comprueba la respuesta de la API externa en una herramienta como Postman para confirmar que los parámetros y formatos JSON funcionan correctamente.
Accede a ChatGPT (requiere plan Plus, Team o Enterprise), ve a Explore GPTs, crea un nuevo GPT o edita uno existente y dirígete a la pestaña Configure.
Desplázate hasta la sección inferior y haz clic en Create new action para acceder al editor del esquema.
Pega tu especificación OpenAPI (v3.0/v3.1) en formato YAML o JSON asegurándote de incluir operationIds únicos y descripciones detalladas.
Selecciona None, API Key u OAuth según tu API. Si usas OAuth, copia la Callback URL generada por ChatGPT y regístrala en la consola de tu proveedor.
Escribe una instrucción natural en el chat de prueba para que el GPT dispare la acción y verifica la carga enviada y la respuesta recibida.
Buenas prácticas para instrucciones y control de contexto
La configuración del esquema técnico es solo una parte de la ecuación; la sección Instructions del GPT define el comportamiento del modelo frente a los datos obtenidos.
Reglas recomendadas para el prompt del sistema
- Establece cuándo actuar: Especifica con precisión qué intenciones del usuario deben activar la llamada a la API y cuáles deben responderse solo con conocimiento general.
- Gestión de errores: Instruye al GPT para que informe de manera clara y amigable si la API devuelve un código de estado de error (como 404 o 500).
- Confirmación de acciones destructivas: Si integras endpoints con métodos POST, PUT o DELETE, exige al GPT solicitar confirmación explícita al usuario antes de ejecutar la llamada.
Limitaciones técnicas a tener en cuenta
Al diseñar tus GPT Actions, considera estas restricciones operativas documentadas por OpenAI:
- Suscripción requerida: La creación y uso de Custom GPTs con Actions requiere planes activos ChatGPT Plus, Team o Enterprise.
- Tamaño de respuesta: Las respuestas devueltas por tu servidor no deben ser masivas, ya que pueden saturar la ventana de contexto del modelo. Es recomendable estructurar la API para entregar respuestas paginadas o filtradas.
- Alcance de las claves estáticas: La autenticación por API Key es global. Si cada usuario debe interactuar con su propia cuenta privada, es obligatorio implementar OAuth Custom GPT o un middleware intermediario.
Checklist final antes de publicar tu Action
- ¿El esquema utiliza OpenAPI 3.0 o 3.1 válido?
- ¿Cada endpoint tiene un
operationIdúnico y descriptivo? - ¿Los parámetros tienen descripciones claras para que el modelo sepa qué enviar?
- ¿Se evitó duplicar cabeceras de autorización en el esquema al usar API Key?
- ¿En OAuth se configuró la Callback URL exacta provista por ChatGPT (
https://chatgpt.com/aip/{g-ID}/oauth/callback)? - ¿Se probó el endpoint en el panel de Preview comprobando el envío y recepción de JSON?
Conclusión práctica: Conectar una API externa a un Custom GPT permite transformar modelos conversacionales pasivos en agentes funcionales. El éxito de la integración reside en la claridad de las descripciones del esquema OpenAPI, la correcta elección del método de autenticación y una definición precisa de instrucciones para el control de errores.
🚀 ¿Quieres estar siempre actualizado en IA?
Únete a nuestra comunidad donde compartimos noticias, herramientas, guías y oportunidades sobre inteligencia artificial.
Preguntas frecuentes
¿Cómo ven los usuarios finales el acceso cuando se usa OAuth 2.0?
Cuando un endpoint requiere OAuth, ChatGPT muestra un botón interactivo ‘Sign in with…’ en la conversación. El usuario inicia sesión en el proveedor externo y su token individual queda vinculado a su sesión.
¿Puedo utilizar formatos JSON y YAML indistintamente para el esquema?
Sí, el editor de GPT Actions admite esquemas OpenAPI estructurados tanto en formato YAML como en JSON, siempre que cumplan con la especificación OpenAPI 3.0 o 3.1.
Fuentes consultadas
🔥 Sigue Eduky Blog para más contenido sobre IA
Noticias, herramientas, automatizaciones y guías prácticas para mantenerte siempre al día.
Publicar comentario