Files
MtoRagSystem/RETRIEX_SHOP_QUERY_LANGUAGE_FIX_README.md
2026-04-26 19:59:31 +02:00

1.7 KiB

RetrieX Shop Query Language Fix

Patch-only fix for v1.5.0.

Problem

The Shopware query optimizer could translate German user input into English, for example:

welchen testomat kann ich nutzen zur freien chlor messung

became:

testomat free chlorine measurement

This reduced Shopware hit quality because the shop catalog is primarily queried with German/domain terms.

Fix

  • Strengthens config/retriex/agent.yaml prompt rules so the optimized shop query must preserve the language of the current user input.
  • Adds configurable language-preservation settings under shop_prompt.language_preservation.
  • Adds a small post-optimizer repair step in AgentRunner that only applies configured replacements when the current user input matches configured language markers.
  • Keeps all translation/repair terms in YAML/fallback config, not as hard-coded product-specific logic in the Shop/Retrieval core.
  • Extends the effective config dump with the new language-preservation settings.

Example

testomat free chlorine measurement

is repaired to:

testomat freies chlor messung

for German input.

Safety

  • No Retrieval, Vector, Scoring, PromptBuilder, SearchRepair or Shopware API logic changed.
  • No Testomat-808-specific logic.
  • Product names, brands and model numbers remain preserved.
  • All new language repair rules are configurable in agent.yaml.

After installation

php bin/console cache:clear
php bin/console mto:agent:config:validate
php bin/console mto:agent:regression:test

Then retest:

welchen testomat kann ich nutzen zur freien chlor messung

The displayed shop query should stay German, e.g.:

testomat freies chlor messung