Le système de tracing d’OpenAI Agents SDK offre une visibilité sur les workflows d’IA, en capturant les événements importants pour aider les développeurs à surveiller et déboguer leurs applications efficacement.
Qu’est-ce que OpenAI Agents SDK ?
OpenAI Agents SDK est une boîte à outils Python qui simplifie le développement d’agents IA. Cette évolution prête pour la production du projet SWARM d’OpenAI fournit des fonctionnalités pour construire des systèmes d’IA intelligents, collaboratifs et sécurisés. Au cœur se trouvent des agents basés sur des LLM configurables avec des instructions et outils spécifiques, prenant en charge des rôles personnalisés et compatibles à la fois avec les modèles OpenAI (o1, o3-mini, gpt-4o) et les modèles tiers disposant d’API compatibles OpenAI.
Fonctionnalités clés d’OpenAI Agents SDK
Outils et extensions fonctionnelles :
- Appel de fonctions : Convertit des fonctions Python en outils à l’aide du décorateur
@function_tool, avec génération automatique de schéma et validation Pydantic - Boucle d’agent intégrée : Gère les appels d’outils, les retours de résultats et les boucles de tâches pour une interaction fluide entre les agents et les LLM
- Transfert de tâches : Permet aux agents de déléguer des tâches à d’autres agents spécialisés, favorisant la collaboration multi-agents
Mécanismes de sécurité et de surveillance :
- Garde-fous : Le filtrage des entrées empêche les contenus nuisibles, tandis que la validation des sorties garantit la qualité et la pertinence des réponses
- Outils de tracing : La fonctionnalité de tracing intégrée visualise et surveille l’ensemble du flux de l’agent, facilitant le débogage et l’optimisation
Fonctionnalités adaptées aux développeurs :
- Méthodes natives Python : Exploite les fonctionnalités du langage Python pour l’orchestration et l’enchaînement des agents, réduisant ainsi le besoin d’apprendre de nouvelles abstractions
- Hautement personnalisable : Fournit des outils personnalisés, des types de sortie structurés et des capacités d’intégration avec des fournisseurs de LLM externes
- Conception légère : Ensemble de primitives simple mais puissant nécessitant une courbe d’apprentissage minimale
Avantages d’OpenAI Agents SDK
Efficacité du développement
- Simplifie les processus de configuration, rationalise le développement d’applications d’agents et abaisse la barrière à l’entrée pour le développement d’agents IA
Capacités système améliorées :
- Prend en charge l’exécution de tâches complexes et une collaboration multi-agents efficace
- Crée des systèmes collaboratifs spécialisés pour résoudre des problèmes complexes
- Intègre des modèles de LLM externes pour une plus grande flexibilité
Sécurité et fiabilité :
- Les garde-fous garantissent des interactions IA sûres
- Améliore la fiabilité et le comportement approprié des systèmes d’agents IA
- Simplifie la préparation des applications d’agents IA pour les environnements de production
Analyse et optimisation :
- Le système de tracing offre des informations sur le comportement des agents
- Améliore l’analyse des schémas utilisateur et l’identification des goulots d’étranglement
- Renforce les capacités de débogage et d’optimisation des workflows
Un exemple d’OpenAI Agents SDK
Étape 1 : Configurer l’agent
Initialisez l’agent en créant un assistant virtuel nommé AccountingAssistant avec des instructions claires pour sa fonctionnalité.
Étape 2 : Intégrer les outils
Intégrez les outils essentiels, notamment :
- Outil de recherche Web : Récupérer les mises à jour fiscales.
- Appels API : Analyser les états financiers.
- Outil de recherche de fichiers : Localiser les documents pertinents.
Étape 3 : Définir les tâches
Décomposez le workflow en tâches spécifiques :
- Tâche 1 : Récupérer les dernières mises à jour fiscales.
- Tâche 2 : Analyser les données financières à l’aide d’une API.
- Tâche 3 : Générer des rapports basés sur les dernières données.
Étape 4 : Exécuter les tâches
Exécutez les tâches séquentiellement ou en parallèle. Par exemple :
Runner.run_sync(agent, "Generate a report based on the latest tax laws and financial data.")
Étape 5 : Surveiller et déboguer
Utilisez les outils de tracing pour surveiller l’exécution des tâches et identifier les problèmes potentiels pour le débogage.
Comment intégrer Novita AI avec OpenAI Agents SDK ?
1. Configurez votre environnement Python et installez le SDK Agents.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Configurez votre clé API Novita.
Allez dans la console et obtenez des crédits gratuits
3. Un exemple de transferts (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.
Avec des capacités de tracing flexibles, les développeurs peuvent suivre le comportement des agents via des fonctionnalités intégrées et des intégrations tierces, garantissant ainsi de meilleures performances et fiabilité.
Questions fréquentes
Quels modèles de LLM puis-je utiliser avec OpenAI Agents SDK ?
Compatibles avec les modèles OpenAI (o1, o3-mini, gpt-4o) et les modèles tiers disposant d’API compatibles OpenAI comme Novita AI.
Comment OpenAI Agents SDK gère-t-il l’intégration des outils ?
Convertissez les fonctions Python en outils à l’aide du décorateur @function_tool avec génération automatique de schéma et validation Pydantic.
OpenAI Agents SDK est-il adapté aux environnements de production ?
Oui, il inclut des fonctionnalités de sécurité telles que les garde-fous, un tracing complet et des capacités de surveillance.
Novita AI est une plateforme cloud d’IA qui offre aux développeurs un moyen simple de déployer des modèles d’IA via notre API simple, tout en fournissant un cloud GPU abordable et fiable pour construire et passer à l’échelle.
