Cómo construir una GPT personalizada de OpenAI con una API de terceros

Con la aparición de Large Language Models (LLM), la interfaz de usuario conversacional ha become muy popular. Simplemente pregunta lo que estás buscando y ChatGPT produce una salida. Además, el modelo puede realizar acciones en respuesta a tu comando o pregunta y te presenta el resultado. Esto abrió una gran oportunidad para construir una nueva clase de interfaz donde la única entrada son las palabras del usuario — escritas o dichas.

Esto es fantástico, ya que puedes imaginar las posibilidades infinitas. Lo que necesitamos es que los LLM tengan acceso a tantas acciones complejas y reales del mundo como sea posible, que luego puedan invocar apropiadamente. Aquí es donde entran en juego las API de terceros.

APIs de plataforma

Elige cualquier popular servicio de Internet y imagina una API para él que pueda ser invocada para realizar las tareas usualmente realizadas por ese servicio. Cada servicio usualmente proporciona una hermosa interfaz de usuario gráfico (GUI) — ya sea como una aplicación web o móvil — y los usuarios inician sesión para utilizarla. Pero en su lugar, ¿y si el usuario solo tiene que pedir a una sola entidad — la interfaz de comando de LLM — a través de comandos de texto o audio? No tendrías necesidad de ninguna otra interfaz.

Es interesante porque ahora puedes construir una versión personalizada de GPT que sepa cómo realizar ciertas acciones extremadamente bien, convirtiéndose en un especialista al ser consciente de la existencia de tales acciones. Conecta la intención del usuario con la acción deseada y comparte los resultados (salida) de la acción realizada.

Especificación YAML OpenAPI

En el caso de Custom GPT, esto se logra registrando cualquier API de terceros usando su especificación OpenAPI. Por ejemplo, aquí está una especificación OpenAPI de una plataforma para diseño interior con AI. La API permite crear un nuevo diseño interior utilizando solo una foto de la habitación. Aunque la plataforma ofrece su propia aplicación web donde los usuarios pueden subir la foto de la habitación y seleccionar estilos de diseño interior para generar un nuevo diseño interior, puedes traer esta funcionalidad a tu plataforma deployándola como un Custom GPT.

Vamos a crear un Custom GPT con esta API como ejemplo. Puedes abordar cualquier API de tercero con su Especificación OpenAPI. También hay herramientas disponibles que le ayudarán a construir una Especificación OpenAPI para tus propias API de plataforma. Creo que es una gran manera de distribuir tu propia API a plataformas más amplias.

Obtén la API de la Plataforma

La mayoría de las plataformas de SaaS ofrecen su API para que los desarrolladores puedan construir sus aplicaciones. También publican una especificación OpenAPI. Descarga la especificación. Es un archivo YAML que se parece a esto:

openapi: 3.1.0
info:
  title: Decor8AI Virtual Staging & Interior Design API
  version: "1.0"
  description: >
    Decor8 AI is a state-of-the-art virtual staging solution designed for realtors and real estate app developers. It provides a suite of customization options to create and visualize appealing interiors from empty spaces. With its focus on enhancing marketability, it's an essential tool for showcasing property potential in a compelling way.
    Please reach out to [Decor8 AI Team](mailto:[email protected]) with questions or suggestions.

    Additional license information can be found [here](https://github.com/immex-tech/decor8ai-sdk/blob/main/API_LICENSE_NOTICE).

    ### Empezando

    - **Authentication**: Each API request requires two headers:
      - `Content-Type: application/json`
      - `Authorization: Bearer `

    - **API Key**: Get your `` from your account at [prod-app.decor8.ai](https://prod-app.decor8.ai).
  
    ### Inicia sesión en [Decor8 AI](https://prod-app.decor8.ai) y hace clic en APIs en el menú lateral izquierdo

    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_1.jpg?raw=true)

    ### Hace clic en Generar Clave API
    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_2.jpg?raw=true)

    ### Prueba la Clave AI 
    Once you have the key, run simple curl command to test the key.

    ```
    curl -X GET "https://api.decor8.ai/speak_friend_and_enter" -H "Authorization: Bearer "
    ``` 

  license:
    name: Decor8AI SDK License
    url: https://github.com/immex-tech/decor8ai-sdk/blob/main/LICENSE
servers:
  - url: https://api.decor8.ai
    description: Base API URL for all endpoints.

