Aufgaben

Erste Erinnerung anlegen

Eine Erinnerung ist die kleinste Wissens-Einheit in knowmind. Sie kann eine Notiz, ein Gesprächs-Memo, eine Definition oder eine Liste sein. Diese Anleitung zeigt drei Wege: über das Dashboard, über die Kommandozeile, über die API.

Zielgruppe
Alle neuen Nutzerinnen und Nutzer. Vorkenntnisse sind nicht erforderlich. Für die Wege 2 und 3 brauchen Sie zusätzlich die knowmind-CLI oder einen API-Token.

Voraussetzungen

  • Eingerichtetes knowmind-Konto (siehe Quickstart)
  • Aktiven Arbeitsbereich (wird beim Onboarding automatisch erzeugt)
  • Für Weg 2: knowmind-CLI installiert und angemeldet
  • Für Weg 3: API-Token (in jedem Tarif verfügbar, auch Privat)

Schritte

  1. 1

    Weg 1: Im Dashboard

    Im Dashboard im Bereich Schnellzugriff auf „Erinnerung anlegen" klicken — alternativ direkt zu /dashboard/memory/new.

    Im Formular sind folgende Felder Pflicht oder empfohlen:

    FeldPflichtHinweis
    TitelempfohlenEine Zeile, ohne Punkt am Ende
    InhaltjaMarkdown wird unterstützt
    Typempfohlensemantisch, episodisch, prozedural, referenz
    SchlagworteoptionalKomma-getrennt, zur späteren Filterung
    QuelleoptionalFreitext, z. B. „Teamsitzung 12.03.2026"

    Auf Speichern klicken.

    Ergebnis: Sie landen auf der Detail-Ansicht der neuen Erinnerung. Im Dashboard zählt die Statistik-Kachel um eins hoch.

  2. 2

    Weg 2: Aus der Kommandozeile

    bash
    # Kurze Notiz direkt aus stdin
    echo "Der nächste Quartalsbericht ist am 30.06. fällig." \
      | knowmind upload - --title "Quartalsbericht 2026 Q2"
    
    # Datei hochladen
    knowmind upload ./gesprächs-notiz.md --title "Workshop Müller 12.03.2026"

    Bei langen Texten teilt knowmind den Inhalt automatisch in sinnvolle Abschnitte auf, erzeugt für jeden Abschnitt eine Vektor-Einbettung und legt einen Knoten im Wissensgraph an.

    Ergebnis: Im Erfolgsfall gibt der Befehl die Memory-ID und die Anzahl der angelegten Abschnitte aus.

  3. 3

    Weg 3: Über die API

    Für eigene Anwendungen, Skripte oder Workflow-Tools wie n8n. Schreiben läuft über den MCP-Endpunkt POST /api/mcp/v1 (tools/call knowmind_store_memory) — denselben persistenten Weg wie CLI und KI-Clients. Der Eintrag wird dauerhaft indexiert (Postgres + Wissensgraph).

    bash
    curl -X POST https://knowmind.de/api/mcp/v1 \
      -H "Authorization: Bearer kmt_…" \
      -H "Content-Type: application/json" \
      -d '{
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "knowmind_store_memory",
          "arguments": {
            "title": "QM-Schulung Pflicht",
            "content": "Alle Service-Mitarbeitenden absolvieren die QM-Schulung jährlich.",
            "memory_type": "semantic",
            "tags": ["qm", "schulung"],
            "source": "internal-handbook"
          }
        }
      }'

    Ergebnis: JSON-RPC-Antwort mit der memory_id des dauerhaft indexierten Eintrags. Ein nahezu identischer Eintrag wird erkannt und nicht doppelt angelegt (deduplicated: true mit Verweis auf die bestehende ID).

Prüfung des Ergebnisses

Die Erinnerung wurde angelegt, wenn alle drei Bedingungen zutreffen:

  • Im Dashboard unter Letzte Aktivität erscheint „Erinnerung angelegt".
  • Die Statistik-Kachel Erinnerungen zählt um eins hoch.
  • Eine Suche nach einem Wort aus dem Inhalt liefert die neue Erinnerung.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
Speichern-Button bleibt grau (Dashboard)Pflichtfeld Inhalt ist leer oder Tarif-Limit erreicht.Inhalt eintragen. Wenn das Limit erreicht ist (Tarif Privat: 2.500 Erinnerungen), unter Tarif auf einen höheren Tarif wechseln.
knowmind upload: 403Token-Scope umfasst nicht write.Im Dashboard den Token bearbeiten und Scope write ergänzen.
API-Antwort 422 invalid memory_typeMemory-Typ außerhalb der zulässigen Werte.Zulässige Werte: semantic, episodic, procedural, reference, working, entity.
Erinnerung erscheint, aber Suche findet sie nichtIndexierung dauert wenige Sekunden. Auch bei sehr kurzen Notizen kann der semantische Treffer ausbleiben — dann wirkt der Volltext-Index (BM25).Mit einem direkten Wort aus dem Inhalt suchen. Falls dauerhaft erfolglos, mit knowmind stats die Erinnerungs-Zählung und mit knowmind health die Service-Verfügbarkeit prüfen.

Weiterführend