Icono del sitio imacreste.com

Tutorial OpenAI Assistants API

Iñigo Mezo Alvarez

API Assistants de OpenAI es una herramienta que facilita la comunicación directa con GPT, el modelo de lenguaje que impulsa ChatGPT, pero ofreciendo un control más preciso.

La API de OpenAI se ha convertido en una herramienta valiosa para desarrolladores y empresas que buscan crear desde chatbots que se adaptan a cada usuario hasta asistentes virtuales que gestionan tareas complejas o sistemas que automatizan análisis y generación de contenido de forma efectiva.

En este tutorial te guiaré paso a paso para entender cómo funciona la API de OpenAI Assistants y cómo puedes aprovechar su potencial para crear asistentes que se adapten a tus necesidades específicas. Y en último lugar te enseñaré como usarlo en automatizaciones con Make.com.

Llevo desde principios del 2023 asesorando a empresas y autónomos en la implantación de inteligencia artificial, si tienes dudas contactame.

Configuración de la cuenta de OpenAI

Para acceder a la API de OpenAI, lo primero que debemos hacer es registrarnos en su plataforma. Es importante tener en cuenta que OpenAI experimenta cambios constantes. Esta información está actualizada hasta septiembre de 2024, proporcionando una base fundamental para comprender su funcionamiento.

  1. Creación de la cuenta: Dirígete al sitio oficial de OpenAI y regístrate desde «Products», «API login». Asegúrate de completar la verificación y cualquier detalle adicional que la plataforma solicite para habilitar el acceso a la API.
  2. Generación de claves API:
    • Desde el panel de OpenAI, busca la sección de claves API (API keys) en «Dashboard» y selecciona “Crear nueva clave secreta”. Copia esta clave en un lugar seguro; será necesaria para cada solicitud que realices a la API.
    • Configuración de seguridad: La clave API es sensible, así que se recomienda almacenarla en variables de entorno para evitar su exposición en el código. En Python, puedes usar el paquete dotenv para manejar estas variables.
  3. Acceso a la documentación de la API: Familiarízate con la documentación oficial de OpenAI. Aquí podrás encontrar detalles sobre las distintas funcionalidades y configuraciones posibles que te permitirán personalizar aún más tu asistente.
  4. Configuración (Settings): En esta sección encontramos todas las opciones para personalizar nuestro entorno de trabajo.
    • Perfil: Aquí podemos actualizar nuestro nombre, correo electrónico y número de teléfono
    • Seguridad: Es fundamental activar la autenticación de doble factor (2FA) en esta sección para proteger nuestra cuenta.
    • Organización: Encontraremos información sobre nuestra organización y su ID, un dato clave para la conexión con Make. También podemos activar la opción “Visible to organization owners” en “Features and capabilities” para gestionar los “Threads”, que son los historiales de conversación con el modelo.
    • Miembros: Permite agregar colaboradores a nuestra organización para trabajar en proyectos conjuntos.
    • Facturación: Nos ofrece la posibilidad de administrar métodos de pago y revisar el historial de facturas.
    • Límites: OpenAI establece límites de uso para asegurar un acceso equitativo a la plataforma. En la cuenta gratuita, el límite de solicitudes por minuto (RPM) es bastante bajo, pero al añadir un saldo inicial de $5, este límite aumenta significativamente.
    • Verificaciones: OpenAI podría solicitar documentación adicional para verificar nuestra identidad y prevenir usos fraudulentos.
    • Proyecto: En esta sección, podemos crear distintos proyectos.
  5. Dashboard: Es la interfaz desde donde crearemos nuestros asistentes personalizados.
  6. Playground: Nos permite probar nuestros Assistants y el chat de GPT de manera interactiva. En esta sección, podemos experimentar con diferentes entradas, ajustar los parámetros de temperatura, Top P y el número máximo de tokens, y observar el comportamiento de los modelos en tiempo real.

Dos maneras de usar API Assistants

No-Code: Interfaz OpenAI + Make

En la plataforma de OpenAI podemos crear asistentes a través del “creador de asistentes” y luego utilizarlos en Make, sin necesidad de conocimientos de programación.

Desarrollo a medida con API Assistants

El desarrollo a medida con API Assistants permite crear soluciones personalizadas que integran la API de OpenAI para automatizar tareas y mejorar la interacción en diversas aplicaciones. En nuestro caso lo haremos usaremos Python para el desarrollo.

No-Code: Interfaz OpenAI + Make

En la pestaña “Dashboard” encontraremos información general sobre nuestro uso de la API, así como las herramientas para crear y gestionar nuestros Assistants.

Desde la sección «Assistants» podremos crear, configurar y probar nuestros Assistants. Cada Assistant contará con las siguientes características:

Ejemplo de uso

Vamos a desarrollar un asistente virtual para una empresa dedicada a la creación de páginas web.

Utilizaremos ChatGPT 4.0 como base para este proyecto. En este caso, el asistente se llamará «Diseño Web Imacreste» y su función principal será orientar a los nuevos clientes en el proceso de selección de los servicios que ofrece la empresa.

