OpenAI KI Assistants & Agents Manager
Beschreibung
Highlights
Über die Erweiterung
OpenAI AI Assistants & Agents Manager ist die Backend-Schaltzentrale zum Erstellen, Konfigurieren und Testen von OpenAI-basierten Agents in Shopware 6. Er bildet die Grundlage für unsere erweiterten KI-Plugins ("NextGen OpenAI Chatbot", "KI Produkt Berater", "Backend AI Analyst" …).
Unter der Haube nutzt der Manager die OpenAI Responses API (die Bezeichnung „Assistants“ ist historisch bedingt).
Warum es das gibt
Dieser Manager begann als interne Konfigurationsschicht für unseren ersten Customer-Support-Chatbot. Als wir weitere Plugins geplant haben (zum Beispiel einen Product Advisor), wurde schnell klar: Wenn jedes Plugin seine eigene Agent-Konfiguration mitbringt, entsteht unnötiger Aufwand für Shops. Deshalb haben wir den Manager entkoppelt, zu einer zentralen Backend-Schaltzentrale erweitert und kostenlos veröffentlicht.
Das Ziel ist einfach: Shopbetreiber sollen Agents so lange konfigurieren und testen können, wie sie möchten – direkt im Backend – und entscheiden, ob die Ergebnisse ihren Erwartungen entsprechen. Wenn es nicht passt, soll sich der Agent sicher entfernen und ersetzen lassen, ohne nur für ein „AI“-Label bezahlt zu haben.
Selbst wachsende Wissensbasis (Agent Logs)
Agent Logs sind nicht nur Diagnose-Daten. Sie sind ein langfristiges Wissenssystem mit einem eigenen Answer-Feld.
- Ein Nutzer stellt eine Frage und der Agent durchsucht die Wissensbasis (sofern aktiviert).
- Wenn nichts passt, wird automatisch ein neuer Log-Eintrag erstellt und als ungelöst markiert.
- Sie ergänzen ein Answer (optional inklusive Aliases/Suchbegriffen) und markieren den Eintrag als gelöst.
- Ab dann können Agents diese Answer in zukünftigen Chats wiederverwenden.
Ungelöste Logs können weiterhin in Ergebnissen erscheinen (als ungelöst gekennzeichnet). So erkennen Agents, dass es das Thema bereits gibt – auch wenn die finale Answer noch nicht verfügbar ist.
URL-gestütztes Wissen
Jeder Wissenseintrag kann mehrere Quell-URLs („Fetch URLs“) speichern. Findet ein Agent den Eintrag, ruft das System die URL-Inhalte automatisch ab, bereinigt sie (Sanitizing) und liefert sie als Teil des Eintragsinhalts zurück. Es ist kein zusätzlicher Tool-Call des Agents erforderlich.
Playground und Nachvollziehbarkeit
Nutzen Sie den Playground, um Agents zu testen und Tool-Calls direkt im Backend zu validieren. Ein zentraler Log-Bereich hilft dabei, Aktivitäten Ihrer KI-Plugins nachzuverfolgen und Probleme zu analysieren.
Wichtig: Der Playground-Chat läuft im Kontext des ausgewählten Verkaufskanals (Sprache, Währung, Regeln usw.) und bildet damit die gleichen Rahmenbedingungen wie die Storefront ab. Mit aktiviertem Backend-Modus (Standard) sind Antworten bewusst ausführlicher; zusätzliche Debug-Details stehen im Log-/Trace-Bereich zur Verfügung. Deaktivieren Sie den Backend-Modus, um Antworten zu sehen, die dem Chat-Verhalten in der Storefront dieses Verkaufskanals entsprechen.
Hinweis zur Produktsuche: Um Tool-Payloads schlank zu halten, arbeiten Agents mit einer kompakten Produktdarstellung – und der Backend-Playground zeigt exakt das, was der Agent zurückliefert. Storefront-Plugins (z. B. der Chatbot) ergänzen zusätzlich eine eigene Template-Schicht und betten die optimierte products.response in ein Storefront-Template ein, um Ergebnislisten „schön“ und reichhaltig darzustellen. Diese Template-Ebene wird bewusst nur in Storefront-Plugins gepflegt, um keine UI-Logik doppelt zu warten (allein das Produkt-Listing-Template umfasst 300+ Zeilen Twig). In künftigen Updates können wir hier eine Brücke ergänzen, um diese letzte UI-Lücke zwischen Backend und Storefront zu schließen.
Was diesen Manager anders macht
Für Transparenz gebaut (vollständig in Shopware)
Diese Erweiterung implementiert ihre Werkzeuge direkt im Shopware-Backend. Sie setzt nicht auf eingebettete externe Dashboards oder Drittanbieter-UIs. Das bedeutet: Sie können nachvollziehen und anpassen, was Ihre Agents tun – dort, wo Sie sie auch konfigurieren.
- Agent Instructions sind sichtbar und editierbar (inklusive Beispiele und Schemas) und prominent in der Create/Edit-Route platziert.
- Ein Content Checker bietet eine verständliche Oberfläche, um alle verfügbaren Tools direkt im Backend zu testen.
- Die Content-Checker-UI wird aus denselben Tool-Definitionen erzeugt, die auch Agents verwenden – Parameter passen somit exakt.
- Tool-Responses, die in der UI angezeigt werden, sind die tatsächlichen Payloads, die Agents erhalten (keine vereinfachte Vorschau).
Qualitätssicherung (Scorecards)
Wenn Chat-Logging aktiviert ist, werden finale Agent-Konversationen gespeichert und sind im Backend einsehbar. Sie können eine vollständige Thread-Ansicht öffnen, die Token-Nutzung pro Nachricht prüfen und aggregierte Summen sehen.
Für die Qualitätssicherung kann der Manager aus jedem Chat-Thread eine Scorecard erzeugen. Eine Scorecard bündelt den kompletten Chat-Kontext plus Tool-Metadaten und Performance-Daten (Tokens, Caching-Ratio, Latenz), sodass Sie Verhalten konsistent und reproduzierbar analysieren können.
Zusätzlich können Sie die Nutzer-Prompts als Klartextliste exportieren (ein Prompt pro Zeile), um dieselbe Sequenz mit der Auto-Chat-Utility erneut abzuspielen und zu prüfen, ob sich das System noch wie gestern verhält.
Sehen Sie, was Ihre KI sieht (keine Blackbox)
Testen Sie Tools mit einer interaktiven UI und prüfen Sie, welche Daten Ihre Agents erhalten, bevor Sie irgendetwas ausrollen.
- Live-Tool-Tests für verfügbare Tools
- Input-/Parameter-Vorschau und Validierung
- Visualisierung von Tool-Responses
- Nutzungs-Tracking pro Agent
Shopware-native Wissensbasis mit Feedback-Loop, die mit der Zeit besser wird (Fragen → Answer → Wiederverwendung)
Wenn Kunden neue Fragen stellen, entsteht daraus ein neuer Agent-Log-Eintrag – und damit wiederverwendbares Wissen – direkt im Shopware-Backend. Sie lösen den Eintrag einmal (Answer + optionale Aliases/Suchbegriffe) und Agents können diese Answer (Antwort) in zukünftigen Chats wiederverwenden.
- Ungelöste Einträge können weiterhin in Suchen erscheinen (als ungelöst markiert)
- Exakte searchTerms (Fallback) und tagAliases helfen, Duplikate durch unterschiedliche Formulierungen zu vermeiden
Konzipiert, um doppelte Konfiguration über mehrere Plugins zu vermeiden
Dieser Manager ist die gemeinsame Basis, damit Sie dieselbe Agent-Logik nicht mehrfach konfigurieren müssen, wenn Sie mehrere KI-Erweiterungen einsetzen.
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: 9. Februar 2026
- Veröffentlicht: 25. Juni 2025
- Version: 2.0.7
- Kategorie: Administration
Ressourcen
Bewertungen (0)
Über den Extension Partner
5 Elements Websolutions
Partner Status
-
Shopware
Extension Partner
Details
- Ø-Bewertung: 1
- Partner seit: 2019
- Erweiterungen: 9
Support
- Land: Germany
- Spricht: Deutsch, Englisch
- Reaktionszeit: Sehr schnell