OpenAI KI Assistants & Agents Manager
Beschreibung
Highlights
Über die Erweiterung
OpenAI AI Assistants & Agents Manager ist die zentrale Backend-Schaltzentrale zum Erstellen, Konfigurieren und Testen von OpenAI-basierten Agents in Shopware 6. Er bildet die gemeinsame Grundlage für unsere KI-Plugin-Suite, sodass Agents, Instruktionen, Tools und Wissen einmal konfiguriert und anschließend in mehreren Erweiterungen wie "NextGen OpenAI Chatbot" und "KI Produkt Berater" wiederverwendet werden können.
Unter der Haube nutzt der Manager die OpenAI Responses API (die Bezeichnung „Assistants“ ist historisch bedingt).
Zentrale Agent-Verwaltung für Shopware
Erstellen und verwalten Sie Agents direkt im Shopware-Backend. Konfigurieren Sie Modelle, Instruktionen, Tools und Wissensquellen zentral, testen Sie das Verhalten vor dem produktiven Einsatz und verwenden Sie dieselbe Agent-Konfiguration in kompatiblen 5 Elements KI-Erweiterungen wieder.
Intelligente Suche mit Embeddings und lokalem Hybrid-Suchindex
Der Agents Manager enthält eine semantische intelligente Suche, die Vector-Embeddings mit einem lokalen Shopware-Suchindex kombiniert. Statt sich ausschließlich auf exakte Suchbegriffe zu verlassen, können relevante Inhalte anhand ihrer Bedeutung und ihres Kontexts gefunden werden. Dadurch finden Agents passende Informationen auch dann, wenn Kunden andere Formulierungen verwenden.
Der hybride Suchindex kann Produkte, Wissensdatenbank-Einträge und ausgewählte CMS-Seiten einbeziehen. Semantische Embeddings und lokale Indizierung arbeiten zusammen, um präzise Ergebnisse zu liefern, ohne dass Agents den exakten Produktnamen, Tag oder Wortlaut im Voraus kennen müssen.
Transparente Datenverarbeitung: Suchindex und erzeugte Vektoren verbleiben innerhalb von Shopware. Nur die zu indizierenden Texte und Suchanfragen werden zur semantischen Verarbeitung an die konfigurierte Embedding API gesendet.
Automatisches Caching und die Statusverwaltung des Index sorgen für schnelle und aktuelle Suchergebnisse. Die Indizierung ist für einen zuverlässigen Betrieb auch in gehosteten Umgebungen ausgelegt, kann sicher ohne verfügbaren Hintergrund-Worker fortgesetzt werden und unterstützt die Wiederaufnahme unterbrochener Indexaufträge.
Selbstwachsende Wissensdatenbank
Die integrierte Wissensdatenbank verwandelt unbeantwortete Fragen direkt in Shopware in wiederverwendbares Wissen.
- Ein Nutzer stellt eine Frage und der Agent durchsucht das verfügbare Wissen.
- Wenn keine passende Antwort gefunden wird, kann automatisch ein neuer ungelöster Wissensdatenbank-Eintrag erstellt werden.
- Sie ergänzen ein Answer und optional Aliases oder exakte Suchbegriffe.
- Sobald der Eintrag gelöst ist, können Agents die Antwort in zukünftigen Gesprächen wiederverwenden.
Ungelöste Einträge können weiterhin als ungelöst gekennzeichnet in Suchergebnissen erscheinen. Dadurch erkennen Agents, dass ein Thema bereits vorhanden ist. searchTerms und tagAliases ermöglichen zusätzliche Kontrolle über exakte Formulierungen und verwandte Begriffe.
Wissenseinträge können außerdem mehrere Quell-URLs enthalten. Wird ein Eintrag verwendet, kann das System die verlinkten Inhalte automatisch abrufen, bereinigen und als zusätzlichen Kontext bereitstellen, ohne dass dafür ein weiterer Tool-Call des Agents erforderlich ist.
Playground, Content Checker und Transparenz
Testen Sie Agents, bevor sie in kundenorientierten Workflows eingesetzt werden. Der Playground bietet eine interaktive Chat-Umgebung zum Validieren von Prompts, Instruktionen und Tool-Calls. Der zentrale Log-Bereich hilft dabei, KI-Interaktionen nachzuverfolgen und unerwartetes Verhalten zu analysieren.
Mit dem Content Checker können verfügbare Tools direkt im Backend getestet werden. Die Oberfläche wird aus denselben Tool-Definitionen erzeugt, die auch die Agents verwenden. Dadurch entsprechen die verfügbaren Parameter der tatsächlichen Implementierung und angezeigte Tool-Responses sind die echten Payloads, die Agents erhalten.
- Live-Tests verfügbarer Agent-Tools
- Input- und Parameter-Validierung
- Prüfung der tatsächlichen Tool-Responses
- Zentrale Logs und Trace-Informationen
- Nutzungs-Tracking pro Agent
Die Agents-Manager-Übersicht enthält zusätzlich eine Store-API-Erreichbarkeitsprüfung, mit der blockierte oder nicht erreichbare Storefront-Endpunkte erkannt werden können. Ein interaktiver Token-Counter hilft dabei, Nachrichtenlängen und erwartete API-Kosten bereits bei der Vorbereitung von Inhalten und beim Testen von Workflows abzuschätzen.
Wichtig: Der Playground läuft im Kontext des ausgewählten Verkaufskanals, einschließlich Sprache, Währung und geltender Regeln. Mit aktiviertem Backend-Modus enthalten Antworten zusätzliche Informationen für Tests und Debugging. Deaktivieren Sie den Backend-Modus, um ein Verhalten zu testen, das dem entsprechenden Storefront-Einsatz entspricht.
Hinweis: Produktergebnisse im Backend-Playground verwenden eine kompakte Darstellung, die für Agent-Tests optimiert ist. Storefront-Plugins verwenden eine eigene Darstellungsschicht für kundenorientierte Produktlisten.
Qualitätssicherung und Regression-Tests
Wenn Chat-Logging aktiviert ist, können abgeschlossene Agent-Konversationen direkt im Backend überprüft werden, einschließlich Token-Nutzung pro Nachricht und aggregierter Gesamtwerte.
Aus Chat-Threads können Scorecards erzeugt werden, die Gesprächskontext, Tool-Metadaten und Performance-Informationen wie Token-Nutzung, Caching-Ratio und Latenz zusammenführen. Dadurch lässt sich das Verhalten von Agents konsistent bewerten und nach Änderungen an Prompts, Tools oder Konfigurationen vergleichen.
Nutzer-Prompts können außerdem als Klartextliste exportiert und mit der Auto-Chat-Utility erneut abgespielt werden. Dadurch sind reproduzierbare Regression-Tests über Agent-Updates hinweg möglich.
Voraussetzungen / wichtige Hinweise
- Ein OpenAI API-Key ist erforderlich (mit API-Guthaben). Er muss für alle verwendeten Verkaufskanäle konfiguriert werden.
- Dies ist ein Basis-Plugin. Ohne eines unserer KI-Plugins bietet es keine eigenständige Storefront-Funktionalität.
- Wenn Sie das ältere Plugin „Custom GPT Sales and Support Assistant – Chatbot, Shopping Helper“ nutzen, deinstallieren Sie es zuerst, um Konflikte zu vermeiden.
- Kompatibel mit Shopware 6.7; aktualisiert auf die OpenAI Responses API.
Dokumentation:
https://docs.5-elements.cloud/oai-assistants-manager/
Details
- Verfügbar in: Englisch, Deutsch
- Zuletzt aktualisiert: 14. August 2026
- Veröffentlicht: 25. Juni 2025
- Version: 2.0.9
- Kategorie: Administration
Ressourcen
Bewertungen (0)
Über den Extension Partner
5 Elements Websolutions
Partner Status
-
Shopware
Extension Partner
Details
- Ø-Bewertung: 1
- Partner seit: 2019
- Erweiterungen: 10
Support
- Land: Germany
- Spricht: Deutsch, Englisch
- Reaktionszeit: Sehr schnell