Cómo conectar tu GPT a una API externa

Conectar un GPT personalizado a una API externa te permite extender sus capacidades más allá de la conversación: puede leer datos en tiempo real desde sistemas internos, bases de datos o servicios públicos. Es ideal si trabajas con información que cambia a diario y quieres automatizar consultas repetitivas.

La función que hace posible esta integración se llama acciones, y vive dentro del editor de GPTs personalizados de ChatGPT. A continuación te muestro cómo usarla con un ejemplo real: un asistente que recomienda ropa según el clima.

¿Qué son las acciones en un GPT personalizado?

Las acciones son el puente entre tu GPT y un sistema externo. Funcionan a través de una API o un webhook, que son como enchufes que distintos servicios disponibilizan para que otros sistemas puedan consultar o escribir información.

Con una acción bien configurada, tu GPT deja de depender solo de su conocimiento entrenado y empieza a consumir datos vivos.

¿Qué es una API en este contexto? Es una interfaz que un sistema expone para que otros programas le consulten información o le envíen datos, sin necesidad de entrar manualmente al sistema.

¿Necesito credenciales para conectarme?

Depende del tipo de API. En la sección de autenticación dentro de las acciones tienes tres caminos posibles:

• Ninguno: para APIs públicas, como la de la Dirección Meteorológica de Chile que se usa en el ejemplo.
• API Key: cuando el proveedor te entrega una clave privada de acceso.
• OAuth: cuando necesitas autorización con ID, típico en sistemas internos de empresa por temas de seguridad.

¿Cómo creo el esquema sin saber programar?

Aquí viene la parte interesante. La configuración de la acción pide un esquema, que es un código que le dice al GPT cómo operar la API. Y aunque suena técnico, no necesitas escribirlo a mano.

OpenAI creó un GPT llamado Action GPT justo para esto. Le pegas la documentación de la API que quieres usar y él te devuelve el esquema listo para copiar y pegar.

¿Qué pasos sigo dentro del editor?

El flujo completo, paso a paso, es así:

1. Crea un nuevo GPT desde la sección Explorar y dale un nombre y unas instrucciones claras. En el ejemplo: experto en clima que recomienda ropa según el día.
2. Desactiva las capacidades que no necesites, como búsqueda en la web, lienzo o generación de imágenes, para que solo use la API.
3. Baja hasta la sección acciones y haz clic en agregar acciones.
4. Define la autenticación según corresponda.
5. Abre Action GPT, pega la documentación de la API que vas a usar y envíala.
6. Copia el esquema que te devuelve y pégalo en el campo esquema de tu GPT.
7. Haz clic en prueba para validar que la conexión funciona.

Un detalle clave: la documentación que pegas en Action GPT debe incluir sí o sí la URL del endpoint y el tipo de información que se puede consultar. Sin esos dos datos, el esquema no se genera correctamente.

¿Cómo valido que la conexión funciona?

Después de pegar el esquema, debajo aparece un bloque llamado acciones disponibles. Ahí verás listadas las operaciones que tu GPT puede ejecutar, por ejemplo get clima estaciones. El prefijo get indica que la acción consulta información del sistema externo.

Al presionar prueba, ChatGPT te pedirá permiso la primera vez. Autorizas y, si todo está bien, te devuelve datos reales: en el caso del ejemplo, el clima de distintas ciudades de Chile.

Volviendo a la vista del GPT, basta con escribir algo como estoy en Santiago de Chile, qué me pongo. El asistente se conecta a la API, obtiene que la temperatura es de 22 grados Celsius con nubosidad parcial y humedad baja, y recomienda polera o camisa liviana de manga corta y pantalón de mezclilla o tela liviana.

¿Para qué me sirve esto en el trabajo? Si todos los días entras manualmente a un sistema a copiar datos, una acción puede automatizar esa extracción. También puedes consultar APIs públicas para enriquecer tus análisis sin salir de ChatGPT.

¿Qué necesito para compartir un GPT con acciones?

Aquí hay un punto delicado. Cuando intentas compartir un GPT que se conecta a un servicio externo, ya sea por enlace o en la tienda de GPTs, aparece una advertencia en rojo: las acciones públicas requieren URLs válidas de la política de privacidad.

Esto significa que debes agregar, en la sección de acciones, un enlace a un sitio público con tu política de privacidad. Sin ese enlace, el GPT solo puede usarse de forma privada.

¿Y el perfil de constructor de GPT?

Para publicar en la tienda y que tu nombre aparezca como creador, debes completar tu perfil de constructor. Lo encuentras así:

• Entra a tu cuenta en ChatGPT.
• Ve a configuración y luego a la sección cuenta.
• Debajo de tu plan contratado aparece perfil de constructor de GPT.
• Llena la información de tu empresa, enlaces externos relevantes y correo electrónico.

Con ese perfil grabado puedes publicar abiertamente y compartir tus GPTs de forma pública.

Mi recomendación es ir de menos a más: empieza con proyectos privados, luego sube a GPTs personalizados y, cuando ya domines la lógica, conéctalos a aplicaciones externas mediante acciones. ¿Qué GPT con API te gustaría construir? Cuéntame en los comentarios qué sistema te gustaría conectar primero.