3.2 KiB
Hotfix: vereinfachte GLPI-KB-Auto-Reply-Freigabe
Ziel
Die Grundfreigabe eines GLPI-Wissensartikels ist vollständig von der fachlichen Eignungsprüfung getrennt.
Neue Freigaberegel
Artikel mit GLPI-Knowledge-Base-Kategorie
Ein Artikel ist grundsätzlich für Auto-Reply freigegeben, wenn mindestens eine seiner GLPI-KB-Kategorie-IDs in dieser Liste steht:
GLPI_KB_AUTO_REPLY_CATEGORY_IDS=4,7
ITIL-/Ticketkategorien spielen für diese Grundfreigabe keine Rolle.
Artikel ohne GLPI-Knowledge-Base-Kategorie
Ein unkategorisierter Artikel ist nur freigegeben, wenn beide Bedingungen erfüllt sind:
GLPI_KB_AUTO_REPLY_ALLOW_UNCATEGORIZED=true
GLPI_KB_AUTO_REPLY_UNCATEGORIZED_ARTICLE_IDS=1,5
Die IDs sind die numerischen GLPI-KnowbaseItem-IDs. GLPI-KB-1 entspricht Artikel-ID 1.
Veraltete Variable
GLPI_KB_AUTO_REPLY_ITIL_CATEGORY_IDS=
Die Variable wird aus Kompatibilitätsgründen noch eingelesen, aber nicht mehr ausgewertet. Ist sie befüllt, schreibt der Agent eine Warnung ins Log. Der Wert sollte geleert oder die Variable entfernt werden.
Fachliche Eignung bleibt separat
Nach der Grundfreigabe müssen weiterhin alle fachlichen und technischen Gates bestehen:
- Retrieval-Floor,
- KI-Auswahl,
- KI-Confidence,
- finale Knowledge-Evidenz,
- Sprache und Kommunikationsstil,
- Antwortinhalt,
- Kontext- und Incident-Regeln,
- vorhandene Followups,
- Dry-Run-/Live-Schreibregeln.
Soweit GLPI ein Mapping von KB-Kategorien auf ITIL-Kategorien liefert, wird es nur für die separate Prüfung „Artikel passt zur effektiven Ticketkategorie“ und für Kategorie-Evidenz verwendet. Fehlt das Mapping oder ist der Kategorie-Endpunkt nicht erreichbar, läuft der KB-Sync weiter; die Freigabe über die KB-Kategorie bleibt gültig.
Neue Diagnoseentscheidungen
glpi_kb_auto_reply_approved: Freigabe über eine GLPI-KB-Kategorie.glpi_kb_uncategorized_article_approved: Freigabe eines unkategorisierten Artikels über seine konkrete Artikel-ID.glpi_kb_category_not_whitelisted: Keine Artikel-KB-Kategorie steht in der Allowlist.glpi_kb_article_without_category: Artikel ist unkategorisiert, aber der Fallback ist deaktiviert.glpi_kb_uncategorized_article_not_whitelisted: Unkategorisierter Artikel ist nicht explizit freigegeben.glpi_kb_auto_reply_whitelist_empty: Für kategorisierte Artikel ist keine KB-Kategorie freigegeben.
Die Policyentscheidung bei fehlender Grundfreigabe lautet jetzt:
reply_knowledge_auto_reply_not_approved
Cache-Migration
Der GLPI-KB-Cache enthält eine Policy-Version. Caches aus der vorherigen ITIL-basierten Freigabelogik werden aus Sicherheitsgründen nicht geladen. Beim nächsten erfolgreichen GLPI-KB-Sync wird data/glpi-kb-cache.json automatisch im neuen Format erstellt.
Empfohlene Konfiguration
AUTO_REPLY=true
KNOWLEDGE_ALLOWED_SOURCES=internal-kb,glpi-kb
KNOWLEDGE_AUTO_REPLY_SOURCES=internal-kb,glpi-kb
GLPI_KB_ENABLED=true
GLPI_KB_AUTO_REPLY=true
# Kategorisierte Artikel
GLPI_KB_AUTO_REPLY_CATEGORY_IDS=4,7
# Unkategorisierte Artikel
GLPI_KB_AUTO_REPLY_ALLOW_UNCATEGORIZED=true
GLPI_KB_AUTO_REPLY_UNCATEGORIZED_ARTICLE_IDS=1,5
# Veraltet; leer lassen
GLPI_KB_AUTO_REPLY_ITIL_CATEGORY_IDS=