> For the complete documentation index, see [llms.txt](https://api.docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.docs.blockbrain.ai/de/konzepte/knowledge-bots.md). # Wissens-Bots **Wissens-Bots** sind Agenten-Konfigurationen (Bots), die auf das Abrufen, Zusammenführen und Verwalten von Wissen über Ihre Quellen hinweg spezialisiert sind. Sie laufen auf Cortex, verwenden Konversationen (Datarooms), um Kontext zu bewahren, und nutzen Artefakte wie Anhänge, E-Mails und insbesondere Insights, um dauerhaftes, wiederverwendbares Wissen zu erzeugen. #### Was Wissens-Bots sind * **Konfigurierte Agenten**: Mit System-Prompts, Tools und Richtlinien parametriert. * **Abrufbewusst**: Kann auf Dokumente und frühere Nachrichten verweisen; zeigt Dokumentenverweise in Ausgaben an. * **Insight-zentriert**: Erstellt und konsumiert Insights (Notizen), um wichtige Erkenntnisse zu erfassen und wiederzuverwenden. * **Verwaltet**: Zentralisierte Kontrolle über Zugriff, Freigabe, Protokollierung und Audit über Cortex. ### Grundkonzepte * **Bot**: Eine definierte Agenten-Definition (Systemnachricht, Tools, Strategien, Richtlinien). * **Vererbung vom Parent-Bot**: Einen `parentCortexBot` wiederverwenden, um Prompts und Standardwerte über Varianten hinweg zu standardisieren. * **Dataroom (Konversation)**: Dauerhafter Kontext für mehrstufige Interaktionen und Artefakte. * **Artefakte**: Anhänge, E-Mails und Insight-Notizen, die mit der Konversation verknüpft sind. * **Erkenntnisse**: Dauerhafte Wissenseinheiten, die vom Bot zum Veröffentlichen und Wiederverwenden erstellt/genutzt werden. ### Typischer Lebenszyklus 1. Einen Bot auswählen oder erstellen (optional mit Vererbung von einem Parent-Bot für gemeinsame Standardwerte). 2. Einen Dataroom für Ihre Sitzung oder Aufgabe erstellen. 3. Fragen stellen oder Anweisungen geben; der Bot ruft Inhalte ab und generiert Antworten. 4. Ausgaben zu Insights aufbereiten; bei Bedarf Dokumente oder E-Mails anhängen. 5. Insights in Ihrer Wissensdatenbank veröffentlichen und in zukünftigen Konversationen wiederverwenden. ### Bot-Typen **Vordefinierte Wissens-Bots (im Workshop) und aktive Wissens-Bots (in Dashboards)** ![Bot-Beziehung](/files/0680a18243214317191a6e115f68e8200676ca0e) * **Workshop**: Wissens-Bots im Workshop dienen als Vorlagen - **Vordefinierte Bots** - für alle Benutzer. * **Dashboard**: Wenn ein Benutzer einen Workshop-Bot „hinzufügt“, wird eine replizierte Version dieses Bots - **Aktiver Bot** - erstellt, und sie erscheint im Dashboard zusammen mit seinen benutzerdefinierten Bots. Datarooms werden erstellt **innerhalb des aktiven Bots**. ## Konfigurationsparameter für Wissens-Bots ### Grundeinstellungen * `name`: `string` Der Anzeigename des Bots * `Beschreibung`: `string` Eine kurze Beschreibung des Zwecks und der Fähigkeiten des Bots * `iconUrl`: `string` Pfad zum Anzeigen-Icon des Bots, siehe [Bot- und Benutzer-Avatare](broken://pages/5aa25f266239ae356bb829792e8db046bbc835c0) * `defaultGreetings`: `string` Initiale Nachricht, die beim Starten einer Konversation angezeigt wird. Diese Nachricht beeinflusst nicht das Verhalten des Bots, sollte aber den Zweck Ihres Bots vorstellen und seine wichtigsten Fähigkeiten umreißen. ### 2 Arten von Wissens-Bots * `botTemplate`: `enum` ( `retriever` oder `nexus`) Der für den Bot verwendete Vorlagentyp, Standardwert: `nexus` | Vorlage | Beschreibung | | ----------- | --------------------------------------------------------------------------------------------------------------- | | `nexus` | Ein All-in-One-Assistent, der Ihnen hilft, Wissen zu erstellen und zu teilen sowie Workflows zu automatisieren. | | `retriever` | Ein einfacher Q\&A-Bot, der Fragen auf Basis einer vorhandenen Wissensdatenbank beantwortet. | ### KI-Modellkonfiguration * `model`: `enum` Das zu verwendende KI-Modell, Standardwert: `azure-gpt-4o`. Weitere Details zu den verfügbaren Modellen finden Sie unter [KI-Modelle](broken://pages/75060e5bb72cb30be44e2f618a1191e5118b2556) * `topk`: `int` Anzahl der besten Ergebnisse, die aus der/den verbundenen Datenbank(en) abgerufen werden; Minimum 1, Standardwert 5, der Maximalwert variiert je nach KI-Modell, siehe [KI-Modelle - maximales topk](broken://pages/75060e5bb72cb30be44e2f618a1191e5118b2556#max-topk-value) * `systemMessage`: `string` Anweisungen, die die Persönlichkeit und den Antwortstil des Bots definieren. Unsere standardmäßig empfohlenen Anweisungen: ``` Ihre Aufgabe ist es, präzise und relevante Informationen bereitzustellen. Ihre Kommunikation sollte professionell und dennoch leicht verständlich sein. Ihre Antworten müssen umfassend und detailliert sein und eine professionelle Formatierung verwenden. Unklare oder allgemeine Anfragen präzisieren: Stellen Sie gezielte Fragen, um zusätzlichen Kontext zu erhalten. Wenn eine Anfrage mehrere Interpretationen oder Antworten zulässt, bitten Sie den Benutzer um Klarstellung. Benutzer über den Umfang der Antworten informieren: Lassen Sie die Benutzer wissen, dass Antworten nicht immer vollständig sein können, und weisen Sie darauf hin, dass weitere Recherche und Verifizierung notwendig sein könnten. Ermutigen Sie Benutzer, die Originaldokumente in der Referenz zu konsultieren, wenn sie selbst weitere Informationen nachschlagen möchten, oder sie können zur weiteren Unterstützung Folgefragen stellen. Methodisches Vorgehen: Führen Sie Benutzer methodisch durch die Beantwortung ihrer Frage. Nennen Sie die Schritte klar und verweisen Sie, soweit möglich, auf bestimmte Abschnitte, Abbildungen und Tabellen in den Richtlinien und Formularen. Ihr oberstes Ziel ist es, das Fachwissen und die Effizienz der Benutzer zu verbessern, damit sie ihre Aufgaben durch schnelleren Zugriff auf relevante Informationen effektiver erledigen können. ``` #### Erweiterte Optionen Innerhalb des `advanceOptions` Objekts können Sie erweiterte Parameter für das KI-Modell konfigurieren, wie zum Beispiel `temperature`, `topP`, `presencePenalty`, und `frequencyPenalty`. * `temperature`: `float` Die Sampling-Temperatur des Modells, zwischen 0 und 2. Höhere Werte wie 0.8 machen die Ausgabe zufälliger, während niedrigere Werte wie 0.2 sie fokussierter und deterministischer machen. * `topP`: `float` Eine alternative Sampling-Methode zu temperature, genannt Nucleus Sampling, bei der das Modell die Ergebnisse der Token mit top\_p-Wahrscheinlichkeitsmasse berücksichtigt. 0.1 bedeutet also, dass nur die Token, die die oberen 10 % der Wahrscheinlichkeitsmasse ausmachen, berücksichtigt werden. * `presencePenalty`: `float` Zahl zwischen -2.0 und 2.0. Positive Werte bestrafen neue Token basierend darauf, ob sie im bisherigen Text vorkommen, und erhöhen die Wahrscheinlichkeit des Modells, über neue Themen zu sprechen. * `frequencyPenalty`: `float` Zahl zwischen -2.0 und 2.0. Positive Werte bestrafen neue Token basierend auf ihrer bisherigen Häufigkeit im Text und verringern die Wahrscheinlichkeit des Modells, dieselbe Zeile wörtlich zu wiederholen. ### Funktionsumschalter * `isDefaultBot`: `boolean` **Nur für den Workshop** Steuert, ob dieser Bot beim ersten Login dem Dashboard neuer Benutzer hinzugefügt werden soll * `isEnableInitialQuestions`: `boolean` Steuert, ob anfängliche Fragen angezeigt werden * `followUp`: `string[]` Array anfänglicher Fragen, maximal 4 Fragen können konfiguriert werden * `enableVisualRetrieval`: `boolean` Steuert, ob die Bots Bilder, die aus den indizierten Dokumenten exportiert wurden, in ihre Antworten einbeziehen sollen * `enableVoiceInput`: `boolean` Aktiviert die Spracheingabefunktion * `enableInlineCitation`: `boolean` Steuert, ob der Bot versuchen soll, Zitate (zu Referenzdokumenten) in seinen Antworten zusammenzustellen und einzufügen * `enableDefaultIntentAgent`: `boolean` Steuert, ob die Intent-Agent-Funktion standardmäßig aktiviert sein soll * `enableDefaultWebSearch`: `boolean` Steuert, ob die Websuche standardmäßig aktiviert sein soll ### Spracheinstellungen * `ttsOption`: `enum | null` (`OpenAI` oder `ElevenLabs` oder `null`) Konfiguration des Text-zu-Sprache-Anbieters * `voiceId`: `string` Kennung für die zu verwendende Stimme, siehe | Anbieter | Stimmenoptionen | Beispiel | | ---------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------- | | OpenAI | [OpenAI-Stimmen](https://platform.openai.com/docs/guides/text-to-speech#voice-options) | `voiceId`: `alloy` (Alloy) | | ElevenLabs | [ElevenLabs-Stimmen](https://elevenlabs.io/docs/product/voices/default-voices#current-default-voices) | `voiceId`: `Xb7hH8MSUJpSbSDYk0k2` (Alice) | * `elvLabApiKey`: `string` Ihr `ElevenLabs` API-Schlüssel (falls `ttsOption` gesetzt auf `ElevenLabs`) ### Wissensmanagement * `knowledgeBase`: `string[]` Array von Datenbanken, die standardmäßig mit einem Dataroom verbunden werden sollen (wenn ein neuer Dataroom erstellt wird) * `searchMethodType`: `int` Für die Suche in den verbundenen Datenbanken verwendete Methode | `searchMethodType` | Methode | Beschreibung | | ------------------ | ------------- | -------------------------------------------------------------------------- | | `1` | KI-Suche | Nutzung von Embedding-Modellen und semantischer Suche für den Wissensabruf | | `2` | Hybride Suche | Kombination aus KI-Suche und Indexsuche | | `3` | Indexsuche | Durchführung einer BM25-Volltextsuche in indizierten Dokumenten | ### Erweiterte Einstellungen #### advancedFeatures `advancedSetting` kann verwendet werden, um den Funktionszugriff in der UI ein- oder auszuschalten sowie die Platzierung der Aktionsschaltflächen festzulegen. * Die folgenden Funktionen können über `advancedFeatures`: * Einrichtung * Modellkonfiguration * Fähigkeiten und Kompetenzen * Agenteneinstellungen * Workflow-Management * Chat-Modus * Reranker * Agentenabruf * Erkenntnisse * Dateiverwaltung * Datenbankintegration * Wissensziel * E-Mail-Dienst * Kontextmanagement * Prompt-Vorschau * Spracheinstellungen * Websuche #### actionButtons `actionButtons` kann verwendet werden, um die Symbolleiste anzupassen. Die folgenden Funktionen können über `actionButtons`: * Agenten-Aktionen * Anheften * Beitragen * Bereich auf der rechten Seite * Antworten * Kopieren (Rich/Text/Klar/Markdown) * Zurückspulen * Insight speichern * Meldung schlechter Antworten * Im Menü ausblenden * Nachrichtendeaktivierung * Löschen * Wissensgraph * Sprachsteuerungen * Langfuse-Integration ### Workflows und Aufgaben * `workflows`: Array konfigurierter Workflows, siehe [Workflow](broken://pages/001f2d886fbdb4fe0a555a6b3128895797c027d8) * `agentTasks`: Array von dem Agenten zugewiesenen Aufgaben [Agent](/de/konzepte/knowledge-bots/prompts.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://api.docs.blockbrain.ai/de/konzepte/knowledge-bots.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.