Primero, crearemos un nuevo proyecto en OpenAI. Para eso, vamos a la parte superior izquierda, al lado del nombre de nuestra organización, donde se encuentra el «Default Project». Hacemos clic y seleccionamos «Create Project».

En el formulario, se nos pedirán algunos datos:

Human friendly name: Nombre del proyecto. Lo llamaremos «Empresa Imacreste».

Project name: Describe tu proyecto o caso de uso. Pondremos «Servicios de la empresa imacreste».

URL: URL de tu sitio web o red social.

En segundo lugar hacemos clic en «Create» para crear el proyecto.

Y en tercer lugar haremos pruebas en el Playground.

Integración con Make.com

La integración de la API de OpenAI con Make.com permite automatizar tareas y gestionar respuestas del asistente en flujos de trabajo específicos.

A continuación, te guiaré en los pasos clave para realizar esta integración y aprovecharla para distintas automatizaciones.

  1. Crear un nuevo escenario:
    Inicia sesión en Make.com y crea un nuevo escenario. Los escenarios en Make.com representan flujos de trabajo automatizados que se pueden activar mediante diversas condiciones.
  2. Creación de un módulo cómo trigger
    Por ejemplo crea un webhook de Mailhook. Los emails que lleguen a ese correo pasaran por nuestro asistente de OpenAI.
  3. Alta módulo OpenAI – Message an Assistant
    Con este módulo nos conectaremos con el asistente vía Make.
    • Creamos la conexión con OpenAI: Añadimos el nombre, en Generar API Key necesitaremos una API Key. La generaremos desde «API Keys» y la pegamos en «API Key» en Make.
    • Copiar y pegar Organization ID en Make: Lo encontraremos en la plataforma de OpenAI en la sección de «Organization settings».
    • Guardamos, y seleccionamos el asistente en «Assistant».
    • Elegimos como mensaje el que viene del email.
  4. Creación de un módulo de Google Sheets
    Podemos usar Google Sheets para guardar el contenido del email y la respuesta del asistente, para saber más consultar mi manual sobre Make.com.

Desarrollo con API Assistants : Configuración inicial

Para comenzar a trabajar con la API de OpenAI y desarrollar programando asistentes personalizados, es esencial tener en cuenta ciertos requisitos y realizar una configuración básica que garantice un entorno de desarrollo estable y seguro.

Requisitos previos

  1. Conocimientos básicos: Tener experiencia con conceptos de programación es útil, especialmente en lenguajes como Python. También es conveniente tener familiaridad con las plataformas de automatización, como Make.com, para sacarle el máximo provecho a las capacidades de integración.
  2. Herramientas necesarias:
    • Cuenta de OpenAI: Una cuenta activa en OpenAI es esencial para obtener las claves API.
    • Python: Instalar la última versión es recomendado.
    • Entorno de desarrollo: Un entorno como VSCode o cualquier editor de texto que permita ejecutar scripts será suficiente para este tutorial.

Conexión básica con la API

Ahora que tienes tu cuenta de OpenAI configurada y tu clave API lista, es momento de realizar una conexión básica. Este paso es fundamental para verificar que el entorno de desarrollo está configurado correctamente y que la API puede responder a tus solicitudes.

Configuración en el entorno de desarrollo

  1. Instalación de Librerías Necesarias:
    • Para Python, necesitas instalar la librería openai, que facilita la comunicación con la API. Puedes instalarla usando el siguiente comando en tu terminal:
      pip install openai
    • Asegúrate de tener tus variables de entorno configuradas (si estás usando .env), de modo que la clave API esté protegida y no se incluya directamente en el código.
  2. Cargar la Clave API:
    • En Python, carga la clave API desde una variable de entorno para que esté disponible en tu script:
# Importar las bibliotecas necesarias
import openai
import os
from dotenv import load_dotenv

# Cargar la clave API desde el archivo .env
load_dotenv()
openai.api_key = os.getenv("OPENAI_API_KEY")

Prueba de conexión

Para confirmar que todo está funcionando, realiza una solicitud de prueba a la API. Este ejemplo básico consulta un modelo de lenguaje en OpenAI y devuelve una respuesta.

response = openai.Completion.create(
    engine="gpt-3.5-turbo-0125",
    prompt="¿Qué es la IA?.",
    max_tokens=150
)

print(response.choices[0].text.strip())

Creación de un asistente personalizado

Con la conexión a la API configurada, puedes comenzar a diseñar un asistente personalizado para responder a consultas o realizar tareas específicas. En esta sección, exploraremos cómo estructurar el asistente y configurarlo según tus necesidades.

Estructura de un asistente básico

prompt = "Eres un experto en matemáticas."
response = openai.Completion.create( engine="gpt-3.5-turbo-0125", prompt="Eres un experto en programación. Responde de manera clara y breve a las preguntas relacionadas con código.", temperature=0.5, max_tokens=100, frequency_penalty=0.5, presence_penalty=0.5 ) print(response.choices[0].text.strip())

