> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Einrichtung

> Schritt-für-Schritt-Anleitung zur Erstellung Ihres ersten Chatbots mit dem Einrichtungsassistenten

## Überblick

Der Einrichtungsassistent führt Sie in wenigen Minuten durch die Erstellung eines vollständig konfigurierten KI-Agenten. Der Prozess entdeckt automatisch Ihre Website-Inhalte, extrahiert Ihre Markenfarben und trainiert Ihren Agenten auf Ihrer Wissensdatenbank.

<Tip>
  Der Einrichtungsassistent ist darauf ausgelegt, Sie schnell startklar zu machen. Sie können Ihren Agenten nach der Ersteinrichtung jederzeit anpassen und weitere Inhalte hinzufügen.
</Tip>

## Der 4-Schritte-Prozess

<Steps>
  <Step title="Domain eingeben">
    Geben Sie Ihre Website-URL ein, um die Inhaltserkennung zu starten
  </Step>

  <Step title="URLs abrufen & auswählen">
    Überprüfen Sie die entdeckten Seiten und wählen Sie aus, welche Inhalte importiert werden sollen
  </Step>

  <Step title="Branding konfigurieren">
    Passen Sie das Erscheinungsbild Ihres Agenten mit Avatar, Theme und Farben an
  </Step>

  <Step title="Inhaltsaufnahme">
    Beobachten Sie, wie Ihr Agent erstellt und auf Ihre Inhalte trainiert wird
  </Step>
</Steps>

***

## Schritt 1: Domain eingeben

Der erste Schritt beginnt mit der Identifizierung Ihrer Website und der Benennung Ihres Agenten.

### Agentenname

Geben Sie Ihrem Agenten einen aussagekräftigen Namen, der seinen Zweck widerspiegelt. Dieser Name erscheint im Dashboard und hilft Ihnen, den Agenten unter mehreren Agenten in Ihrem Workspace zu identifizieren.

<Note>
  Wählen Sie einen Namen, der für Ihr Team aussagekräftig ist. Zum Beispiel: „Vertriebs-Support-Agent", „Produkt-Hilfe-Bot" oder „Kunden-FAQ-Assistent".
</Note>

### Website-Domain

Geben Sie Ihre Haupt-Website-URL ein (z. B. `https://ihredomain.com`). Die Plattform nutzt diese, um:

* **Seiten zu entdecken**: Automatisch alle crawlbaren Seiten auf Ihrer Domain zu finden
* **Branding zu extrahieren**: Ihre Markenfarben für die Widget-Anpassung zu erkennen
* **Kontext zu setzen**: Ihrem Agenten zu helfen zu verstehen, wo er eingesetzt wird

| Eingabeformat    | Beispiel              | Ergebnis                                |
| ---------------- | --------------------- | --------------------------------------- |
| Vollständige URL | `https://example.com` | Wird direkt verwendet                   |
| Nur Domain       | `example.com`         | `https://` wird automatisch hinzugefügt |
| Mit Subdomain    | `docs.example.com`    | Subdomain wird berücksichtigt           |

***

## Schritt 2: URLs abrufen & auswählen

Nach der Eingabe Ihrer Domain entdeckt die Plattform automatisch alle verfügbaren Seiten mittels intelligentem Web-Crawling.

### URL-Erkennung

Der Crawler findet alle öffentlichen Seiten auf Ihrer Domain und zeigt sie in einer Liste an. Sie sehen:

* **Gefundene Seiten insgesamt**: Die Anzahl der entdeckten Seiten
* **Seiten-URLs**: Vollständige URLs jeder entdeckten Seite
* **Auswahlsteuerung**: Optionen zum Auswählen, Abwählen oder Filtern von Seiten

<Tip>
  Die URL-Erkennung findet während der Einrichtung typischerweise bis zu 100 Seiten. Sie können später über den Bereich „Quellen" weitere Quellen hinzufügen.
</Tip>

### Filteroptionen

Verwenden Sie die integrierten Filter, um Ihre Auswahl zu verfeinern:

