Checkliste — Dein eigener Assistent

Wofür diese Seite da ist: Alle Bausteine dieses Kurses als Prüfliste. Geh sie durch, bevor dein Assistent produktiv geht — und danach regelmäßig.

Eingang

• Jeder Kanal hat einen eigenen Eingang, der ins Einheitsformat übersetzt
• Nur echte Nutzernachrichten werden durchgelassen (keine Bots, keine Systemmeldungen, keine eigenen Antworten)
• Jede Nachricht hat eine nachricht_id; ohne ID keine Verarbeitung
• Der Webhook ist geschützt: geheime URL, Signaturprüfung oder IP-Freigabe (Kurs 8)

Router

• Doppelschutz über chat_nachricht mit INSERT OR IGNORE
• Berechtigung über assistent_nutzer anhand der technischen ID
• Not-Aus („pause“/„weiter“) als feste Regel, funktioniert auch ohne KI
• Feste Regeln stehen vor der KI-Erkennung
• KI-Erkennung mit Katalog, Verlauf und Lernbeispielen; Ausgabe als JSON
• emit_on_error ist gesetzt, Modellfehler führen zu einer ehrlichen Antwort
• Jede Schleife hat eine Abbruchbedingung
• Unsicherheit → Rückfrage mit Auswahl; zweite Unklarheit → ehrlicher Abbruch
• Risikostufe ≥ 2 → Bestätigung, mit Frist

Skills

• Jeder Skill hat einen Eintrag im Fähigkeiten-Katalog mit guter Beschreibung und drei bis fünf echten Beispielen
• Jeder Skill hält den Vertrag ein (antwort_text, vorgang_status, vorgang_id …)
• Jeder Skill hat eine vom Menschen festgelegte Risikostufe
• Nach außen wirkende Aktionen entstehen als Entwurf mit Freigabe
• Aktions-Skills melden ein prüfbares Ergebnis (Link, Nummer)
• Die Hilfe wird aus dem Katalog erzeugt

Gedächtnis

• Verlauf wird geschrieben (Nutzer und Assistent) und nur begrenzt geladen
• Vorgänge werden per Upsert fortgeschrieben; abgeschlossene Vorgänge werden nicht wieder geöffnet
• „Was läuft?“ zeigt offene Vorgänge
• Aktionsprotokoll für alles, was andere Systeme verändert
• Löschfristen für den Verlauf sind umgesetzt und dokumentiert

Lernen

• Auswahl bei Rückfragen erzeugt Lernbeispiele
• „nein, ich meinte …“ wird erkannt und erzeugt Lernbeispiele
• Muster werden normalisiert (Zeitangaben, Zahlen, Namen)
• Gelernte Treffer werden ohne KI zugeordnet
• Ähnliche Lernbeispiele stehen im Prompt der KI-Erkennung
• Der Assistent sagt, was er gelernt hat
• „was hast du gelernt?“ und „vergiss …“ funktionieren
• Gelerntes ändert nie Berechtigungen oder Risikostufen
• Bei mehreren Nutzern: Lernen zunächst pro Person
• Die Wunschliste (unbekannt) wird regelmäßig ausgewertet

Verlässliche Antworten

• Wissensantworten nur aus Suchtreffern, mit Quellen per Skript
• Zahlen kommen aus festen Definitionen im Kennzahlen-Katalog, mit Definition, Quelle und Datenstand
• Freie Abfragen laufen durch einen Prüfer
• „Nichts gefunden“ und „kann ich nicht“ sind klare, feste Antworten

Betrieb

• Gesundheitsprüfung für Systeme und Sprachmodell, Meldung nur bei Zustandswechsel
• Datenfrische je Quelle wird überwacht
• Ablaufdaten von Tokens und Zertifikaten sind erfasst
• Wöchentlicher Blick auf: Nutzung je Skill, Rückfragen, unbekannt, Fehler, neue Lernbeispiele
• Jeder Workflow hat eine Beschreibung mit Eingangsformat und Idempotenz-Schlüssel