Das OpenAI Agents SDK-Tracing-System bietet Transparenz in KI-Workflows, erfasst wichtige Ereignisse und hilft Entwicklern, ihre Anwendungen effektiv zu überwachen und zu debuggen.
Was ist das OpenAI Agents SDK?
Das OpenAI Agents SDK ist ein Python-Toolkit, das die Entwicklung von KI-Agenten vereinfacht. Diese produktionsreife Weiterentwicklung von OpenAIs SWARM-Projekt bietet Funktionen zum Erstellen 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 Drittanbietermodellen mit OpenAI-kompatiblen APIs kompatibel sind.
Hauptmerkmale des OpenAI Agents SDK
Tools und funktionale Erweiterungen:
- Funktionsaufruf: Konvertieren Sie Python-Funktionen mithilfe des Dekorators
@function_toolin Tools, mit automatischer Schemaerstellung und Pydantic-Validierung. - Integrierte Agentenschleife: Behandelt Tool-Aufrufe, Rückmeldungen zu Ergebnissen und Aufgabenschleifen für eine nahtlose Interaktion zwischen Agenten und LLMs.
- Aufgabenübergabe: Ermöglicht Agenten, Aufgaben an andere spezialisierte Agenten zu delegieren und so die Zusammenarbeit mehrerer Agenten zu ermöglichen.
Sicherheits- und Überwachungsmechanismen:
- Guardrails: Die Eingabeüberprüfung verhindert schädliche Inhalte, während die Ausgabevalidierung die Qualität und Angemessenheit der Antworten sicherstellt.
- Tracing-Tools: Integrierte Tracing-Funktionalität visualisiert und überwacht den gesamten Agentenablauf und unterstützt das Debugging und die Optimierung.
Entwicklerfreundliche Funktionen:
- Python-native Methoden: Nutzen Sie Python-Sprachfunktionen zur Orchestrierung und Verkettung von Agenten, wodurch das Erlernen neuer Abstraktionen reduziert wird.
- Hochgradig anpassbar: Bietet benutzerdefinierte Tools, strukturierte Ausgabetypen und die Integration externer LLM-Anbieter.
- Leichtgewichtiges Design: Einfache, aber leistungsstarke Grundbausteine mit geringem Lernaufwand.
Vorteile des OpenAI Agents SDK
Entwicklungseffizienz
- Vereinfacht Einrichtungsprozesse, optimiert die Entwicklung von Agentenanwendungen und senkt die Einstiegshürde für die KI-Agentenentwicklung.
Erweiterte Systemfähigkeiten:
- Unterstützt die Ausführung komplexer Aufgaben 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:
- Das Tracing-System bietet Einblicke in das Agentenverhalten.
- Verbessert die Analyse von Benutzermustern 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 dessen Funktionalität erstellen.
Schritt 2: Tools integrieren
Integrieren Sie wesentliche Tools, darunter:
- Websuche-Tool: Ruft Steueraktualisierungen ab.
- API-Aufrufe: Analysiert Finanzberichte.
- Dateisuche-Tool: Findet relevante 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 auf Basis der aktuellsten Daten erstellen.
Schritt 4: Aufgaben ausführen
Führen Sie Aufgaben sequenziell oder parallel aus. Beispiel:
Runner.run_sync(agent, "Erstelle einen Bericht auf Basis der neuesten Steuergesetze und Finanzdaten.")
Schritt 5: Überwachen und Debuggen
Verwenden Sie Tracing-Tools, um die Ausführung von Aufgaben zu überwachen und potenzielle Probleme für das Debugging zu identifizieren.
Wie integriere ich Novita AI mit dem OpenAI Agents SDK?
1. Richten Sie Ihre Python-Umgebung ein und installieren Sie das Agents SDK.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Richten Sie Ihren Novita-API-Schlüssel ein.
Gehen Sie zur Konsole und erhalten Sie kostenloses Guthaben
3. Ein Beispiel für Aufgabenübergaben (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")
# 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))
# Deaktivieren Sie das Tracing für dieses Beispiel
# Weitere Informationen zur Verwendung benutzerdefinierter Spans finden Sie unter https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="Sie sind ein hilfreicher Assistent", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Schreibe ein Haiku über Rekursion in der Programmierung.")
print(result.final_output)
# Code im Code,
# Funktionen rufen sich selbst,
# Endlosschleifentanz.
Dank flexibler Tracing-Funktionen können Entwickler das Agentenverhalten sowohl über integrierte Funktionalität als auch über Integrationen von Drittanbietern 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 Drittanbietermodellen mit OpenAI-kompatiblen APIs wie Novita AI.
Wie handhabt das OpenAI Agents SDK die Tool-Integration?
Konvertieren Sie Python-Funktionen mithilfe des Dekorators @function_tool mit automatischer Schemaerstellung und Pydantic-Validierung in Tools.
Ist das OpenAI Agents SDK für Produktionsumgebungen geeignet?
Ja, es umfasst Sicherheitsfunktionen wie Guardrails, umfassendes Tracing und Überwachungsmöglichkeiten.
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 zum Aufbau und zur Skalierung bereitstellt.
