OpenAI Agents SDK
Was dieser Artikel behandelt
- Was das OpenAI Agents SDK ist und wozu es dient.
- Wie Du es installierst.
- Wie Du einen ersten Agenten mit einem Tool baust.
- Wie Du lokal oder mit OpenAI-API arbeiten kannst.
- Wofür es besonders gut geeignet ist und wo die Grenzen liegen.
Einleitung
Das OpenAI Agents SDK ist das offizielle Python-Framework von OpenAI, um Agenten zu bauen. Es bietet Werkzeuge für Tool-Calling, Zustandsverwaltung und Workflows. Die Installation ist einfach, der Einstieg geht schnell. Wer direkt mit starken Modellen starten will, ist damit gut bedient. Lokal lässt es sich über OpenAI-kompatible Endpoints wie Ollama nutzen, auch wenn der Fokus auf OpenAI-APIs liegt.
OpenAI Agents SDK kurz erklärt
Das SDK arbeitet mit Agenten, Tools und Runnern. Ein Agent bekommt eine Anweisung und kann Tools nutzen. Ein Runner führt die Anfrage aus und steuert den Ablauf. Tools sind Python-Funktionen, die der Agent aufrufen kann. So lässt sich ein Agent bauen, der recherchiert, rechnet oder externe APIs nutzt.
Installation
pip install openai-agentsFür den Betrieb mit OpenAI benötigst Du einen API-Key:
export OPENAI_API_KEY="dein-key"Wenn Du ein OpenAI-kompatibles lokales Modell wie Ollama nutzen willst, setzt Du zusätzlich die Base-URL:
export OPENAI_BASE_URL="http://localhost:11434/v1"Erste Schritte: Ein Agent mit Tool
from agents import Agent, Runner
def aktuelles_jahr() -> str:
return "2026"
agent = Agent(
name="hilfsassistent",
instructions="Du hilfst bei einfachen Fragen.",
tools=[aktuelles_jahr]
)
result = Runner.run_sync(agent, "Welches Jahr haben wir?")
print(result.final_output)In diesem Beispiel registrierst Du eine Python-Funktion als Tool. Der Agent entscheidet selbst, ob er sie aufrufen muss.
Wofür ist das SDK geeignet?
| Einsatzgebiet | Nutzen |
|---|---|
| Schnelle Prototypen | Einfaches Tool-Calling und Runner-API |
| Cloud-Agenten | Direkte Integration mit OpenAI-Modellen |
| API-Workflows | Agenten greifen auf eigene Funktionen zu |
| Lernen | Wenig Boilerplate, schnelle Ergebnisse |
Typische Stolpersteine
- API-Kosten - OpenAI-Modelle sind nicht kostenlos. Für lokale Tests solltest Du Ollama einbinden.
- Keine native Multi-Agenten-Koordination - Für komplexe Multi-Agenten-Teams sind CrewAI oder AutoGen oft flexibler.
- Base-URL beachten - Bei Ollama muss die URL mit
/v1enden und ein beliebiger API-Key übergeben werden.
Weiterführende Links
FAQ - Typische Fragen
Ist das OpenAI Agents SDK kostenlos?
Das SDK selbst ist kostenlos. Kosten entstehen nur bei der Nutzung der OpenAI-API. Lokale Modelle über Ollama sind kostenlos.
Kann ich es lokal betreiben?
Ja, über OpenAI-kompatible Endpoints wie Ollama. Dafür setzt Du OPENAI_BASE_URL auf http://localhost:11434/v1.
Was brauche ich zum Start?
Python, pip install openai-agents und entweder einen OpenAI-API-Key oder ein lokales Ollama-Modell.