Feldbedeutung hinterlegen
jtl_feldbedeutung_setzen
Was das Tool macht
Hinterlegt (oder löscht) die fachliche Bedeutung eines Freifelds, Merkmals, einer Zahlungsart, Versandart, eines Lagers, Rückhaltegrunds oder einer Kundengruppe - dieselbe Pflege wie im Dashboard unter Verbindungen -> Felder & Merkmale. Geschrieben wird NUR in KI User, in JTL ändert sich nichts. Die Bedeutung gilt für alle MCP-Server dieser JTL-Verbindung und erscheint ab dem nächsten Tool-Aufruf neben den Werten, in jtl_feldbedeutungen und in den Server-Instructions. Zweistufig: Der erste Aufruf liefert eine Vorschau (Vorher/Nachher) und ein Bestätigungs-Token; erst der zweite Aufruf mit bestaetigung speichert wirklich. WICHTIG: Zeige die Vorschau dem Nutzer und lass dir das Speichern ausdrücklich bestätigen, bevor du das Token verwendest. Nutze dieses Tool für 'Merke dir, dass Feld X … bedeutet', 'Hinterlege für Versandart Y …', 'Beschreibe das Lager Z als …'.
Eingaben
| artPflicht | Was beschrieben wird |
| feldPflicht | Name des Felds/Eintrags (wie in jtl_feldbedeutungen), alternativ sein Schlüssel |
| beschreibungPflicht | Neue Bedeutung in Klartext (max. 2000 Zeichen). Leerer Text löscht die hinterlegte Bedeutung. |
| entitaetoptional | Nur bei Freifeldern: zu welcher Entität das Feld gehört (nötig, wenn der Name mehrfach vorkommt) |
| bestaetigungoptional | Token aus der Vorschau - erst damit wird tatsächlich gespeichert. Nur nach Freigabe durch den Nutzer verwenden. |
Die Eingaben füllt die KI aus deiner Frage. Du musst dir keine Parameternamen merken.
So wird gerechnet
Der Rechenweg in der Reihenfolge, in der das Tool arbeitet: Abruf, Filter, Berechnung, Ausgabe. Aus dem Tool-Code abgeleitet, damit nachvollziehbar ist, warum eine Zahl so ist. Dieselbe Auskunft liefert das Tool kiuser_tool_logik direkt im KI-Chat.
- 1Löst die Eingabe über den Feldkatalog der Verbindung auf: erst exakter Schlüssel, dann exakter Name (ohne Groß/Klein), zuletzt Namens-Teiltreffer; bei Freifeldern optional eingegrenzt auf die Entität Artikel, Kunde oder Auftrag.
- 2Kein Treffer oder mehrere Treffer sind ein Fehlerfall - bei Mehrdeutigkeit werden bis zu 15 Kandidaten mit Name, Schlüssel, Entität und Gruppe zurückgegeben, gespeichert wird nichts.
- 3Der erste Aufruf ist immer nur eine Vorschau: bisherige und neue Bedeutung nebeneinander plus ein 15 Minuten gültiges, einmal verwendbares Bestätigungs-Token.
- 4Erst der zweite Aufruf mit dem Token speichert - vorher wird geprüft, dass Eingaben und Ausgangsstand exakt der bestätigten Vorschau entsprechen (wurde die Bedeutung zwischenzeitlich z. B. im Dashboard geändert, wird abgebrochen).
- 5Gespeichert wird in der KI-User-Datenbank je Verbindung (dieselbe Pflege wie im Dashboard unter Verbindungen -> Felder & Merkmale); ein leerer Text löscht den Eintrag; Beschreibungen sind auf 2.000 Zeichen begrenzt.
- 6Die Bedeutung wirkt ab dem nächsten Tool-Aufruf für alle MCP-Server der Verbindung: neben den Werten in Tool-Antworten, in jtl_feldbedeutungen und in den Server-Instructions.
Annahmen und Grenzen
- In JTL wird nichts geschrieben oder gelesen außer dem Feldkatalog - das Tool pflegt ausschließlich die in KI User hinterlegten Bedeutungen.
- Nur auf Servern mit erlaubten schreibenden Tools verfügbar; das JTL-Schreib-Add-on, Freigaben und Schreiblimits sind nicht nötig, da JTL unberührt bleibt.
- Der Feldkatalog ist eine Stunde gecacht - ganz neue Felder aus JTL sind erst nach Ablauf oder nach „Felder neu laden“ im Dashboard auffindbar.
- Je Aufruf wird genau ein Eintrag gepflegt; eine Historie mit Wiederherstellung gibt es für Bedeutungen nicht (die Vorschau zeigt den überschriebenen Text).
So sieht eine Antwort aus
Vorschau für die Versandart „DHL Paket Export“ – noch nichts gespeichert: • Bisherige Bedeutung: (keine hinterlegt) • Neue Bedeutung: „Nur für Lieferungen außerhalb der EU, Zollpapiere nötig, keine Inselzustellung“ Gespeichert wird nur in KI User, in JTL ändert sich nichts. Die Bedeutung erscheint danach in allen Tool-Antworten neben der Versandart. Soll ich das so hinterlegen?
In wenigen Minuten die erste Antwort aus deinen JTL-Daten.
Sieben Tage kostenlos testen, ohne Kreditkarte und ohne Kündigungsfrist.