| Filter           | Zweck                                    | Beispiel                                             |
| ---------------- | ---------------------------------------- | ---------------------------------------------------- |
| **Suche**        | Bestimmte URLs nach Schlüsselwort finden | Nach „Produkt" suchen, um Produktseiten zu finden    |
| **Ausschließen** | URLs mit bestimmten Begriffen entfernen  | „Blog" ausschließen, um Blogbeiträge zu überspringen |

### Inhalte auswählen

Wählen Sie Seiten aus, die Informationen enthalten, die Ihr Agent kennen sollte:

<AccordionGroup>
  <Accordion title="Was eingeschlossen werden sollte" icon="check">
    * Produkt- oder Dienstleistungsseiten
    * FAQ- und Hilfedokumentation
    * Über-uns- und Kontaktseiten
    * Preisinformationen
    * Funktionsbeschreibungen
    * Nutzungsbedingungen und Richtlinien
  </Accordion>

  <Accordion title="Was möglicherweise ausgeschlossen werden sollte" icon="xmark">
    * Blogbeiträge (es sei denn, sie sind für den Support relevant)
    * Nachrichtenartikel oder Pressemitteilungen
    * Login- oder Kontoseiten
    * Leere oder Platzhalterseiten
    * Seiten mit doppeltem Inhalt
  </Accordion>
</AccordionGroup>

<Warning>
  Nicht-scrapbare Dateitypen (Bilder, PDFs, Videos usw.) werden automatisch herausgefiltert. Nur Webseiten mit Textinhalt werden einbezogen.
</Warning>

### Ihre Auswahl verwalten

* **Einzelauswahl**: Klicken Sie auf Kontrollkästchen, um bestimmte URLs auszuwählen oder abzuwählen
* **Massenauswahl**: Verwenden Sie Umschalt+Klick, um einen Bereich von URLs auszuwählen
* **URLs entfernen**: Klicken Sie auf das Papierkorb-Symbol, um unerwünschte URLs aus der Liste zu entfernen
* **Alles zurücksetzen**: Setzen Sie Ihre Auswahl zurück und beginnen Sie von vorn

***

## Schritt 3: Branding konfigurieren

Dieser Schritt passt das visuelle Erscheinungsbild Ihres Agenten an Ihre Markenidentität an.

### Avatar-Auswahl

Wählen Sie einen 3D-Avatar, der Ihren Agenten repräsentiert. Der Avatar:

* Erscheint im Chat-Widget
* Animiert und spricht Antworten mittels Text-to-Speech
* Schafft ein ansprechenderes, menschenähnliches Erlebnis

<CardGroup cols={2}>
  <Card title="Galerie durchsuchen" icon="images">
    Wählen Sie aus unserer Sammlung vorgefertigter Avatare mit verschiedenen Persönlichkeiten und Stilen.
  </Card>

  <Card title="Jederzeit ändern" icon="arrows-rotate">
    Sie können Ihren Avatar später jederzeit in den Agenteneinstellungen ändern.
  </Card>
</CardGroup>

### Erscheinungsbild-Theme

Wählen Sie zwischen hellem und dunklem Modus für Ihr Chat-Widget:

| Theme      | Am besten geeignet für                                                 |
| ---------- | ---------------------------------------------------------------------- |
| **Hell**   | Websites mit hellem Hintergrund, professionelle/geschäftliche Seiten   |
| **Dunkel** | Websites mit dunklem Hintergrund, Tech-/Gaming-Seiten, modernes Design |

### Markenfarben

Die Plattform extrahiert automatisch Farben von Ihrer Website:

* **Akzentfarbe**: Ihre primäre Markenfarbe
* **Dunkle Farbe**: Ein dunklerer Farbton von Ihrer Seite
* **Helle Farbe**: Ein hellerer Farbton von Ihrer Seite

<Tip>
  Wenn die automatische Erkennung Ihre exakten Markenfarben nicht findet, können Sie manuell einen Hex-Code eingeben oder den Farbwähler verwenden.
</Tip>

Sie können Ihre Primärfarbe anpassen, indem Sie:

