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 (Tarif Business API oder höher)
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. Der Aufruf landet auf
POST /api/v1/memory/entries.bashcurl -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
| 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: 100 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. |