Allgemeine Einführung
Onyx (früher bekannt als Danswer) ist eine Open-Source-KI-Chat-Plattform, die vom onyx-dot-app-Team entwickelt wurde, um Unternehmen bei der Integration und Verwaltung von Dokumenten, Anwendungen und Mitarbeiterdaten zu unterstützen. Sie bietet umfangreiche Chat-Funktionen, unterstützt die Verbindung zu jedem Large Language Model (LLM) und synchronisiert Wissen und Zugriff über mehr als 40 Konnektoren (z. B. Google Drive, Slack, Confluence usw.). Onyx unterstützt die flexible Bereitstellung auf Laptops, lokalen Servern oder in der Cloud, mit einer kostenlosen MIT-Lizenz für die Community Edition und einer Enterprise Edition mit erweiterten Funktionen wie Single Sign-On (SSO) für Teams, die effizientes Wissensmanagement und KI-Unterstützung benötigen.
Funktionsliste
- Intelligenter AI-ChatInteraktion mit Unternehmensdokumenten und -daten durch natürliche Sprache.
- Plattformübergreifende SucheAbrufen der Wissensinhalte des Teams über mehrere Anwendungen hinweg.
- 40+ DatenanschlüsseAndocken von Tools wie Google Drive, Slack, Salesforce und anderen.
- Benutzerdefinierte AI-Agenten: Richten Sie einen KI-Assistenten mit exklusiven Tipps, Wissen und Aktionen ein.
- multimodale VerarbeitungUnterstützt eine breite Palette von Datentypen wie Text, Bilder usw.
- Beliebige LLM-Integration: Verbindung von externen oder selbst gehosteten großen Sprachmodellen.
- In-App-ZugangOnyx direkt in Slack, Teams und anderen Tools verwenden.
- SicherheitsmanagementBietet SSO, Rollenberechtigungen und Verschlüsselung.
- Werkzeuge für das WissensmanagementUnterstützung für Dokumentensätze, Abfrageverlauf und Nutzungsanalyse.
- Skalierbarer EinsatzHochverfügbarkeit über Docker oder Kubernetes.
Hilfe verwenden
Ablauf der Installation
Onyx unterstützt eine Vielzahl von Bereitstellungsmethoden, die folgende lokale Docker-Bereitstellung als Beispiel, detaillierte Beschreibung der Arbeitsschritte:
Vorbedingungen
- Installieren Sie Docker (Version 20.10+ empfohlen) und Docker Compose.
- Hardware-Anforderungen: Mindestens 4 GB RAM, 2-Kern-CPU, 8 GB RAM empfohlen.
- Netzwerkverbindung für das Herunterladen von Bildern und Abhängigkeiten.
Installationsschritte
- Code erhalten
Öffnen Sie ein Terminal und klonen Sie das Onyx-Repository:
git clone https://github.com/onyx-dot-app/onyx.git
Wechseln Sie in das Docker-Verzeichnis:
cd onyx/bereitstellung/docker_compose
- Konfiguration der Umgebung
- Die Standardkonfiguration läuft ohne Änderungen.
- Für Anpassungen (z. B. Änderung von LLMs oder Ports) bearbeiten Sie die
docker-compose.dev.yml
oder erstellen.env
um zum Beispiel einen Schlüssel hinzuzufügen:OPENAI_API_KEY=Ihr-openai-key
- Neue Dienste
Führen Sie den folgenden Befehl aus, um das Image zu ziehen und zu starten:
docker compose -f docker-compose.dev.yml -p onyx-stack up -d --pull always --force-recreate
- Der erste Durchlauf dauert 5-15 Minuten, je nach Netzwerk und Hardware.
- Überprüfen Sie den Status des Containers:
docker ps
sicher
api_server
, undweb_server
usw. ordnungsgemäß funktionieren.
- Zugangsplattformen
- Browser-Eingabe
http://localhost:3000
rufen Sie die Onyx-Oberfläche auf. - Für die erstmalige Nutzung ist die Eingabe eines LLM-API-Schlüssels (z. B. OpenAI-Schlüssel) erforderlich, die unter Einstellungen vorgenommen werden kann.
- Fehlerbehebung
- Wenn Sie nicht darauf zugreifen können, prüfen Sie das Protokoll:
docker protokolliert onyx-stack_api_server_1
- Wenn Sie wegen unzureichendem Speicher aufgefordert werden, passen Sie die Docker-Speicherzuweisung an (Docker Desktop > Einstellungen > Ressourcen).
Andere Einsatzmöglichkeiten
- Onyx-Wolke: Zugangcloud.onyx.app/signupRegistrieren Sie sich und nutzen Sie es ohne Installation.
- Kubernetes: Referenz
Einsatz/Helm
Katalog, der sich für den Einsatz in großem Maßstab eignet.
Hauptfunktionen
1. intelligenter KI-Chat
- Zugang zur SchnittstelleNachdem Sie sich angemeldet haben, klicken Sie auf der linken Seite auf "Chat".
- Auswählen einer DatenquelleMarkieren Sie das Zieldokument oder die Zielanwendung im linken Fenster.
- Fragen stellenGeben Sie eine Frage ein, z. B. "Wo sind die neuesten Projekte geplant?". .
- Anpassung der EinstellungenKlicken Sie auf das Zahnradsymbol, um LLM auszuwählen oder um die Parameter anzupassen.
- BuchführungKlicken Sie auf "Speichern", um den Dialog zu speichern.
2. plattformübergreifende Suche
- Zugang zur SucheKlicken Sie oben auf "Suchen".
- Schlüsselwörter eingeben:: z.B. "Verkaufsdaten 2024".
- Ergebnisse filternFilter nach Quelle (z. B. Google Drive) oder Zeit.
- Intelligente AntwortenAktivieren Sie "AI-Antwort", um eine zusammenfassende Antwort zu erhalten.
3. die Einrichtung des Datenanschlusses
- Verbindung hinzufügen: Gehen Sie zu "Verwaltung" > "Anschlüsse".
- Anwendung auswählenKlicken Sie auf das Ziel-Tool (z. B. Slack) und folgen Sie den Aufforderungen zur Autorisierung.
- Synchronisierte DatenLegen Sie das Synchronisationsintervall fest (z. B. stündlich) und speichern Sie die Konfiguration.
- validieren (eine Theorie)Testen Sie die Auffindbarkeit der neuen Daten in "Search".
4. die Anpassung von KI-Agenten
- Erstellen eines ProxysKlicken Sie auf "Neu" in "Verwaltung" > "KI-Assistenten".
- Tipps zur Konfiguration: Geben Sie Anweisungen wie "Beantworten Sie Fragen als HR-Experte".
- Verbindliche DatenWählen Sie das entsprechende Dokument oder den Anschluss.
- TestnutzungWechseln Sie zu dem neuen Agenten im "Chat" und geben Sie die Frage zur Überprüfung ein.
5. anwendungsinterner Zugriff
- Slack-Integration: Fügen Sie den Onyx Bot in Slack hinzu und autorisieren Sie ihn nach Aufforderung.
- Verwendung: Eingabe
@Onyx Finden Sie das Protokoll von gestern
und erhalten eine Antwort. - Teams UnterstützungÄhnlicher Prozess, erfordert Enterprise Edition-Berechtigungen.
Beispiel für den Betriebsablauf
Nehmen Sie: Hier finden Sie die neueste Dokumentation des Teams und können Fragen stellen.
- Melden Sie sich bei Onyx an und gehen Sie auf "Suchen".
- Geben Sie "Neueste Dokumente" ein und filtern Sie die Quelle auf "Confluence".
- Um die Ergebnisse zu sehen, prüfen Sie das Zieldokument.
- Schalten Sie auf "Chat" um und fragen Sie "Was sind die neuen Funktionen, die im Dokument erwähnt werden? Fragen Sie "Was sind die neuen Funktionen, die in den Dokumenten erwähnt werden?
- Holen Sie sich die KI-Antwort und klicken Sie auf "Teilen", um einen Link zum Teilen zu generieren.
Erweiterte Funktionen
- SicherheitseinstellungenEnterprise Edition unterstützt SSO (z.B. OAuth2), konfiguriert in "Admin" > "Sicherheit".
- VerwendungsanalysePrüfen Sie die Häufigkeit von Abfragen und beliebten Fragen in Analytics.
- MasseneinsatzKubernetes unterstützt die Verarbeitung von mehreren Millionen Dokumenten, siehe die offizielle Dokumentation.
Der Open-Source-Charakter von Onyx und die flexible Bereitstellung erleichtern den Einstieg, und die ausführliche Dokumentation und der Protokollierungssupport ermöglichen eine schnelle Problemlösung.