1. **Extrahierte Farben anklicken**: Wählen Sie aus automatisch erkannten Markenfarben
2. **Den Farbwähler verwenden**: Wählen Sie eine beliebige Farbe visuell aus
3. **Einen Hex-Code eingeben**: Geben Sie einen exakten Farbwert ein (z. B. `#3B82F6`)

***

## Schritt 4: Inhaltsaufnahme

Sobald Sie auf „Agent erstellen" klicken, beginnt die Plattform mit dem Aufbau Ihres KI-Assistenten. Dieser Prozess läuft automatisch ab und zeigt den Fortschritt in Echtzeit an.

### Fortschrittsstufen

Der Erstellungsprozess umfasst mehrere Stufen:

<Steps>
  <Step title="Agent erstellen">
    Einrichten der Agentenkonfiguration und des System-Prompts in der Datenbank.
  </Step>

  <Step title="Widget erstellen">
    Generierung des einbettbaren Chat-Widgets mit Ihren Branding-Einstellungen.
  </Step>

  <Step title="Quellen vorbereiten">
    Initialisierung der Wissensdatenbank und Vorbereitung Ihrer ausgewählten URLs zur Verarbeitung.
  </Step>

  <Step title="Seiten verarbeiten">
    Crawlen jeder ausgewählten URL, Extrahieren von Textinhalten und Erstellen von Embeddings für die semantische Suche.
  </Step>

  <Step title="Wissen aufbauen">
    Indexierung aller verarbeiteten Inhalte in der Vektordatenbank für schnelle, präzise Abfragen.
  </Step>
</Steps>

### Fortschrittsverfolgung

Während der Aufnahme sehen Sie:

| Kennzahl              | Beschreibung                                                   |
| --------------------- | -------------------------------------------------------------- |
| **Gesamtfortschritt** | Prozentsatz der Gesamtfertigstellung                           |
| **Abgeschlossen**     | Anzahl der erfolgreich verarbeiteten Seiten                    |
| **In Bearbeitung**    | Seiten, die gerade verarbeitet werden                          |
| **Fehlgeschlagen**    | Seiten, die nicht verarbeitet werden konnten (falls vorhanden) |
| **Gesamt**            | Gesamtzahl der zu trainierenden Seiten                         |

<Note>
  Die Verarbeitungszeit hängt von der Anzahl der ausgewählten Seiten ab. Die meisten Agenten sind bei 50-100 Seiten in 1-3 Minuten fertig.
</Note>

### Umgang mit Fehlern

Wenn einige Seiten nicht verarbeitet werden können:

* Der Agent wird trotzdem mit den erfolgreich verarbeiteten Seiten erstellt
* Sie sehen eine Zusammenfassung der fehlgeschlagenen Seiten
* Sie können fehlgeschlagene Quellen später im Bereich „Quellen" erneut versuchen
* Häufige Fehlerursachen: Seiten durch robots.txt blockiert, Authentifizierung erforderlich oder vorübergehende Netzwerkprobleme

### Fertigstellung

Wenn die Verarbeitung erfolgreich abgeschlossen ist:

1. Eine Erfolgsbenachrichtigung erscheint
2. Sie werden automatisch zum **Playground** weitergeleitet
3. Sie können sofort damit beginnen, Ihren Agenten mit echten Fragen zu testen

***

## Nach der Einrichtung

Sobald Ihr Agent erstellt ist, können Sie ihn weiter anpassen und verbessern:

<CardGroup cols={2}>
  <Card title="Im Playground testen" icon="flask" href="/de/agents/playground">
    Stellen Sie Fragen und sehen Sie, wie Ihr Agent antwortet. Optimieren Sie den System-Prompt für bessere Antworten.
  </Card>

  <Card title="Weitere Quellen hinzufügen" icon="database" href="/de/sources/overview">
    Importieren Sie zusätzliche Webseiten, fügen Sie benutzerdefinierten Text hinzu oder erstellen Sie Frage-Antwort-Paare, um das Wissen zu erweitern.
  </Card>

  <Card title="Widget anpassen" icon="palette" href="/de/customization/styling">
    Passen Sie Farben, Hintergründe, Position und andere visuelle Einstellungen für Ihr Chat-Widget an.
  </Card>

  <Card title="Auf Website bereitstellen" icon="code" href="/de/agents/deployment">
    Erhalten Sie das Einbettungsskript und fügen Sie Ihren Agenten zu Ihrer Live-Website hinzu.
  </Card>
</CardGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Keine Seiten bei der URL-Erkennung gefunden" icon="circle-exclamation">
    **Mögliche Ursachen:**

    * Die Domain blockiert möglicherweise Crawler über `robots.txt`
    * Die Website erfordert möglicherweise eine Authentifizierung
    * Es könnte ein Tippfehler in der Domain-URL vorliegen

    **Lösungen:**

    * Überprüfen Sie, ob die URL korrekt ist
    * Versuchen Sie es mit oder ohne `www.`
    * Kontaktieren Sie Ihren Webmaster bezüglich des Crawler-Zugangs
    * Fügen Sie nach der Agentenerstellung manuell URLs hinzu
  </Accordion>

  <Accordion title="Markenfarben nicht erkannt" icon="palette">
    **Mögliche Ursachen:**

    * Die Website hat keine eindeutigen Markenfarben in ihrem CSS
    * Farben sind in Bildern statt im Code definiert
    * Die Website blockiert externen Zugriff

    **Lösungen:**

    * Verwenden Sie den manuellen Farbwähler oder geben Sie Ihren Hex-Code direkt ein
    * Prüfen Sie Ihre Markenrichtlinien auf exakte Farbwerte
  </Accordion>

  <Accordion title="Seiten schlagen bei der Aufnahme fehl" icon="triangle-exclamation">
    **Mögliche Ursachen:**

    * Einzelne Seiten blockieren möglicherweise den Zugriff
    * Inhalte könnten dynamisch geladen werden (JavaScript-lastig)
    * Seiten könnten während der Verarbeitung eine Zeitüberschreitung gehabt haben

    **Lösungen:**

    * Der Agent funktioniert mit den erfolgreich verarbeiteten Seiten
    * Versuchen Sie fehlgeschlagene Quellen später im Bereich „Quellen" erneut
    * Erwägen Sie die Verwendung von Frage-Antwort-Quellen für wichtige Inhalte, die nicht gescrapt werden können
  </Accordion>

  <Accordion title="Aufnahme dauert zu lange" icon="clock">
    **Mögliche Ursachen:**

    * Große Anzahl ausgewählter Seiten
    * Seiten mit viel Inhalt
    * Hoher Datenverkehr im Verarbeitungssystem

    **Lösungen:**

    * Haben Sie Geduld – große Wissensdatenbanken brauchen länger zum Aufbau
    * Erwägen Sie, mit weniger Seiten zu beginnen und später weitere hinzuzufügen
    * Der Fortschrittsbalken zeigt den Echtzeitstatus an
  </Accordion>
</AccordionGroup>

## Bewährte Methoden

<AccordionGroup>
  <Accordion icon="bullseye" title="Fokussiert starten, später erweitern">
    Beginnen Sie mit 20-50 hochwertigen Seiten, anstatt alles zu importieren. Es ist einfacher, einen funktionierenden Agenten zu erweitern, als einen mit zu vielen irrelevanten Inhalten zu reparieren.
  </Accordion>

  <Accordion icon="magnifying-glass" title="Entdeckte URLs sorgfältig prüfen">
    Nehmen Sie sich Zeit, Seiten auszuschließen, die für Kundenfragen nicht relevant sind. Die Qualität der Quellen ist wichtiger als die Quantität.
  </Accordion>

  <Accordion icon="robot" title="Sofort nach der Erstellung testen">
    Nutzen Sie den Playground, um sofort echte Fragen zu stellen. So können Sie frühzeitig Lücken in Ihrer Wissensdatenbank identifizieren.
  </Accordion>

  <Accordion icon="arrows-rotate" title="System-Prompt iterativ verbessern">
    Der Standard-System-Prompt funktioniert gut, aber eine Anpassung basierend auf Testergebnissen wird die Antworten Ihres Agenten deutlich verbessern.
  </Accordion>
</AccordionGroup>