# Fehlerbehebung

{% hint style="info" %}
Wenn Sie Probleme mit der Nutzung eines Knowledge Bots haben (verbundene Daten, Prompting, Chatroom-Probleme, Bot-Einschränkungen), besuchen Sie bitte die Seite: „Fehlerbehebung“ im Bereich für Benutzer.
{% endhint %}

## Problemlösungsprozess

Wenn Probleme mit den Blockbrain Knowledgebots auftreten, folgen Sie bitte diesem Eskalationspfad für eine effiziente Problemlösung:

### 1. Selbsthilfe-Ressourcen

Versuchen Sie zunächst, das Problem selbstständig mit diesen Ressourcen zu lösen:

* **Blockbrain Benutzerhandbuch**
  * Fehlermeldungen und häufige Probleme prüfen
  * Schritt-für-Schritt-Lösungen durchgehen
  * Empfohlene Korrekturen befolgen
* **Blockbrain Benutzerhandbuch-Bot**
  * Stellen Sie direkte Fragen
  * Erhalten Sie sofortige automatisierte Antworten
  * Zugriff auf spezifische Anleitungen zur Problemlösung

{% hint style="info" %}
Den Blockbrain Benutzerhandbuch-Bot finden Sie als Standard-Bot auf Ihrem Dashboard.
{% endhint %}

### 2. Interner Support

Wenn Selbsthilfe-Ressourcen Ihr Problem nicht lösen, eskalieren Sie intern:

1. **Kontaktieren Sie Ihren Company Builder**
   * Detaillierte Problembeschreibung teilen
   * Relevante Screenshots bereitstellen
   * Bereits unternommene Schritte erläutern
2. **Kontaktieren Sie Ihren Company Admin**
   * Eskaliere, wenn der Builder das Problem nicht lösen kann
   * Bisherige Kommunikation bereitstellen
   * Alle versuchten Lösungen im Detail beschreiben

### 3. Blockbrain Expertensupport

Das Blockbrain-Team ist immer für Sie da, um bei komplexen Problemen zu helfen, die über andere Kanäle nicht gelöst werden konnten. Melden Sie sich gerne, wenn:

* Sie Selbsthilfe-Ressourcen und interne Support-Optionen ausgeschöpft haben
* Ihr Company Admin eine Eskalation empfiehlt
* Sie spezielle Fachkenntnisse für Ihren konkreten Fall benötigen

Unser engagiertes Team hilft Ihnen gerne bei:

* Tiefgehender technischer Analyse
* Individuellen Lösungen
* Expertenberatung

{% hint style="warning" %}
Dieser strukturierte Ansatz hilft uns, Ihnen den schnellsten und effektivsten Support wie möglich zu bieten. Unser Team ist zwar immer bereit zu helfen, doch viele Probleme lassen sich schnell über Selbsthilfe- oder interne Support-Kanäle lösen, sodass Sie wertvolle Zeit sparen.
{% endhint %}

## Der Bot erzeugt nicht die gewünschten Antworten – was kann ein Builder tun, um das zu beheben?

Wenn Ihr Bot nicht die erwarteten Ergebnisse liefert, ziehen Sie die folgenden Lösungen in Betracht:

#### Prompts auf Englisch und knapp halten

* Stellen Sie sicher, dass alle Prompts in klarem, prägnantem Englisch verfasst sind, um optimale Leistung zu erzielen. Dies ist besonders wichtig in den ersten Anweisungen, in der Prompt-Bibliothek und in Workflow-Prompts.

#### Probleme mit der Vektordatenbankquelle

* Prüfen Sie auf sich überschneidende oder ungeordnete Daten in der Quelle der Vektordatenbank.
* Stellen Sie sicher, dass die Daten für die KI-Verarbeitung ausreichend und zugänglich sind.
* Achten Sie auf die Kurzzeit- und Langzeitgedächtnisfähigkeiten des Bots. (verbundene Dateien vs. Datenbankquellen – weitere Informationen finden Sie unter „How to use a Knowledgbot“)
* Überprüfen Sie die korrekten Verfahren zur Dateneingabe.

### Intent-Agent

{% hint style="danger" %}
Haben Sie den Intent-Agent schon verwendet, um bessere Retrieval-Ergebnisse zu erzielen?
{% endhint %}

#### Best Practices

1. **Komplexe und große Ordner vermeiden**:
   * Organisieren Sie Dateien in klar definierte Unterordner, basierend auf bestimmten Themen, Schwerpunkten oder Kategorien.
   * *Beispiel*: Teilen Sie einen großen Abteilungsordner in kleinere Unterordner auf, z. B. projektspezifische Unterordner für die gesamte Vertriebsabteilung.
2. **Ordner-Tiefe begrenzen**:
   * Halten Sie Ordnerstrukturen flach, mit maximal vier Ebenen.
     * *Beispiel*:
       * Hauptordner → 1. Unterordner
       * Unterordner Nr. 1 → 2. Unterordner
       * Unterordner Nr. 2 → 3. Unterordner
       * Unterordner Nr. 3 → 4. Unterordner
3. **Datenbankquellen sauber halten**:
   * Entfernen Sie regelmäßig Duplikate, ungenutzte Dokumente und andere unnötige Dateien, um die Datenbankquelle organisiert und effizient zu halten.
