El sistema de seguimiento de OpenAI Agents SDK proporciona visibilidad en los flujos de trabajo de IA, capturando eventos importantes para ayudar a los desarrolladores a monitorear y depurar sus aplicaciones de manera efectiva.
¿Qué es OpenAI Agents SDK?
OpenAI Agents SDK es un conjunto de herramientas de Python que simplifica el desarrollo de agentes de IA. Esta evolución lista para producción del proyecto SWARM de OpenAI proporciona funciones para construir sistemas de IA inteligentes, colaborativos y seguros. En su núcleo se encuentran agentes basados en LLM configurables con instrucciones y herramientas específicas, que admiten roles personalizados y son compatibles tanto con modelos de OpenAI (o1, o3-mini, gpt-4o) como con modelos de terceros que tienen APIs compatibles con OpenAI.
Características Clave de OpenAI Agents SDK
Herramientas y Extensiones Funcionales:
- Llamada a Funciones: Convierte funciones de Python en herramientas usando el decorador
@function_tool, con generación automática de esquemas y validación Pydantic - Bucle de Agente Integrado: Maneja llamadas a herramientas, retroalimentación de resultados y bucles de tareas para una interacción fluida entre agentes y LLMs
- Transferencias de Tareas: Permite que los agentes deleguen tareas a otros agentes especializados, habilitando la colaboración multiagente
Mecanismos de Seguridad y Monitoreo:
- Guardarraíles: El filtrado de entrada previene contenido dañino, mientras que la validación de salida asegura la calidad y adecuación de las respuestas
- Herramientas de Seguimiento: La funcionalidad de seguimiento integrada visualiza y monitorea todo el flujo del agente, facilitando la depuración y optimización
Características Amigables para Desarrolladores:
- Métodos Nativos de Python: Aprovecha las características del lenguaje Python para la orquestación y encadenamiento de agentes, reduciendo la necesidad de aprender nuevas abstracciones
- Altamente Personalizable: Proporciona herramientas personalizadas, tipos de salida estructurados y capacidades de integración con proveedores externos de LLM
- Diseño Ligero: Conjunto de primitivas simple pero potente que requiere una curva de aprendizaje mínima
Beneficios de OpenAI Agents SDK
Eficiencia en el Desarrollo
- Simplifica los procesos de configuración, agiliza el desarrollo de aplicaciones de agentes y reduce la barrera de entrada para el desarrollo de agentes de IA
Capacidades Mejoradas del Sistema:
- Soporta la ejecución de tareas complejas y la colaboración eficiente entre múltiples agentes
- Crea sistemas colaborativos especializados para resolver problemas complejos
- Integra modelos LLM externos para mayor flexibilidad
Seguridad y Fiabilidad:
- Los guardarraíles aseguran interacciones seguras de IA
- Mejora la fiabilidad y el comportamiento adecuado del sistema de agentes de IA
- Simplifica la preparación de aplicaciones de agentes de IA para entornos de producción
Análisis y Optimización:
- El sistema de seguimiento proporciona información sobre el comportamiento del agente
- Mejora el análisis de patrones de usuario y la identificación de cuellos de botella
- Potencia las capacidades de depuración y optimización de flujos de trabajo
Un Ejemplo de OpenAI Agents SDK
Paso 1: Configurar el Agente
Inicializa el agente creando un asistente virtual llamado AccountingAssistant con instrucciones claras para su funcionalidad.
Paso 2: Integrar Herramientas
Integra herramientas esenciales, incluyendo:
- Herramienta de Búsqueda Web: Recuperar actualizaciones fiscales.
- Llamadas a la API: Analizar estados financieros.
- Herramienta de Búsqueda de Archivos: Localizar documentos relevantes.
Paso 3: Definir Tareas
Divide el flujo de trabajo en tareas específicas:
- Tarea 1: Recuperar las últimas actualizaciones fiscales.
- Tarea 2: Analizar datos financieros usando una API.
- Tarea 3: Generar informes basados en los datos más recientes.
Paso 4: Ejecutar Tareas
Ejecuta las tareas de forma secuencial o en paralelo. Por ejemplo:
Runner.run_sync(agent, "Generar un informe basado en las últimas leyes fiscales y datos financieros.")
Paso 5: Monitorear y Depurar
Usa las herramientas de seguimiento para monitorear la ejecución de las tareas e identificar posibles problemas para la depuración.
¿Cómo Integrar Novita AI con OpenAI Agents SDK?
1. Configura tu entorno Python e instala el Agents SDK.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Configura tu clave API de Novita.
Ve a la Consola y Obtén Créditos Gratis
3. Un Ejemplo de Transferencias
import os
from openai import AsyncOpenAI
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
BASE_URL = "https://api.novita.ai/v3/openai"
API_KEY = os.getenv("NOVITA_API_KEY")
MODEL_NAME = os.getenv("MODEL_NAME")
# Como Novita no admite la API de respuestas, usamos la API de finalizaciones de chat en su lugar.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Deshabilitar el seguimiento para este ejemplo
# Consulta https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list para usar tramos personalizados.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="Eres un asistente útil", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Escribe un haiku sobre la recursión en programación.")
print(result.final_output)
# Código dentro del código,
# Funciones que se llaman a sí mismas,
# Danza de bucle infinito.
Con capacidades de seguimiento flexibles, los desarrolladores pueden rastrear el comportamiento del agente tanto con funcionalidad integrada como con integraciones de terceros, asegurando un mejor rendimiento y fiabilidad.
Preguntas Frecuentes
¿Qué modelos LLM puedo usar con OpenAI Agents SDK?
Compatible con modelos de OpenAI (o1, o3-mini, gpt-4o) y modelos de terceros con APIs compatibles con OpenAI como Novita AI.
¿Cómo maneja OpenAI Agents SDK la integración de herramientas?
Convierte funciones de Python en herramientas usando el decorador @function_tool con generación automática de esquemas y validación Pydantic.
¿Es OpenAI Agents SDK adecuado para entornos de producción?
Sí, incluye características de seguridad como guardarraíles, seguimiento integral y capacidades de monitoreo.
Novita AI es una plataforma en la nube de IA que ofrece a los desarrolladores una forma sencilla de implementar modelos de IA usando nuestra API simple, al mismo tiempo que proporciona una nube de GPU asequible y fiable para construir y escalar.
