knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Aufgaben

BYOK-Schlüssel hinterlegen

„Bring Your Own Key": Sie geben knowmind einen eigenen KI-Anbieter-Schlüssel mit, den knowmind für interne Anreicherungs- und Indexierungs-Aufgaben verwendet. Der Schlüssel wird mit AES-256-GCM verschlüsselt gespeichert und niemals an Dritte weitergegeben.

Zielgruppe
Privat-, Pro-, Business- und Business-API-Tarif (im Tarif Privat beschränkt auf einen Anbieter). Erforderlich, sobald knowmind selbst LLM-Aufrufe machen soll — etwa für die Anreicherung beim Dokumenten-Upload oder eigene Agenten-Läufe.

Voraussetzungen

  • Eingerichtetes knowmind-Konto im Tarif mit BYOK-Berechtigung
  • Aktiver API-Schlüssel bei einem unterstützten Anbieter (Anthropic, OpenAI, Google, Mistral, Aleph Alpha, Azure OpenAI, Ollama, LM Studio, vLLM)
  • Genügend Guthaben oder Abrechnungsmethode beim Anbieter

Schritte

  1. 1

    Anbieter-Schlüssel beschaffen

    Im Konto Ihres KI-Anbieters einen neuen API-Schlüssel erstellen. Bei den meisten Anbietern erscheint der Wert nur einmal — sofort in einen sicheren Zwischenspeicher kopieren.

    Ergebnis: Sie haben den Schlüssel in der Zwischenablage.

  2. 2

    Im knowmind-Dashboard hinterlegen

    Im knowmind-Dashboard auf BYOK-Schlüssel navigieren. Im UI heißt diese Seite „BYOK-Keys".

    Auf „Neuen Key hinzufügen" klicken. Anbieter aus dem Dropdown wählen, eine Beschreibung eintragen (z. B. „Anthropic Produktion"), den Schlüssel einfügen, optional ein Default-Modell auswählen und speichern.

    Ergebnis: Der Schlüssel erscheint in der Liste mit maskiertem Wert (zum Beispiel sk-ant-***-xx7K) und Anlage-Datum.

  3. 3

    Provider-Reihenfolge festlegen (optional, ab Pro)

    Wenn Sie mehrere Anbieter parallel hinterlegen, können Sie eine Reihenfolge festlegen. knowmind versucht den ersten erreichbaren Anbieter. Sinnvoll, wenn Sie einen lokalen Stack (Ollama, LM Studio) bevorzugen und einen Cloud-Anbieter als Fallback halten.

  4. 4

    Funktionstest

    Ein Dokument hochladen (siehe Dokumente hochladen). Wenn knowmind das Dokument anreichert (Entitäts-Extraktion, Zusammenfassung), nutzt es dafür den hinterlegten Schlüssel — im KI-Nutzungs-Cockpit erscheint ein Eintrag.

    Ergebnis: Im Dashboard unter KI-Nutzungs-Cockpit ist der Aufruf mit Provider, Modell, Token-Anzahl und Kosten sichtbar.

Prüfung des Ergebnisses

  • Der Schlüssel erscheint in der Liste unter BYOK-Schlüssel mit maskiertem Wert.
  • Ein Test-Aufruf (Dokumenten-Upload mit Anreicherung) verursacht einen Eintrag im KI-Nutzungs-Cockpit.
  • Im Audit-Log erscheint „KI-Schlüssel hinterlegt" mit Datum und Anbieter.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
Speichern-Button bleibt grauPflichtfeld fehlt oder Tarif erlaubt nur einen Anbieter und es ist schon einer hinterlegt.Pflichtfelder ausfüllen. Im Tarif Privat ist nur ein Anbieter gleichzeitig erlaubt — bestehenden zuerst löschen oder auf Pro/Business wechseln.
Schlüssel wird als ungültig abgewiesenTippfehler beim Einfügen, abgelaufenes oder widerrufenes Schlüssel-Material.Schlüssel beim Anbieter prüfen, gegebenenfalls neuen erzeugen und erneut hinterlegen.
Anreicherung läuft nicht durch, kein Eintrag im CockpitProvider-Endpunkt nicht erreichbar oder Quote überschritten.Anbieter-Status-Seite prüfen (z. B. status.anthropic.com). Bei Quote-Problemen Abrechnung beim Anbieter erhöhen.
Schlüssel-Eintrag verschwindet nach kurzer ZeitTarif-Limit auf einen Anbieter (Privat) — beim Anlegen eines neuen wird der alte überschrieben.Auf Pro oder höher wechseln, um mehrere Anbieter parallel zu halten.

Weiterführend