El sistema de seguimiento del SDK de OpenAI Agents 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 el SDK de OpenAI Agents?
El SDK de OpenAI Agents 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 ofrece características 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 tengan APIs compatibles con OpenAI.
Características Clave del SDK de OpenAI Agents
Herramientas y Extensiones Funcionales:
- Llamadas a Funciones: Convierte funciones de Python en herramientas usando el decorador
@function_tool, con generación automática de esquemas y validación con 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 LLM.
- Transferencia de Tareas: Permite a los agentes delegar 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 el Desarrollador:
- 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: Ofrece herramientas personalizadas, tipos de salida estructurados y capacidad de integración con proveedores de LLM externos.
- Diseño Ligero: Un conjunto de primitivas simple pero potente que requiere una curva de aprendizaje mínima.
Beneficios del SDK de OpenAI Agents
Eficiencia de 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 de IA seguras.
- Mejora la fiabilidad y el comportamiento adecuado de los sistemas 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 del SDK de OpenAI Agents
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: Recupera actualizaciones fiscales.
- Llamadas a API: Analiza estados financieros.
- Herramienta de Búsqueda de Archivos: Localiza 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, "Genera un informe basado en las últimas leyes fiscales y datos financieros.")
Paso 5: Monitorear y Depurar
Usa 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 el SDK de OpenAI Agents?
1. Configura tu entorno de Python e instala el SDK de Agents.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Configura tu clave de API de Novita.
Ir a la Consola y Obtener Créditos Gratuitos
3. Un Ejemplo de Transferencias (Handoffs)
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")
# Because Novita not support the responses API so we use the chat completions API instead.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Disable tracing for this example
# Refer to https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list to use the custom spans.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="You are a helpful assistant", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Write a haiku about recursion in programming.")
print(result.final_output)
# Code within the code,
# Functions calling themselves,
# Infinite loop's dance.
Con capacidades de seguimiento flexibles, los desarrolladores pueden rastrear el comportamiento del agente tanto a través de la funcionalidad integrada como de integraciones de terceros, asegurando un mejor rendimiento y fiabilidad.
Preguntas Frecuentes
¿Qué modelos LLM puedo usar con el SDK de OpenAI Agents?
Es 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 el SDK de OpenAI Agents 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 con Pydantic.
¿Es el SDK de OpenAI Agents adecuado para entornos de producción?
Sí, incluye funciones 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 utilizando nuestra API simple, al mismo tiempo que proporciona una nube de GPU asequible y confiable para construir y escalar.
