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 (Tarif Business API oder höher)

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. Der Aufruf landet auf POST /api/v1/memory/entries.

    bash
    curl -X POST https://knowmind.de/api/v1/memory/entries \
      -H "Authorization: Bearer kmt_…" \
      -H "Content-Type: application/json" \
      -d '{
        "memory_type": "semantic",
        "title": "QM-Schulung Pflicht",
        "content": "Alle Service-Mitarbeitenden absolvieren die QM-Schulung jährlich.",
        "tags": ["qm","schulung"],
        "source": "internal-handbook"
      }'

    Ergebnis: HTTP 201 mit dem vollständigen Erinnerungs-Objekt einschließlich der ID. Bei Pflichtfeld-Verletzungen HTTP 422 mit detaillierter Fehlerbeschreibung.

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: 100 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