Ejemplo de asistente para tareas comunes

  1. Asistente de Preguntas Frecuentes: Este tipo de asistente puede responder a preguntas comunes de manera precisa. Si tienes un conjunto de preguntas frecuentes, puedes integrar respuestas directas a consultas sobre temas específicos.
  2. Ejemplo de código para preguntas y respuestas: Puedes adaptar el asistente para responder preguntas sobre temas de interés. Aquí tienes un ejemplo donde el asistente responde sobre tecnologías:
question = "¿Qué es una IA?" response = openai.Completion.create( engine="gpt-3.5-turbo-0125", prompt=f"Pregunta: {question}\nRespuesta breve:", temperature=0.3, max_tokens=70 ) print(response.choices[0].text.strip())

Código Completo del Asistente Básico

# Importar las bibliotecas necesarias
import openai
import os
from dotenv import load_dotenv

# Cargar la clave API desde el archivo .env
load_dotenv()
openai.api_key = os.getenv("OPENAI_API_KEY")

def obtener_respuesta(prompt):
    # Crear una solicitud a la API de OpenAI
    response = openai.Completion.create(
        engine="gpt-3.5-turbo-0125",  # Puedes cambiar a otro modelo si lo deseas
        prompt=prompt,
        temperature=0.5,  # Ajusta la creatividad de la respuesta
        max_tokens=100,  # Limita la longitud de la respuesta
        frequency_penalty=0.5,  # Penaliza la repetición de palabras
        presence_penalty=0.5  # Penaliza la aparición de nuevas palabras
    )
    return response.choices[0].text.strip()

# Ejemplo de uso del asistente
if __name__ == "__main__":
    # Definir el prompt inicial
    prompt = "Eres un asistente experto en atención al cliente. Responde de manera clara y concisa a las preguntas de los usuarios."

    # Preguntar al usuario
    pregunta = input("¿Cuál es tu pregunta? ")

    # Obtener la respuesta del asistente
    respuesta = obtener_respuesta(f"{prompt}\nPregunta: {pregunta}\nRespuesta:")
    
    # Imprimir la respuesta
    print("Respuesta del asistente:", respuesta)

Diferencia entre API Assistant y GPT personalizado

A diferencia de un GPT personalizado, que exige que el usuario ingrese a la plataforma de ChatGPT para interactuar, la API de Assistants permite integrar la inteligencia artificial en diversas plataformas y aplicaciones.

Esto permite desarrollar soluciones personalizadas y accesibles para un público más amplio. Por ejemplo, podemos integrar en nuestra página web una plataforma que oriente al usuario según sus respuestas.

Preguntas frecuentes

¿Qué modelos de OpenAI se recomiendan para crear asistentes?

Los modelos recomendados suelen ser gpt-3.5-turbo-0125 o gpt-4o-mini, ya que son altamente precisos y pueden ajustarse para ofrecer respuestas claras y personalizadas en diversos escenarios.

La elección del modelo depende del nivel de interacción que necesites y de los costes asociados, ya que los modelos más avanzados consumen más recursos.

¿Cuánto cuesta utilizar la API de OpenAI en un flujo de trabajo con Make.com?

El coste depende del modelo utilizado, la cantidad de tokens (palabras) por solicitud y el volumen de solicitudes realizadas. Cada modelo tiene tarifas distintas y, en el caso de modelos como gpt-4o-mini, el coste es más elevado debido a su capacidad avanzada.

Make.com también puede tener costes adicionales dependiendo del nivel de plan y de las integraciones.

¿Cómo protejo mi clave API en Make.com y en mi código?

Es recomendable almacenar la clave API en una variable de entorno o, en el caso de Make.com, usar el sistema de seguridad interno de la plataforma para ocultar y proteger credenciales. No incluyas la clave API directamente en el código para evitar riesgos de seguridad.

¿Es posible integrar varios asistentes diferentes en Make.com?

Sí, puedes crear múltiples escenarios en Make.com, cada uno diseñado para utilizar un asistente específico de OpenAI. Por ejemplo, puedes tener un asistente dedicado a responder preguntas técnicas y otro orientado a la atención al cliente, activándolos mediante triggers distintos en Make.com.

¿Cómo puedo mejorar la precisión de las respuestas de mi asistente?

Ajustar el prompt y los parámetros del modelo, como temperature y frequency_penalty, ayuda a mejorar la precisión y adaptabilidad del asistente. Además, puedes entrenar al modelo de OpenAI con ejemplos específicos si necesitas respuestas muy detalladas o técnicas en un área específica.

Conclusión

La creación de un asistente personalizado utilizando la API de OpenAI es un proceso accesible y altamente adaptable que puede mejorar significativamente la eficiencia en la atención al cliente y en la automatización de tareas.

A lo largo de este tutorial, hemos explorado desde la configuración inicial de la cuenta hasta la integración con Make.com, permitiéndote desarrollar un asistente que se ajuste a tus necesidades específicas.

Salir de la versión móvil