p101b

patch_history/RETRIEX_PATCH_101B_ADMIN_EVAL_CASE_HELP_TEXTS_README.md

@@ -0,0 +1,52 @@
+# RetrieX Patch p101b - Admin Eval Case Help Texts
+
+## Ziel
+
+Verbessert die Hilfetexte auf der Admin-Seite zum Erstellen neuer Eval-Cases, damit auch weniger technische Nutzer verstehen, welche Werte in welche Felder gehören.
+
+## Scope
+
+Geändert:
+
+- `templates/admin/evals/case_new.html.twig`
+
+Neu:
+
+- `patch_history/RETRIEX_PATCH_101B_ADMIN_EVAL_CASE_HELP_TEXTS_README.md`
+
+## Änderungen
+
+- Ausführlichere Beschreibungen unter allen Eingabefeldern
+- Laienfreundliche Erklärung der Eval-Typen
+- Beispiele für gute Case-IDs
+- Klarere Erklärung für Prompt vs. erwartete Antwort
+- Copy-Paste-Beispiele für Assert-JSON
+- Erklärung, wann History-JSON benötigt wird
+- Hinweis, dass Request Context Hint fast immer leer bleiben kann
+- Zusätzliche Checkliste vor dem Speichern
+
+## Nicht geändert
+
+- Keine Eval-Logik
+- Keine Retrieval-Logik
+- Keine Shopquery-Logik
+- Keine Follow-up-Logik
+- Keine Answer-Guard-Logik
+- Keine bestehenden Eval-Cases
+- Keine YAML- oder Parameteränderung
+- Keine Migration
+
+## Prüfung
+
+Nach Einspielen:
+
+```bash
+php bin/console mto:agent:config:validate
+```
+
+Dann im Admin prüfen:
+
+- `/admin/evals/cases/new`
+- Hilfetexte unter allen Feldern sichtbar
+- Vorlage aus Report-Result weiterhin nutzbar
+- Case speichern weiterhin möglich