Estructurar una llamada a la API

Desarrollar sistemas de IA con la API OpenAI

Francesca Donadoni

Curriculum Manager, DataCamp

Instantánea de progreso

Un logotipo en blanco y negro con las palabras "opal library"

Instantánea de progreso

Un diagrama con la biblioteca de OpenAI con su logo y una llamada a la API con su ícono

Instantánea de progreso

Un diagrama con la biblioteca de OpenAI con su logo, una llamada genérica a la API con su ícono y un mensaje de respuesta con su ícono

Instantánea de progreso

from openai import OpenAI
client = OpenAI(api_key="ENTER YOUR KEY HERE")

response = client.chat.completions.create(
  model="gpt-4o-mini",
  messages=[
   {"role": "user", 
   "content": "Who developed ChatGPT?"}
 ]
)

print(response.choices[0].message.content)

ChatGPT was developed by OpenAI, an artificial intelligence research lab.

Retos en producción

Dos personas estudiando un mapa con una brújula, planificando su ruta

Un móvil mostrando una app de mapas con GPS

Retos en producción

Gestión de errores
- Mostrar mensajes de error claros
- Alternativas si el servicio no está disponible

Moderación y seguridad
- Controlar entradas no deseadas
- Minimizar el riesgo de fugas de datos

Pruebas y validación
- Detectar respuestas fuera de tema
- Probar comportamientos inconsistentes

Comunicación con sistemas externos
- Llamar a funciones y APIs externas
- Optimizar tiempos de respuesta

Componentes de una solicitud a la API de OpenAI

from openai import OpenAI

client = OpenAI(api_key="ENTER YOUR KEY HERE")

response = client.chat.completions.create(
  model="gpt-4o-mini",

  messages=[
   {"role": "user", 
   "content": "Please write down five trees with their scientific names in json format."}
 ],

  response_format={"type": "json_object"}

)

Componentes de una respuesta de la API de OpenAI

print(response.choices[0].message.content)

{
  "trees": [
    {"commonName": "Oak", "scientificName": "Quercus"},
    {"commonName": "Maple", "scientificName": "Acer"},
    {"commonName": "Pine", "scientificName": "Pinus"},
    {"commonName": "Birch", "scientificName": "Betula"},
    {"commonName": "Willow", "scientificName": "Salix"}
  ]
}

Qué sigue

Integración en producción
Llamadas a funciones externas
Mejores prácticas

Una persona con mochila y mapa señalando un destino

¡Vamos a practicar!

Desarrollar sistemas de IA con la API OpenAI