Conecta tu GPT a APIs externas
En esta página
Estado a 5 de noviembre de 2026: los GPTs están en sus últimas semanas. OpenAI retirará los GPTs personalizados el 11 de diciembre de 2026 (el 11 de febrero de 2027 para ciertos espacios de trabajo Enterprise con una exención). Las cuentas Personal, Free, Go, Plus y Pro ya no pueden crear ni publicar nuevos GPTs; en los espacios de trabajo Business, Enterprise y Edu, la creación depende de la configuración y cesó el 26 de octubre de 2026 en los espacios Enterprise afectados. Los GPTs existentes siguen siendo utilizables y editables si tu plan lo permite hasta su retirada; tus conversaciones con ellos seguirán siendo accesibles después. La migración (Migrate to plugin, en My GPTs) convierte las instrucciones en una habilidad (skill), la base de conocimientos en archivos de referencia y las aplicaciones conectadas en aplicaciones; las acciones personalizadas no se transfieren. Esta lección explica cómo funcionan los GPTs para ayudarte a mantenerlos, migrarlos y adaptar sus principios a un plugin (lecciones 15–17).
Más allá del GPT aislado
Hasta ahora, tu GPT ha operado en un silo: sus instrucciones definen su comportamiento y su base de conocimientos (Knowledge) proporciona tus documentos. Esto es potente, pero sigue estando desconectado del mundo en tiempo real. No puede consultar tu CRM al instante, crear un evento en el calendario ni interrogar tu base de datos; solo sabe lo que has subido, congelado en el momento de la carga. Las acciones eliminan este límite: permiten que tu GPT llame a APIs externas para leer y escribir datos en tus herramientas durante una conversación.
¿Qué es una acción?
Una acción es una conexión entre tu GPT y un servicio externo a través de su API. El flujo es siempre el mismo: el usuario hace una pregunta o da una instrucción, el GPT identifica que necesita datos externos para responder, llama a la API del servicio, recibe la respuesta y la integra en su respuesta final. Piensa en un GPT de ventas conectado a un CRM: cuando un usuario pregunta «¿Cuál es el estado del expediente Dupont?», el GPT consulta la API del CRM, recupera el registro del cliente y responde con los datos de hoy, no con el recuerdo de un archivo subido hace tres meses. Todo esto ocurre de forma transparente para el usuario, que simplemente tiene la sensación de hablar con un asistente bien informado.
El esquema OpenAPI
Para que el GPT pueda llamar a una API, debes describirla. Esa es la función del esquema OpenAPI (anteriormente Swagger), un archivo JSON o YAML que sirve como manual de instrucciones de la API. Describe los endpoints (las URL que tu GPT puede llamar), los métodos asociados (GET para leer, POST para crear, PUT para actualizar, DELETE para eliminar), los parámetros que espera cada endpoint y el formato de las respuestas devueltas. Basándose en este documento, el GPT decide por sí mismo, durante la conversación, qué endpoint llamar y con qué parámetros.
Así es como se ve un esquema mínimo para una API meteorológica ficticia:
openapi: 3.1.0
info:
title: Weather API
version: 1.0.0
servers:
- url: https://example.com
paths:
/forecast:
get:
operationId: getForecast
summary: Get weather forecast for a city
parameters:
- name: city
in: query
required: true
schema:
type: string
responses:
"200":
description: Weather forecast
Buena noticia: casi nunca tendrás que escribir este archivo desde cero. Muchos servicios publican su esquema OpenAPI directamente en su documentación de API. Si no es así, herramientas como Swagger Editor, o el propio ChatGPT si le describes la API, pueden generarlo. Y si tu equipo técnico trabaja con Postman, sus colecciones se exportan en formato OpenAPI.
Configuración de una acción en el editor de GPT
La configuración se realiza en tu editor de GPT en la web: ve a la sección Actions, haz clic en Create new action, pega tu esquema OpenAPI en el campo proporcionado, configura la autenticación (tratada en la siguiente lección) y prueba la acción desde el panel de vista previa.
La calidad de tu esquema determina la calidad de las llamadas. Ten presentes tres hábitos. Primero, asigna nombres explícitos a los valores de operationId: el GPT se basa en ellos para decidir qué acción llamar, y getForecast lo guía mucho mejor que op_42. A continuación, escribe descripciones claras para cada endpoint y parámetro, en lenguaje natural, como si le explicaras la API a un colega. Por último, expón solo los endpoints que realmente necesitas: si tu GPT solo requiere dos o tres rutas, no expongas las cuarenta rutas de la API completa. Cada endpoint expuesto ocupa espacio en el contexto del GPT y aumenta el riesgo de que elija el incorrecto.
Tu turno: una API pública
Tu primera acción, o su planificación. El mejor campo de entrenamiento es una API pública y gratuita (meteorología, tipos de cambio, noticias) que no requiera una autenticación compleja. Elige una, recupera o crea su esquema OpenAPI y añádela como una acción en tu GPT. No olvides vincular la acción a tus instrucciones especificando cuándo usarla: «Cuando el usuario pregunte por el tiempo, usa la acción getForecast». Luego, prueba con varias formulaciones diferentes para verificar que el GPT activa la llamada en el momento adecuado.
Algunas trampas esperan a los primeros intentos. Un esquema mal formado (una sola coma faltante en el JSON) lo bloquea todo: valida siempre tu esquema en Swagger Editor antes de pegarlo. La falta de descripciones deja al GPT ciego: sin ellas, no sabe cuándo es relevante una acción. Planifica también los errores de la API, que tarde o temprano ocurrirán: especifica el comportamiento en tus instrucciones, por ejemplo, «Si la API no responde, dile al usuario que lo intente más tarde»; de lo contrario, el GPT improvisará, a veces inventando datos. Y no confíes únicamente en el panel de vista previa: prueba en condiciones reales, con datos reales y formulaciones reales de usuarios.
Conoce dos límites antes de empezar: un GPT utiliza aplicaciones conectadas o acciones, no ambas, y las acciones no funcionan en modo Pro. Lo más importante es que las acciones personalizadas no se transfieren a un plugin durante la migración: comprueba primero si el directorio de plugins ya ofrece una aplicación para tu servicio de destino; si no es así, tendrás que reconstruir la integración, por ejemplo, con un servidor MCP.
Fuentes oficiales: Configuring actions in GPTs (Centro de ayuda de OpenAI: autenticación, esquema OpenAPI, pruebas, límites) · Custom GPT retirement and migration FAQ (las acciones no se transfieren) · OpenAPI Specification (formato del esquema)
Puntos clave
- Las acciones conectan tu GPT a servicios externos a través de sus APIs
- Debes proporcionar un esquema OpenAPI que describa los endpoints disponibles
- Las descripciones en el esquema son esenciales: el GPT las usa para decidir qué acción llamar
- Empieza con una API pública gratuita para familiarizarte con el proceso
- Limita los endpoints expuestos al mínimo estricto necesario para tu caso de uso