# ShinrAI für Onyx

Schützen Sie Fragen, abgerufene Unternehmensdokumente und unterstützte lokale Suchaufrufe vor der Modellverarbeitung. Modellschlüssel und optionale Wiederherstellung bleiben in Ihrer Umgebung.

1. Erstellen Sie einen ShinrAI-Schlüssel und entpacken Sie das Integrationspaket einschließlich des Verzeichnisses `python`.
2. Kopieren Sie `.env.example` nach `.env`. Beschränken Sie die Dateirechte mit `chmod 600 .env`. Tragen Sie ShinrAI-Schlüssel, vorhandenen Modellanbieter, Modellnamen, Modellschlüssel, einen eigenen zufälligen Relay-Schlüssel und den Onyx-Docker-Netzwerknamen ein.
3. Starten Sie in diesem Verzeichnis `docker compose up -d --build`.
4. Öffnen Sie in Onyx **Admin Panel → Configuration → Language Models → Add Custom LLM Provider**.
5. Anzeigename: **ShinrAI protected models**. Anbietername: **openai**. Basisadresse: **http://shinrai-relay:8080/v1**. API-Schlüssel: der **Relay-Schlüssel**.
6. Fügen Sie **shinrai-private** (Pseudonyme behalten) und **shinrai-restored** (erkannte Werte lokal wiederherstellen) hinzu. Aktivieren Sie nur Textverarbeitung. Prüfen Sie beide Verbindungen.
7. Wählen Sie ein geschütztes Standardmodell. Leiten Sie auch schnelle und ergänzende Modellaufrufe durch das Relay. In Onyx 4.7.1 bleibt das separate Modell für Chat-Titel leer; Onyx verwendet dann das geschützte Chat-Modell. Bei älteren Versionen mit eigenem Fast-Modell wählen Sie dort ebenfalls einen geschützten Alias.
8. Geben Sie nur geschützte Modelle für die gewünschten Benutzer frei. Entfernen Sie direkte Anbieter und ungeschützte Ersatzrouten. Verwenden Sie lokale Embeddings und lokale Suche. Externe Suche, externe Aktionen, Bildverarbeitung und Code-Ausführung gehören nicht zur Referenzkonfiguration.

Testen Sie mit einem Dokument: `Kontakt Max Mustermann: max.mustermann@example.org. Die ORBIT Servicestufe ist platinum.` Verwenden Sie den Namen auch im Dokumenttitel. Fragen Sie nach Servicestufe und E-Mail mit Quellenangabe und stellen Sie eine Folgefrage. Das private Modell zeigt Pseudonyme; das zweite Modell stellt erkannte Werte lokal wieder her. Prüfen Sie am kontrollierten Modellziel, dass Titel, Text und Werkzeugdaten geschützt sind und keine Zuordnung übertragen wird.

Originaldokumente, Fragen und Quellenangaben bleiben in Onyx. Geschützt werden die ausgehenden Modellaufrufe. Wiederhergestellte Werkzeugargumente dürfen nur lokal verwendet werden; weitere externe Übertragungen benötigen einen eigenen Schutzschritt.

Bei Verbindungsfehlern prüfen Sie das gemeinsame Docker-Netzwerk, den Relay-Schlüssel und `/v1` in der Basisadresse. Nicht unterstützte Inhalte und fehlgeschlagener Schutz stoppen den Aufruf. Aktivieren Sie keine ungeschützte Ersatzroute. Ein vorgeschalteter Proxy darf Streaming nicht puffern und sollte mindestens 300 Sekunden erlauben.

Referenzversion: **Onyx 4.7.1**. Die Verbindungstests sind live durchgeführt. Vollständige Anwendungstests und unabhängige Neuinstallation sind noch in Arbeit, bis der QA-Bericht sie bestätigt. Die getestete OpenAI-Route des vorhandenen Innovius-Anbieters scheiterte an der Umsetzung von Werkzeugverläufen; die Anthropic-Route bestand die Relay-Tests. Eine Marketplace-Veröffentlichung wird nicht behauptet. Connector-Lizenz: MIT.

## Geprüftes Beispiel

Die [Screenshots](screenshots/) stammen aus der tatsächlich installierten Testumgebung mit synthetischen Daten. Ersatzwerte können bei jedem Lauf anders aussehen. Die gemeinsamen Beispieldateien und ein ausführbarer Verbindungstest liegen im Ordner `../fixtures/` des Downloadpakets.