So bauen Sie einen WhatsApp Agenten mit dem OpenAI Agents SDK

Das OpenAI Agents SDK ist das Open-Source-Framework von OpenAI zum Bau von Agenten: ein Modell mit Anweisungen, Tools, die es aufrufen darf, Handoffs an andere Agenten und Guardrails für seine Ein- und Ausgaben, alles in einer Schleife ausgeführt, bis die Aufgabe erledigt ist. Es ist eine hervorragende Möglichkeit, einen Agenten zu bauen. Von sich aus liefert es Ihnen jedoch keine WhatsApp-Nummer, keinen Team-Posteingang, keine Template-Nachrichten und keinen Weg, wie eine Person übernehmen kann. Mit dem Agent Harness von MonoChat wählen Sie das OpenAI Agents SDK als KI-Harness, setzen einen KI-Agent-Node in einen Flow, verbinden WhatsApp und testen, und MonoChat übernimmt den Rest.

Dieser Leitfaden behandelt, was das SDK Ihnen bietet, die drei Wege, OpenAI-Agenten in MonoChat zu nutzen, eine Schritt-für-Schritt-Einrichtung und die WhatsApp-spezifischen Details, die entscheiden, ob Kunden dem Agenten vertrauen.

Was das OpenAI Agents SDK Ihnen bietet

Das SDK baut auf wenigen Grundideen auf:

• Agenten: ein Modell plus Anweisungen, die seine Aufgabe beschreiben.
• Tools: Funktionen, die der Agent aufrufen kann, etwa „Bestellung nachschlagen“ oder „Zeitfenster prüfen“, sowie MCP-Server.
• Handoffs: ein Agent gibt die Aufgabe an einen anderen weiter, der darauf spezialisiert ist, zum Beispiel von einem allgemeinen Support-Agenten an einen Retouren-Agenten.
• Guardrails: Prüfungen, die parallel zum Agenten laufen, um unerwünschte Ein- oder Ausgaben zu stoppen.
• Sessions und Tracing: Gedächtnis über mehrere Runden und ein Protokoll dessen, was der Agent Schritt für Schritt getan hat.

Zusammen ergibt das ein Agent Harness: die Schleife, die ein Modell handeln, seine Arbeit prüfen und weitermachen lässt, statt nur einmal zu antworten. Im Kundenmessaging ist das der Unterschied zwischen dem Erklären Ihrer Retourenrichtlinie und dem tatsächlichen Anlegen der Retoure.

Was WhatsApp zur Aufgabe hinzufügt

Den Agenten zu bauen ist die halbe Arbeit. Ihn auf WhatsApp vor Kunden zu bringen, bedeutet, sich um Folgendes zu kümmern:

• Die WhatsApp Business Platform. Eine offizielle API-Anbindung, ein verifiziertes Unternehmen und eine genehmigte Nummer.
• Das 24-Stunden-Fenster. Freie Antworten sind innerhalb von 24 Stunden nach der letzten Nachricht des Kunden erlaubt; danach brauchen Sie ein genehmigtes Template.
• Richtlinien. Seit dem 15. Januar 2026 hält WhatsApp universelle KI-Assistenten von der Plattform fern. Ein Agent, der Ihre eigenen Kunden betreut, ist erlaubt, und bei automatisierten Antworten wird ein klarer Weg zu einem Menschen erwartet.
• Menschen. Manche Unterhaltungen müssen an eine Person gehen, mit intaktem Verlauf, in dem Tool, das Ihr Team bereits nutzt.
• Andere Kanäle. Kunden, die auf Instagram, Messenger oder Ihrer Website schreiben, erwarten dieselben Antworten.

MonoChat übernimmt das rund um den Agenten, sodass sich Ihre Arbeit auf den Agenten selbst konzentriert.

Drei Wege, OpenAI-Agenten in MonoChat zu nutzen

Option	Wo es läuft	Was Sie brauchen
OpenAI Agents SDK	In MonoChat	Nichts extra; nutzt Ihre KI-Modelle
OpenAI Agents API (von OpenAI gehostet)	Cloud von OpenAI	Ihr OpenAI API-Schlüssel
Custom (Ihr eigener Agents SDK Dienst)	Ihr eigener Server	Eine Endpunkt-URL und ein gemeinsames Secret

Beginnen Sie mit dem OpenAI Agents SDK Harness, wenn Sie einen Agenten im OpenAI-Stil wollen, ohne etwas bereitzustellen. Wählen Sie die OpenAI Agents API, wenn Ihre Agenten bereits auf der gehosteten Plattform von OpenAI liegen. Wählen Sie Custom, wenn Ihre Entwickler mit dem SDK einen eigenen Agenten geschrieben haben, mit eigenen Tools, Handoffs und Tests, und diesen Code weiter betreiben möchten; siehe So verbinden Sie Ihren eigenen KI-Agenten mit WhatsApp.

Schritt für Schritt: ein OpenAI Agents SDK Agent auf WhatsApp

1. Ein KI-Harness hinzufügen

Fügen Sie in MonoChat ein KI-Harness hinzu und wählen Sie OpenAI Agents SDK als Anbieter. Es läuft in MonoChat und nutzt die KI-Modelle, die Sie bereits eingerichtet haben, sodass für diesen Schritt keine zusätzlichen Schlüssel oder Server nötig sind.

