Le système de traçage du SDK OpenAI Agents offre une visibilité sur les workflows d’IA, en capturant les événements importants pour aider les développeurs à surveiller et déboguer efficacement leurs applications.
Qu’est-ce que le SDK OpenAI Agents ?
Le SDK OpenAI Agents est une boîte à outils Python qui simplifie le développement d’agents d’IA. Cette évolution, prête pour la production, du projet SWARM d’OpenAI propose des fonctionnalités pour créer 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 des outils spécifiques, prenant en charge des rôles personnalisés et compatibles avec les modèles OpenAI (o1, o3-mini, gpt-4o) ainsi que les modèles tiers dotés d’API compatibles OpenAI.
Fonctionnalités clés du SDK OpenAI Agents
Outils et extensions fonctionnelles :
- Appel de fonction : Convertit les 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ésultat 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 ainsi la collaboration multi-agents.
Mécanismes de sécurité et de surveillance :
- Gardefous : 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 traçage : Fonctionnalité de traçage intégrée qui 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 : Propose 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 simples mais puissantes, nécessitant une courbe d’apprentissage minimale.
Avantages du SDK OpenAI Agents
Efficacité de développement
- Simplifie les processus de configuration, rationalise le développement d’applications d’agents et abaisse la barrière d’entrée pour la création d’agents d’IA.
Capacités système améliorées :
- Prend en charge l’exécution de tâches complexes et la 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 LLM externes pour une plus grande flexibilité.
Sécurité et fiabilité :
- Les gardefous garantissent des interactions IA sûres.
- Renforce la fiabilité et le comportement approprié des systèmes d’agents d’IA.
- Simplifie la préparation des applications d’agents d’IA pour les environnements de production.
Analyse et optimisation :
- Le système de traçage fournit des informations sur le comportement des agents.
- Améliore l’analyse des modèles d’utilisateurs et l’identification des goulots d’étranglement.
- Renforce les capacités de débogage et d’optimisation des workflows.
Un exemple du SDK OpenAI Agents
Étape 1 : Configurer l’agent
Initialisez l’agent en créant un assistant virtuel nommé AccountingAssistant avec des instructions claires pour ses fonctionnalités.
É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écoupez 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, "Générer un rapport basé sur les dernières lois fiscales et données financières.")
Étape 5 : Surveiller et déboguer
Utilisez les outils de traçage pour surveiller l’exécution des tâches et identifier les problèmes potentiels pour le débogage.
Comment intégrer Novita AI avec le SDK OpenAI Agents ?
1. Configurer votre environnement Python et installer le SDK Agents.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Configurer votre clé API Novita.
Allez dans la console et obtenez des crédits gratuits
3. Un exemple de transferts
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")
# Comme Novita ne supporte pas l'API responses, nous utilisons l'API chat completions à la place.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Désactiver le traçage pour cet exemple
# Référez-vous à https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list pour utiliser des spans personnalisés.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="Vous êtes un assistant serviable", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Écrire un haïku sur la récursivité en programmation.")
print(result.final_output)
# Code dans le code,
# Fonctions s'appelant elles-mêmes,
# Danse de la boucle infinie.
Grâce à des capacités de traçage 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 LLM puis-je utiliser avec le SDK OpenAI Agents ?
Compatibles avec les modèles OpenAI (o1, o3-mini, gpt-4o) et les modèles tiers dotés d’API compatibles OpenAI comme Novita AI.
Comment le SDK OpenAI Agents 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.
Le SDK OpenAI Agents est-il adapté aux environnements de production ?
Oui, il inclut des fonctionnalités de sécurité comme les gardefous, un traçage 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, tout en fournissant un cloud GPU abordable et fiable pour construire et passer à l’échelle.
