Zum Hauptinhalt springen

OpenAI Agents Manager - Einführung

Was ist das OpenAI Agents Manager Plugin?​

Das OpenAI Agents Manager Plugin ist eine leistungsstarke Erweiterung für Shopware 6, mit der Sie eigene KI-Agenten erstellen, konfigurieren und verwalten können. Diese Agenten können in verschiedenen Bereichen Ihres Online-Shops eingesetzt werden – von der Produktberatung über den Kundenservice bis hin zur Content-Erstellung.

Was ist neu in Version 2.0?

Das Plugin nutzt jetzt die moderne OpenAI Responses API anstelle der veralteten Assistants API. Das bedeutet: Ihre Agenten werden komplett in Shopware gespeichert – Sie haben die volle Kontrolle ohne Abhängigkeit von OpenAI-Servern!

Wofür können Sie Agenten verwenden?​

🛍️ Produktberatung​

Erstellen Sie einen intelligenten Produktberater, der Kunden bei der Produktauswahl hilft, Fragen zu Artikeln beantwortet und personalisierte Empfehlungen gibt.

Beispiel: Ein Kunde fragt: "Ich suche eine wasserdichte Jacke für den Winter unter 150€" – Ihr Agent durchsucht den Shop, filtert nach Eigenschaften und präsentiert passende Produkte.

🎧 Kundenservice​

Beantworten Sie häufige Fragen automatisch: Bestellstatus, Lieferzeiten, Zahlungsmethoden, Rückgabebedingungen und mehr.

Beispiel: "Wo ist meine Bestellung?" – Der Agent ruft den Bestellstatus ab (mit Bestellnummer + PLZ) und informiert den Kunden.

📝 Content-Erstellung & -Prüfung​

Nutzen Sie Agenten im Backend, um Produktbeschreibungen zu erstellen, Texte zu überprüfen oder Inhalte zu optimieren.

Beispiel: Lassen Sie einen Agenten Ihre Produktbeschreibungen auf Rechtschreibung, Tonalität und SEO-Optimierung prüfen.

🔍 Wissens-Management​

Agenten können lernen! Durch das integrierte Log-System speichern Agenten wiederkehrende Fragen und Antworten und bauen so eine eigene Wissensdatenbank auf.

Hauptfunktionen auf einen Blick​

FunktionBeschreibung
Eigene Agenten erstellenUnbegrenzt viele Agenten mit individuellen Einstellungen
Lokale SpeicherungAlle Konfigurationen werden in Shopware gespeichert
Flexible Tool-AuswahlAktivieren Sie nur die Funktionen, die Ihr Agent benötigt
Vector StoresLaden Sie eigene Dokumente hoch (PDFs, Textdateien) als Wissensquelle
Backend-ChatTesten Sie Ihre Agenten direkt im Shopware-Backend
Multi-ChannelVerschiedene Agenten für verschiedene Verkaufskanäle
Kosten-KontrolleToken-Caching spart 50-90% der OpenAI-Kosten
Log-SystemVollständige Nachverfolgung aller Konversationen

Wie funktioniert das System?​

graph TD
    A[Benutzer stellt Frage] --> B[Agent erhält Anfrage]
    B --> C{Welche Tools werden benötigt?}
    C -->|Produktsuche| D[product_search Tool]
    C -->|Shop-Infos| E[get_meta_information Tool]
    C -->|Bestellstatus| F[get_order_status Tool]
    D --> G[OpenAI Responses API]
    E --> G
    F --> G
    G --> H[Agent erstellt Antwort]
    H --> I[Benutzer erhält Antwort]

Der Ablauf im Detail:​

  1. Benutzer stellt eine Frage (im Chat, Backend oder Frontend)
  2. Agent analysiert die Anfrage und entscheidet, welche Informationen benötigt werden
  3. Tools werden aufgerufen (z.B. Produktsuche, Bestellstatus, Shop-Informationen)
  4. OpenAI verarbeitet die Daten und erstellt eine intelligente Antwort
  5. Agent liefert die Antwort zurück – formatiert und benutzerfreundlich

Voraussetzungen​

Bevor Sie das Plugin nutzen können, benötigen Sie:

  • ✅ Shopware 6.7.0 oder höher
  • ✅ PHP 8.2 oder höher
  • ✅ Einen OpenAI API-Schlüssel (Hier erstellen)
  • ✅ OpenAI-Konto mit Guthaben (Pay-as-you-go Abrechnung)
Wichtiger Hinweis

Das Plugin arbeitet mit der OpenAI API – jede Anfrage verursacht Kosten bei OpenAI. Die Kosten sind sehr gering (oft nur wenige Cent pro Konversation), aber Sie sollten Ihr OpenAI-Guthaben im Auge behalten.

Was ist ein "Agent"?​

Ein Agent ist wie ein virtueller Mitarbeiter mit einer spezifischen Aufgabe und eigenem Wissen.

Stellen Sie sich vor:

  • Agent "Produktberater": Kennt alle Produkte, Kategorien und Eigenschaften
  • Agent "Kundenservice": Weiß über Versand, Rückgabe und Zahlungen Bescheid
  • Agent "Content-Prüfer": Überprüft Texte auf Qualität und SEO

Jeder Agent hat:

  • 📝 Instructions (Anweisungen): Was ist seine Aufgabe? Wie soll er sich verhalten?
  • 🔧 Tools (Werkzeuge): Welche Funktionen stehen ihm zur Verfügung?
  • 🧠 Wissen: Welche Dateien/Informationen kann er nutzen?
  • ⚙️ Einstellungen: Welches KI-Modell, welche Kreativität, welche Ausführlichkeit?

Vorteile gegenüber der alten Version​

Alt (Assistants API)Neu (Responses API)
❌ Agenten auf OpenAI-Servern✅ Agenten lokal in Shopware
❌ Abhängigkeit von OpenAI✅ Volle Kontrolle
❌ Komplexe Thread-Verwaltung✅ Vereinfachte Struktur
❌ Veraltete API✅ Moderne, zukunftssichere API
❌ Limitierte Anpassung✅ Maximale Flexibilität

Nächste Schritte​

Jetzt wo Sie verstehen, was das Plugin kann, geht es weiter mit:

➡️ Erste Schritte - Installation und Einrichtung

➡️ OpenAI API-Schlüssel - API-Zugang einrichten

➡️ Ersten Agenten erstellen - Schritt-für-Schritt Anleitung