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.
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
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:
Feld Pflicht Hinweis Titel empfohlen Eine Zeile, ohne Punkt am Ende Inhalt ja Markdown wird unterstützt Typ empfohlen semantisch, episodisch, prozedural, referenz Schlagworte optional Komma-getrennt, zur späteren Filterung Quelle optional Freitext, 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
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
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).bashcurl -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_iddes dauerhaft indexierten Eintrags. Ein nahezu identischer Eintrag wird erkannt und nicht doppelt angelegt (deduplicated: truemit 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
| Fehlermeldung | Ursache | Auflö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: 403 | Token-Scope umfasst nicht write. | Im Dashboard den Token bearbeiten und Scope write ergänzen. |
| API-Antwort 422 invalid memory_type | Memory-Typ außerhalb der zulässigen Werte. | Zulässige Werte: semantic, episodic, procedural, reference, working, entity. |
| Erinnerung erscheint, aber Suche findet sie nicht | Indexierung 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. |