Das OpenAI Agents SDK-Tracing-System bietet Transparenz in KI-Workflows, indem es wichtige Ereignisse erfasst, um Entwicklern bei der Überwachung und Fehlerbehebung ihrer Anwendungen zu helfen.
Was ist das OpenAI Agents SDK?
Das OpenAI Agents SDK ist ein Python-Toolkit, das die Entwicklung von KI-Agenten vereinfacht. Diese produktionsreife Weiterentwicklung des OpenAI SWARM-Projekts bietet Funktionen zum Aufbau intelligenter, kollaborativer und sicherer KI-Systeme. Im Kern stehen LLM-basierte Agenten, die mit spezifischen Anweisungen und Tools konfiguriert werden können, benutzerdefinierte Rollen unterstützen und sowohl mit OpenAI-Modellen (o1, o3-mini, gpt-4o) als auch mit Drittanbieter-Modellen mit OpenAI-kompatiblen APIs kompatibel sind.
Hauptfunktionen des OpenAI Agents SDK
Tools und Funktionserweiterungen:
- Funktionsaufruf: Konvertieren Sie Python-Funktionen mithilfe des
@function_tool-Dekorators in Tools, mit automatischer Schema-Generierung und Pydantic-Validierung - Eingebaute Agentenschleife: Verarbeitung von Tool-Aufrufen, Ergebnis-Rückmeldungen und Aufgaben-Schleifen für eine nahtlose Interaktion zwischen Agenten und LLMs
- Aufgabenübergaben: Ermöglicht Agenten die Delegation von Aufgaben an andere spezialisierte Agenten, was Multi-Agenten-Kollaboration ermöglicht
Sicherheits- und Überwachungsmechanismen:
- Guardrails: Eingabeüberprüfung verhindert schädliche Inhalte, während Ausgabevalidierung Antwortqualität und Angemessenheit sicherstellt
- Tracing-Tools: Integrierte Tracing-Funktionalität visualisiert und überwacht den gesamten Agentenablauf und unterstützt bei der Fehlerbehebung und Optimierung
Entwicklerfreundliche Funktionen:
- Python-native Methoden: Nutzen Sie Python-Sprachfunktionen für Agenten-Orchestrierung und Verkettung, wodurch der Aufwand zum Erlernen neuer Abstraktionen reduziert wird
- Hochgradig anpassbar: Bietet benutzerdefinierte Tools, strukturierte Ausgabetypen und Integrationsmöglichkeiten für externe LLM-Anbieter
- Leichtes Design: Einfacher, aber leistungsstarker Satz von Grundbausteinen mit minimaler Lernkurve
Vorteile des OpenAI Agents SDK
Entwicklungseffizienz
- Vereinfacht Einrichtungsprozesse, optimiert die Entwicklung von Agentenanwendungen und senkt die Einstiegshürde für die KI-Agentenentwicklung
Verbesserte Systemfähigkeiten:
- Unterstützt komplexe Aufgabenausführung und effiziente Multi-Agenten-Kollaboration
- Erstellt spezialisierte kollaborative Systeme zur Lösung komplexer Probleme
- Integriert externe LLM-Modelle für mehr Flexibilität
Sicherheit und Zuverlässigkeit:
- Guardrails gewährleisten sichere KI-Interaktionen
- Erhöht die Zuverlässigkeit und das angemessene Verhalten von KI-Agentensystemen
- Vereinfacht die Vorbereitung von KI-Agentenanwendungen für Produktionsumgebungen
Analyse und Optimierung:
- Tracing-System bietet Einblicke in das Agentenverhalten
- Verbessert die Analyse von Benutzerverhalten und die Identifizierung von Engpässen
- Erweitert die Debugging- und Workflow-Optimierungsmöglichkeiten
Ein Beispiel für das OpenAI Agents SDK
Schritt 1: Agent einrichten
Initialisieren Sie den Agenten, indem Sie einen virtuellen Assistenten namens AccountingAssistant mit klaren Anweisungen für seine Funktionalität erstellen.
Schritt 2: Tools integrieren
Integrieren Sie wesentliche Tools, darunter:
- Web-Suche-Tool: Abrufen von Steueraktualisierungen.
- API-Aufrufe: Analyse von Finanzberichten.
- Dateisuche-Tool: Auffinden relevanter Dokumente.
Schritt 3: Aufgaben definieren
Unterteilen Sie den Workflow in spezifische Aufgaben:
- Aufgabe 1: Die neuesten Steueraktualisierungen abrufen.
- Aufgabe 2: Finanzdaten mithilfe einer API analysieren.
- Aufgabe 3: Berichte basierend auf den neuesten Daten erstellen.
Schritt 4: Aufgaben ausführen
Führen Sie Aufgaben sequentiell oder parallel aus. Zum Beispiel:
Runner.run_sync(agent, "Erstellen Sie einen Bericht basierend auf den neuesten Steuergesetzen und Finanzdaten.")
Schritt 5: Überwachen und debuggen
Verwenden Sie Tracing-Tools, um die Ausführung von Aufgaben zu überwachen und potenzielle Probleme zur Fehlerbehebung zu identifizieren.
Wie integriere ich Novita AI mit dem OpenAI Agents SDK?
1. Python-Umgebung einrichten und Agents SDK installieren.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Novita-API-Schlüssel einrichten.
Zur Konsole gehen und kostenlose Credits erhalten
3. Ein Beispiel für Übergaben
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")
# Da Novita die responses API nicht unterstützt, verwenden wir stattdessen die chat completions API.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Tracing für dieses Beispiel deaktivieren
# Siehe https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list für die Verwendung benutzerdefinierter Spans.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="Sie sind ein hilfreicher Assistent", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Schreiben Sie ein Haiku über Rekursion in der Programmierung.")
print(result.final_output)
# Code im Code,
# Funktionen, die sich selbst rufen,
# Tanz der Endlosschleife.
Mit flexiblen Tracing-Funktionen können Entwickler das Agentenverhalten sowohl über integrierte Funktionen als auch über Drittanbieter-Integrationen verfolgen, was eine bessere Leistung und Zuverlässigkeit gewährleistet.
Häufig gestellte Fragen
Welche LLM-Modelle kann ich mit dem OpenAI Agents SDK verwenden?
Kompatibel mit OpenAI-Modellen (o1, o3-mini, gpt-4o) und Drittanbieter-Modellen mit OpenAI-kompatiblen APIs wie Novita AI.
Wie handhabt das OpenAI Agents SDK die Tool-Integration?
Konvertieren Sie Python-Funktionen mithilfe des @function_tool-Dekorators mit automatischer Schema-Generierung und Pydantic-Validierung in Tools.
Ist das OpenAI Agents SDK für Produktionsumgebungen geeignet?
Ja, es enthält Sicherheitsfunktionen wie Guardrails, umfassendes Tracing und Überwachungsfähigkeiten.
Novita AI ist eine KI-Cloud-Plattform, die Entwicklern eine einfache Möglichkeit bietet, KI-Modelle über unsere einfache API bereitzustellen, und gleichzeitig eine erschwingliche und zuverlässige GPU-Cloud für den Aufbau und die Skalierung bereitstellt.
