OpenAI AI Assistants & Agents Manager
Description
Highlights
About the Extension
OpenAI AI Assistants & Agents Manager is the backend control center for creating, configuring and testing OpenAI-powered agents in Shopware 6. It is the foundation for our advanced AI plugins ("NextGen OpenAI Chatbot", "AI Product Advisor", "Backend AI Analyst"…).
Under the hood, the manager uses the OpenAI Responses API (the “Assistants” naming is legacy).
Why this exists
This manager started as an internal configuration layer for our first customer support chatbot. When we planned additional plugins (for example a Product Advisor), it became clear that duplicating agent configuration in every plugin would create unnecessary overhead for shops. So we decoupled the manager, extended it into a central backend control center, and made it free.
The goal is simple: shop owners should be able to configure and test agents as long as needed, directly in the backend, and decide if the results match their expectations. If the results do not fit, it should be safe to remove and replace without having paid just for an “AI” label.
Shopware-native, self-growing knowledge base (human-in-the-loop)
Agent Logs turn unanswered questions into reusable answers—directly in the Shopware backend. They form a long-term knowledge system with a dedicated Answer field.
- A user asks a question and the agent searches the knowledge base (if enabled).
- If nothing matches, a new log is created automatically and marked as unresolved.
- You add an Answer (and optionally aliases/search terms) and mark it as resolved.
- From then on, agents can reuse that Answer in future chats.
Unresolved logs can still appear in results (flagged as unresolved). This helps agents recognize that the topic already exists, even if the final Answer is not available yet.
URL-backed knowledge
Each knowledge entry can store multiple source URLs (“Fetch URLs”). When an agent finds the entry, the system automatically fetches and sanitizes the URL content and returns it as part of the entry content. No extra agent tool call is required.
Playground chat and observability
Use the Playground chat to test agents and validate tool calls in the backend. A unified log area helps you trace AI plugin activities and troubleshoot issues.
Important: The Playground chat runs in the context of the selected Sales Channel (language, currency, rules, etc.), so it reflects the same conditions as the storefront. With Backend mode enabled (default), responses are intentionally more verbose, and additional debug details are available in the logs/trace area. Disable Backend mode to see responses that match what the same agent will return in the storefront for that Sales Channel.
Note on product search results: To keep tool payloads lean, agents work with a condensed product representation, and the backend Playground shows exactly what the agent returns. Storefront-facing plugins (e.g. the Chatbot) additionally wrap the optimized products.response in a dedicated storefront template to present richer listings. This template layer is intentionally maintained only in storefront plugins to avoid duplicating UI maintenance (the product listing template alone is 300+ lines of Twig). We may add a bridge later to close this last UI gap between backend and storefront.
What makes this manager different
Built for transparency (fully inside Shopware)
This extension implements its tooling directly in the Shopware backend. It does not rely on embedded external dashboards or third-party UIs. That means you can inspect and change what your agents do in the same place you configure them.
- Agent instructions are visible and editable (including examples and schemas), prominently placed in the agent create/edit route.
- A Content Checker provides a human-friendly interface to test all available tools directly in the backend.
- The Content Checker UI is generated from the same tool definitions agents use, so the available parameters match exactly.
- Tool responses shown in the UI are the actual payload agents receive (not a simplified preview).
Quality assurance (Scorecards)
If chat logging is enabled, final agent conversations are stored and reviewable in the backend. You can open a full thread view, inspect per-message token usage, and see aggregated totals.
For quality assurance, the manager can generate a Scorecard from any chat thread. A Scorecard bundles the complete chat context plus tool metadata and performance data (tokens, caching ratio, latency), so you can analyze behavior consistently and repeatably.
You can also export the user prompts as a plain text list (one prompt per line) to replay the same sequence with the auto-chat utility and verify the system still behaves like yesterday.
See what your AI sees (no black box)
Test tools with an interactive UI and inspect what data your agents receive before you deploy anything.
- Live tool testing for available tools
- Input/parameter preview and validation
- Tool response visualization
- Usage tracking per agent
Knowledge base that improves over time
When customers ask new questions, missing information becomes a new Agent Log entry. You resolve it once (Answer + optional aliases/search terms) and agents can reuse it in future chats.
- Unresolved entries can still appear in searches (flagged as unresolved)
- Exact searchTerms (fallback) and tagAliases help prevent duplicates caused by wording variations
Built to avoid duplicated setup across plugins
This manager exists as a shared foundation so you do not end up configuring the same agent logic multiple times when you use multiple AI extensions.
Requirements / important notes
- An OpenAI API key is required (with API credits). The key must be configured for all sales channels you use.
- This is a base plugin. Without one of our AI plugins, it does not provide standalone storefront functionality.
- If you use the older plugin “Custom GPT Sales and Support Assistant – Chatbot, Shopping Helper”, uninstall it first to avoid conflicts.
- Shopware 6.7 compatible; updated to the OpenAI Responses API.
Documentation:
https://docs.5-elements.cloud/oai-assistants-manager/
Details
- Available: English, German
- Latest update: 9 February 2026
- Publication date: 25 June 2025
- Version: 2.0.7
- Category: Administration
Resources
Reviews (0)
About the Extension Partner
5 Elements Websolutions
Partner Status
-
Shopware
Extension Partner
Details
- Ø-Rating: 1
- Partner since: 2019
- Extensions: 9
Support
- Based in: Germany
- Speaks: German, English
- Response time: Very quickly