4. **Einheitliche Beschriftung**:
   * Erstellen Sie ein standardisiertes Benennungsschema für Dateien, einschließlich relevanter Schlüsselwörter und gegebenenfalls Datumsangaben.
5. **Sicherstellen, dass Dateien vollständige Informationen enthalten**:
   * Stellen Sie sicher, dass alle Dokumente die notwendigen Details enthalten, um potenzielle Anfragen zu beantworten.
     * *Beispiel A*: Beschriften Sie Vorlagen für Unternehmensdokumente eindeutig und fügen Sie das Wort „Vorlage“ im Dateinamen hinzu.
     * *Beispiel B*: Fügen Sie in Dokumenten die Verantwortlichkeiten und den Umfang jedes Teams oder jeder Abteilung hinzu, damit die KI Benutzer zu den richtigen Ressourcen leiten kann.
6. ***K*****nüpf relevante Datenbankquellen**:
   * Verknüpfen Sie relevante Datenbankquellen mit Ihrem Data Room, um konsistente und genaue Antworten bereitzustellen.
7. ***S*****tart klein**:
   * Konzentrieren Sie sich zunächst auf das Erstellen von Ordnerbeschreibungen für komplexe Ordner, streben Sie dabei jedoch weiterhin an, alle Ordner klar und beschreibend zu gestalten.
8. **Größe der Datenbankquelle angemessen verwalten**:
   * Sie können bis zu 1.000 Ordner mit Beschreibungen erstellen, ohne an Genauigkeit einzubüßen. Es ist jedoch am besten, die Ordnerstruktur schrittweise zu erweitern, um eine gut organisierte Datenbankquelle beizubehalten.

#### Best Practices für Ordnerbeschreibungen

1. **Kontext bereitstellen**:
   * Beschreiben Sie den Inhalt des Ordners klar und erklären Sie, wie die Informationen verwendet werden können.
2. **Beschreibungen kurz halten**:
   * Beschränken Sie Ihre Beschreibungen auf 500–800 Zeichen, um Klarheit und Lesbarkeit zu gewährleisten.
3. ***V*****erwenden Sie Schlüsselwörter**:
   * Fügen Sie Wörter ein, die üblicherweise mit dem Inhalt des Ordners verbunden sind. Diese Schlüsselwörter verbessern die Suchgenauigkeit und Kategorisierung.
4. **Direkt sein**:
   * Vermeiden Sie unnötige Einleitungen und konzentrieren Sie sich auf die wesentlichen Details des Ordnerinhalts.
   * **Beispiel**:
     * *Vorher*: Der Ordner „{{folder name}}“ enthält wichtige Dateien.
     * *Nachher*: Dieser Ordner enthält Dateien, die sich auf XYZ beziehen.

#### Bot-Kreativität verbessern

* Wählen Sie Nexus für bessere kreative Ergebnisse aus.

<figure><img src="/files/4c1eba87f021e56d68aaddee5a798f420bb626a4" alt=""><figcaption></figcaption></figure>

* Wählen Sie im Einstellungsmenü das richtige Sprachmodell (LLM) aus.

<figure><img src="/files/11de857cedb7bc39bb36b561c57ffccecab81715" alt=""><figcaption></figcaption></figure>

* Passen Sie die Modellmodifikatoren in den Einstellungen an, um die Leistung der einzelnen KI zu optimieren.

<figure><img src="/files/99a60616c0889419da9660062d556766de4ee1cc" alt=""><figcaption></figcaption></figure>

* Wählen Sie die für Ihren Anwendungsfall am besten geeignete Suchmethode aus (siehe „how build a knowledgebot for more information).

<figure><img src="/files/18236bd1c54de47805d493cbcb9a1d56ee0c1c69" alt=""><figcaption></figcaption></figure>

## Probleme beim Teilen von Bots

Um Probleme beim Teilen von Bots zu vermeiden:

#### Bots im Workshop erstellen

* Erstellen Sie Bots, die zum Teilen bestimmt sind, immer im Workshop und nicht direkt im Dashboard.
* Nur im Workshop erstellte Bots können geteilt werden.

#### Benutzerberechtigungen

* Stellen Sie sicher, dass Benutzer über die richtigen Berechtigungen für den Bot und die zugehörigen Datenbankquellen verfügen.

## Fehlende Funktionen oder Informationsüberflutung im Chatbot

#### Aktioneinstellungen verwalten

* Verwenden Sie Schalter in den Aktioneinstellungen, um bestimmte Funktionen zu aktivieren oder zu deaktivieren und die Funktionalität des Chatbots zu optimieren.
* Aktivieren Sie nur die Schalter, die für Ihren Anwendungsfall wesentlich sind.
* Deaktivieren Sie unnötige Schalter, um die Einfachheit und Effizienz des Bots zu erhalten.

<figure><img src="/files/02092b05def3bd5fb3b484799ccc74d3cfa81b01" alt=""><figcaption></figcaption></figure>

Wenn Sie diese Schritte zur Fehlerbehebung befolgen, können Sie häufige Probleme in der Builder-Rolle Ihres Tools beheben und so optimale Leistung und Benutzerzufriedenheit sicherstellen.


---

# Agent Instructions: 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://docs.en.theblockbrain.ai/de/fur-entwickler/fehlerbehebung.md?ask=<question>
```

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.
