Kursbeschreibung
In der OpenAI Agents SDK Schulung stellst du eine bestehende Assistants-Anwendung kontrolliert auf die Responses API und das OpenAI Agents SDK um. Das ist zeitkritisch: Die Assistants API wird am 26. August 2026 eingestellt. Statt die bestehende Anwendung vollständig neu zu entwickeln, untersuchst du zuerst Assistants, Threads, Runs, Dateien und Tool-Aufrufe. Anschließend ordnest du diese Bestandteile Prompts, Conversations, Responses, Sessions und den Laufzeitkomponenten des Agents SDK zu.
Du definierst prüfbare Zwischenstände, vergleichst fachliche Ergebnisse und hältst einen Rückfallpfad bereit. Die Referenzanwendung verarbeitet Responses synchron und als Stream, führt Kontext über Conversations oder Sessions fort und validiert strukturierte Ausgaben mit Pydantic. Fehlerhafte Tool-Parameter, abgebrochene Läufe und nicht erreichbare Dienste behandelst du als eigene Fehlerpfade.
Auf dieser Basis entwickelst du spezialisierte Agenten mit Handoffs und einem Manager-Agenten. Guardrails prüfen Eingaben und Ergebnisse. Berechtigungskontexte, Freigaben und Regeln für ausgehende Daten begrenzen kritische Tool-Aufrufe. Traces zeigen Modellaufrufe, Übergaben und Fehler. Aus den Traces leitest du Evaluationsfälle sowie Regressionstests ab. Weitere technische KI-Themen findest du bei den KI-Schulungen für Entwickler und Administratoren. Die kleine Gruppe mit zwei bis acht Personen lässt Raum für Code-Analysen und Rückfragen zur Migration. Für dein Entwicklungsteam kannst du ein Inhouse-Angebot anfragen.
Die wichtigsten Themen im Überblick
- Assistants API kontrolliert migrieren
- Responses API und Conversations nutzen
- Tool-Rechte und Freigaben begrenzen
- Handoffs und Manager-Agenten umsetzen
- Traces für Regressionstests auswerten
- Produktionsrisiken vor Releases prüfen
Zielgruppe
- Python-Entwicklungsteams mit bestehenden OpenAI-Integrationen
- AI-Engineering-Fachkräfte mit Assistants-API-Bestand
- Technische Projektleitungen mit Migrationsverantwortung
- Teams mit Vorkenntnissen aus dem Multi-Agent-Systeme-Grundkurs und geplanter OpenAI-Orchestrierung
Voraussetzung für die Schulung
- Sichere Python-Kenntnisse für API-Aufrufe und asynchrone Abläufe
- Erfahrung mit REST-APIs, JSON und Git
- Grundkenntnisse der Assistants API oder einer bestehenden OpenAI-Integration
- Vorbereitete Python-Entwicklungsumgebung und OpenAI-API-Zugang
Kursinhalte
Laufzeitmodell und Responses API
- Agenten, Runner und Ausführungskontext
- Lebenszyklus eines Agentenlaufs
- Responses und Output-Items
- Synchroner und gestreamter Aufruf
- Asynchrone Verarbeitung von Responses
- Modellparameter und versionierte Prompts
Zustandsführung und API-Migration
- Bestandsaufnahme der Assistants-Objekte
- Assistants auf Prompts abbilden
- Threads auf Conversations abbilden
- Runs auf Responses abbilden
- Fortsetzung über previous_response_id
- Sessions für clientseitigen Zustand
- Dateien und Vector-Stores übertragen
- Parallelbetrieb mit Rückfallpfad
Tools und strukturierte Ausgaben
- Funktionstools mit JSON-Schema
- Ausgabetypen mit Pydantic
- Validierung fehlerhafter Modellantworten
- Fehlerbehandlung für Tool-Parameter
- Wiederholungsregeln für fehlgeschlagene Aufrufe
- Timeouts mit definierten Abbruchpfaden
Agenten-Workflows und Handoffs
- Handoffs mit typisierten Übergabedaten
- Begrenzung des übergebenen Kontexts
- Manager-Agent für die Aufgabenverteilung
- Spezialisierte Agenten mit Zustandsgrenzen
- Abbruchbedingungen für Agentenläufe
Sicherheitsarchitektur, MCP und Sandbox
- Guardrails für Eingaben und Ausgaben
- Tests gegen Prompt-Injection
- Tool-Rechte über Wrapper begrenzen
- Freigaben vor kritischen Aktionen
- Kontrolle ausgehender Daten
- Vertrauensgrenzen für MCP-Tools
- MCP-Server im Agents SDK
- Sandbox mit Ressourcenlimits
Tracing, Evaluation und Produktion
- Traces, Spans und group_id
- Analyse von Modellaufrufen und Handoffs
- Fehleranalyse mit Trace-Daten
- Evaluationsfälle aus Agentenläufen
- Tests für unerlaubte Aktionen
- Regressionstests vor Releases
- Mandantenbezogene Berechtigungskontexte
- Protokollierung ohne sensible Inhalte
- Versionierte Agentenkonfigurationen
