Files
MtoRagSystem/RETRIEX_PATCH_53_CONFIG_LAYOUT_CLEANUP_README.md
2026-05-06 16:02:42 +02:00

3.3 KiB

RetrieX Patch p53 - Config Layout Cleanup / Shop Runtime Grouping

Ziel

Dieser Patch gruppiert bestehende Shop-Runtime-Konfiguration in config/retriex/agent.yaml unter shop_runtime, ohne fachliche Logik zu ändern.

Der Patch ist rein mechanisch:

  • keine neue Profil-/Layer-Architektur
  • keine neuen Defaults
  • keine neuen Token-/Stringlisten
  • keine Ranking-, Retrieval- oder Shopware-Kriterienänderung
  • keine LLM-Verhaltensänderung

Geänderte Dateien

  • config/retriex/agent.yaml
  • config/retriex/vocabulary.yaml
  • src/Config/AgentRunnerConfig.php
  • src/Config/RetriexEffectiveConfigProvider.php

Neue Gruppierung

Die bisherigen Runtime-Blöcke wurden wie folgt verschoben:

Alter Pfad Neuer Pfad
direct_shop_result_answer shop_runtime.direct_answer
shop_prompt.current_input_preservation shop_runtime.query_cleanup.current_input_preservation
shop_prompt.query_stopword_cleanup shop_runtime.query_cleanup.stopword_cleanup
shop_prompt.product_attribute_query_cleanup shop_runtime.attribute_cleanup
shop_prompt.context_usage shop_runtime.context_resolution.context_usage
shop_prompt.context_anchor_enrichment shop_runtime.context_resolution.history_anchor_enrichment
shop_prompt.meta_query_guard shop_runtime.context_resolution.meta_query_guard
shop_prompt.rag_anchor_enrichment shop_runtime.context_resolution.rag_anchor_enrichment
shop_prompt.direct_result_guard shop_runtime.result_identity
shop_prompt.length_sort shop_runtime.answer_constraints.length_sort
shop_prompt.length_filter shop_runtime.answer_constraints.length_filter

final_answer_guard bleibt bewusst außerhalb von shop_runtime, weil er allgemeiner Runtime-/LLM-Ausgabeschutz ist.

shop_prompt enthält nach dem Cleanup nur noch den eigentlichen Shop-Query-Optimizer-Prompt und dessen Sprach-/Prompt-Regeln.

Vocabulary Views

Die Vocabulary-View-Pfade wurden passend zur neuen Layout-Struktur umbenannt, ohne die zugrunde liegenden Listen zu verändern:

  • agent.shop_prompt.current_input_preservation_terms -> agent.shop_runtime.query_cleanup.current_input_preservation_terms
  • agent.shop_prompt.context_anchor_enrichment.trigger_terms -> agent.shop_runtime.context_resolution.history_anchor_enrichment.trigger_terms

Die referenzierten Term-Gruppen bleiben unverändert.

Lokale Prüfungen

Ausgeführt im entpackten Patch-Arbeitsstand:

php -l src/Config/AgentRunnerConfig.php
php -l src/Config/RetriexEffectiveConfigProvider.php
python3 - <<'PY'
import yaml
for f in ['config/retriex/agent.yaml', 'config/retriex/vocabulary.yaml']:
    yaml.safe_load(open(f, encoding='utf-8'))
PY

Zusätzlich wurde per YAML-Strukturvergleich geprüft, dass die verschobenen Runtime-Blöcke ihre bisherigen Werte behalten. Nur die zwei Vocabulary-View-Pfadnamen wurden mechanisch an das neue Layout angepasst.

Nicht lokal ausführbar

Die Symfony-Console-Checks konnten in dieser Umgebung nicht vollständig ausgeführt werden, weil der ZIP-Stand kein vendor/ enthält.

Empfohlene Projektchecks nach Einspielen

bin/console cache:clear
bin/console mto:agent:config:validate
bin/console mto:agent:regression:test
bin/console mto:agent:config:audit-source --details
bin/console mto:agent:config:audit-patterns --details