2. Einen KI-Agent-Node in einen Flow setzen

Fügen Sie in dem Flow, der Ihre WhatsApp-Unterhaltungen empfängt, einen KI-Agent-Node hinzu und wählen Sie das Harness. Schreiben Sie die Anweisungen des Agenten: wen er betreut, was er kann, was er nie tun darf und wann er übergibt.

3. Haupt-, Fallback- und Schnell-Modell wählen

Jeder KI-Agent-Node hat drei Modellrollen:

• Das Hauptmodell denkt nach und schreibt die Antworten.
• Das Fallback-Modell übernimmt nach einem Soft Limit oder einem Ausfall.
• Das Schnell-Modell übernimmt Hintergrundaufgaben.

Fügen Sie ein Budgetlimit pro Durchlauf hinzu, damit eine einzelne ungewöhnliche Unterhaltung keine hohe Rechnung verursacht. Sie sind unsicher, wie Sie das Fallback wählen? Lesen Sie warum Ihr KI-Agent im Kundenkontakt ein Fallback-Modell braucht.

4. Ihre Tools anbinden

Geben Sie dem Agenten die Tools, die zu Ihren häufigsten Anfragen passen:

• KI-Funktionstools für Aufrufe Ihrer eigenen APIs mit strukturierten Eingaben.
• MCP-Integration für Tools aus MCP-kompatiblen Systemen.
• Die KI-Wissensdatenbank für Antworten, die auf Ihren Dokumenten und Richtlinien beruhen.
• Custom Functions für Logik, die innerhalb der Unterhaltung läuft.

Drei gute Tools schlagen fünfzehn halb getestete. Fügen Sie weitere hinzu, sobald Sie echte Unterhaltungen sehen.

5. WhatsApp (und alles andere) verbinden

Verbinden Sie Ihre WhatsApp Business Nummer über MonoChat, einen offiziellen Meta Business Partner. Derselbe Flow kann auf Instagram, Messenger, TikTok, Telegram, Web-Chat, SMS und Voice laufen, sodass ein Agent jeden Kanal abdeckt.

6. Mit echten Nachrichten testen

Nutzen Sie die Unterhaltungen des letzten Monats als Testset. Nehmen Sie die schwierigen dazu: verärgerte Kunden, vage Fragen, mehrere Anliegen in einer Nachricht, ein Kunde, der sofort nach einer Person fragt. Prüfen Sie die Tool-Aufrufe, den Ton und die Übergabe. Gehen Sie dann live.

Muster, die auf WhatsApp gut funktionieren

Eine Frage pro Nachricht. Agenten, die für den Web-Chat gebaut wurden, antworten gern mit langen Listen. Auf dem Smartphone bringen kurze Nachrichten und jeweils eine klare Frage bessere Antworten von Kunden.

Vor unumkehrbaren Aktionen bestätigen. Lassen Sie den Agenten vorschlagen und den Kunden bestätigen, bevor eine Stornierung, Erstattung oder Buchungsänderung erfolgt.

Spezialisten über Handoffs, Menschen über den Posteingang. Die Handoffs des SDK eignen sich hervorragend für das Routing zwischen Agenten (Vertrieb, Support, Retouren). Die Übergabe an eine Person gehört in den gemeinsamen Team-Posteingang von MonoChat, in dem die Unterhaltung mit vollständigem Verlauf ankommt.

Anweisungen, die Grenzen benennen. „Erstattungen bis €50 darfst du genehmigen; darüber übergibst du an das Abrechnungsteam.“ Ausdrückliche Zahlen schlagen vage Regeln.

Beim Thema Ihres Unternehmens bleiben. Ein Agent, der Ihren Kunden hilft, ist auf WhatsApp erlaubt. Einer, der auf alles antwortet, riskiert einen Verstoß gegen die WhatsApp-Regeln von 2026; unser Leitfaden zur WhatsApp KI-Chatbot-Richtlinie erklärt, wo die Grenze liegt.

Kosten

Drei Dinge summieren sich: Ihr MonoChat Plan, die Nutzung der KI-Modelle und die WhatsApp-Nachrichtengebühren von Meta. Seit dem 1. Oktober 2026 berechnet Meta Service-Antworten nach den ersten 1.000 pro Geschäftsnummer und Monat; siehe unseren Leitfaden zu WhatsApp-API-Preisen.

Auf der KI-Seite erhebt MonoChat keinen Aufschlag, wenn Sie Ihre eigenen Anbieter-Schlüssel nutzen. Budgets pro Durchlauf, ein günstigeres Schnell-Modell für Hintergrundaufgaben und ein verlässliches Fallback halten die Rechnung planbar.

Nicht gebunden

Mit Agent Harness wählen Sie das Framework, nicht nur das Modell. Wenn Sie später das Claude Agent SDK, Pi, Claude Managed Agents oder Ihr eigenes Framework ausprobieren möchten, fügen Sie ein weiteres KI-Harness hinzu und richten den KI-Agent-Node darauf aus. Ihre Kanäle, Tools und die Übergabe bleiben, wie sie sind. Vergleichen Sie alle Anbieter auf der Agent Harness Seite.