Zum Inhalt
DokumentationAnleitungAnbindungReferenzFehlerbehebung
DEEN

Aufgaben

Dokumente hochladen

Lange Texte und PDF lassen sich direkt nach knowmind übertragen. knowmind zerlegt das Dokument in sinnvolle Abschnitte, erzeugt Vektor-Einbettungen je Abschnitt und macht den Inhalt damit semantisch durchsuchbar.

Zielgruppe
Alle Tarife. Empfohlen, sobald Sie strukturierte Quellen wie Handbücher, Verträge oder Whitepaper im Wissensspeicher pflegen möchten.

Voraussetzungen

  • Eingerichtetes knowmind-Konto
  • Dokument im Format Markdown, Klartext oder PDF (Text-PDF, keine reinen Scan-PDFs ohne OCR)
  • Maximale Größe pro Dokument: 10 MB
  • Für die CLI-Variante: knowmind-CLI installiert und angemeldet
Hinweis

Wann ein Dokument, wann eine Erinnerung?

Erinnerungen sind kurz (eine Notiz, ein Memo). Dokumente sind länger (Handbuch-Kapitel, Vertrag, Spezifikation). knowmind wählt für Dokumente automatisch das Chunking — eine Erinnerung bleibt eine Einheit.

Schritte

  1. 1

    Weg 1: Im Cockpit

    Im Cockpit auf Dokumente navigieren. Dort auf „Dokument hochladen“ klicken, eine Datei auswählen, optional einen Titel überschreiben und bestätigen.

    Ergebnis: Das Dokument erscheint in der Liste mit Status Hochgeladen, wechselt nach einigen Sekunden auf Indexiert und ist dann mit Status Bereit durchsuchbar.

  2. 2

    Weg 2: Aus der Kommandozeile

    bash
    # Einzelne Datei
knowmind upload ./handbuch-einarbeitung.md --title "Einarbeitungs-Handbuch v3"

# Alle Markdown- und Text-Dateien aus einem Ordner
knowmind sync ./docs

    knowmind sync rechnet pro Datei einen Inhalts-Hash und überträgt nur das, was sich seit dem letzten Lauf geändert hat. Welche Datei welchen Stand hat, merkt sich der Client im Ordner selbst, in .knowmind-manifest.json. Diese Datei gehört in die Ausschluss-Liste Ihrer Versionskontrolle.

    Ergebnis: Pro hochgeladenem Dokument erscheint eine Erfolgsmeldung mit Memory-ID und Anzahl der erzeugten Abschnitte.

  3. 3

    Weg 3: Über die API

    Für eigene Anwendungen geht der Upload auf POST /api/documents:

    bash
    curl -X POST https://knowmind.de/api/documents \
  -H "Authorization: Bearer kmt_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "QM-Handbuch",
    "content": "<vollständiger Markdown-/Text-Inhalt>",
    "source": "internal-handbook-v3"
  }'

    Für sehr große Dokumente erfolgt die Chunking-Verarbeitung asynchron — die API liefert sofort eine documentId, der Status wird über die Dokumenten-Liste sichtbar.

  4. 4

    PDF hochladen

    PDFs werden im Cockpit direkt akzeptiert. knowmind extrahiert den Text-Layer; bei Scan-PDFs ohne OCR funktioniert das nicht verlässlich. Wenn das Ergebnis lückenhaft ist, das PDF vorher mit einem OCR-Werkzeug (etwa Adobe Acrobat oder Tesseract) aufbereiten und das Ergebnis als Markdown oder Text hochladen.

Prüfung des Ergebnisses

  • Im Cockpit unter Dokumente steht der Status Bereit.
  • Die Statistik-Kachel Erinnerungen ist um die Anzahl der erzeugten Abschnitte gestiegen.
  • Eine Suche nach einem Begriff aus dem Dokument liefert mindestens einen Abschnitt mit Quellenverweis auf das Dokument.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
Upload schlägt mit „file too large“ fehlDokument größer als 10 MB.Dokument in zwei oder mehr Teile splitten und einzeln hochladen.
Status bleibt auf „Indexiert“ hängenDie Indexierung im Hintergrund läuft noch oder ist ins Stocken geraten.Einige Minuten warten und die Seite neu laden. Bleibt der Status stehen, schreiben Sie an info@knowmind.de und nennen Sie das Dokument.
PDF liefert leeren InhaltScan-PDF ohne OCR-Text-Layer.Mit einem OCR-Werkzeug Text extrahieren und stattdessen als Markdown oder Text hochladen.
knowmind sync: „permission denied“Manifest-Datei nicht beschreibbar.Dateirechte des Manifest-Pfads prüfen, anderen Pfad wählen oder Manifest löschen und neu erzeugen lassen.

Weiterführend