Nota: Esto no es una especificación OpenAPI completa, sino solo unas líneas del archivo para que tengas una idea.

Open AI Custom GPT

Necesitas una suscripción a Open AI para crear un Custom GPT. Dirígete a https://chat.openai.com/ y haz clic en tu foto de perfil en la esquina superior derecha de la página.

Haz clic en el menú “My GPTs”. Aquí, vamos a crear un nuevo Custom GPT (ya había creado uno, por lo que lo ves en esta página).

Haz clic en “Create a GPT”. Se te presentará un formulario para definir las propiedades de este Custom GPT.

Haz clic en la pestaña “Configure”.

Proporciona el Logo, Nombre, Descripción e instrucciones iniciales.

En las instrucciones, es importante definir reglas básicas. Por ejemplo, querrás definir qué debe hacer GPT cuando los usuarios hagan preguntas fuera de su área de expertise. GPT podría decir “No lo sé” o informar al usuario sobre lo que puede hacer por ellos. Esto es muy útil para establecer expectativas correctas en los usuarios.

Desplázate hacia abajo en la sección “Actions”.

Una acción es cómo GPT sabrá “qué invocar” cuando se cumplan ciertas condiciones. Cada una de las llamadas API podría convertirse en una acción. Aquí es donde necesitaremos el archivo YAML de la especificación OpenAPI que descargamos anteriormente.

• Autenticación: Elige API Key

• Elige Tipo de Autenticación: Bearer

Obtén la API Key

Típicamente, cada API de plataforma proporciona un método de autenticación que implica el uso de una clave API. Obtén la clave iniciando sesión en esa plataforma. Por ejemplo, en el caso de Decor8 AI, inicia sesión en https://prod-app.decor8.ai y hace clic en el menú de API. Aquí puedes crear una clave API. Copia y pega la clave en el cuadro de diálogo Autenticación. 

Siguiente, copia y pega el contenido del archivo YAML de la especificación OpenAPI debajo del cuadro de texto “Esquema”.

Si la especificación está bien formateada, verás una lista de las llamadas de API descritas en la especificación. Ahora puedes probarlas individualmente. Si haces clic en el botón “Probar”, intentará invocar la API con los parámetros de entrada correctos como se describe en la especificación. Si necesita obtener el valor del parámetro de entrada, te pedirá.

En el caso de la API de Decor8 AI, vamos a probar la API “checkAuthentication” (que no es necesaria para la GPT en sí misma). Su invocación exitosa significa que todo ha sido configurado correctamente entre Custom GPT y la plataforma de destino (Decor8 AI, en este caso).

Puedes probar las APIs restantes una por una para asegurarte de que GPT ha entendido correctamente las acciones. Lo que verificarás es si GPT te pide información adicional si no se proporcionó cuando realiza la acción. Esta es la parte más interesante de Custom GPT: “sabe” cómo llamar a la API y construir los parámetros de entrada según la especificación, y si faltan algúnos inputs, te pregunta. Esta es la apariencia de la interfaz de usuario conversacional:

Aquí, le pedí que diseñara un interior de habitación con un estilo de diseño de granja. Esto es para invocar una de las llamadas de API que, dada una foto de una habitación, el tipo de habitación y el estilo de diseño, puede generar un nuevo diseño interior y devolver una imagen.

Aquí está la imagen original de una habitación vacía (desde la URL mencionada en la captura de pantalla anterior):

Si hago clic en “Ver Diseño de habitación de granja”, vemos:

Ahora, puedes probar otras API para asegurarte de que todo funciona como esperas.

Crear y publicar la GPT personalizada

Asegúrate de revisar todas las propiedades para esta GPT personalizada. Aquí hay un ejemplo de diversas propiedades de configuración que establecí para mi GPT personalizada y creo que está lista para ser publicada.

Haz clic en el botón ” Crear ” o ” Actualizar ” en la esquina superior derecha y tu GPT se publica en Internet.

Por ejemplo, mi GPT personalizada ahora está en vivo. (Necesitas iniciar sesión en OpenAI para acceder.)

¡Acabando!

Construir una GPT personalizada con una API de tercero, como Decor8 AI, es bastante directo. Puedes construir tu GPT y agregar las mejores plataformas disponibles. Esto hará que tu GPT sea un chatbot avanzado y sofisticado que puede hacer muchas actividades útiles.

Espero que haya disfrutado de este tutorial, si tiene alguna pregunta o comentario, deje que en la sección de comentarios.