> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Schnellstart

> Schnellstart mit Revol — von der Registrierung bis zu Ihrem ersten KI-Agenten

## Registrierung und Anmeldung

Revol unterstützt zwei Möglichkeiten zur Kontoerstellung:

* **Google OAuth** — klicken Sie auf "Mit Google fortfahren" und autorisieren Sie sich mit Ihrem Google-Konto. Der schnellste Weg.
* **E-Mail + Passwort** — füllen Sie das Formular aus: Vorname, Nachname, E-Mail, Passwort und Passwortbestätigung. Sie müssen die Nutzungsbedingungen und Datenschutzrichtlinie akzeptieren.

Nach der Registrierung gelangen Sie zum Dashboard, wo der erste Schritt die Erstellung eines Unternehmens ist.

<Note>
  Wenn Sie bereits ein Konto haben, nutzen Sie die Anmeldeseite — dieselben Google OAuth- oder E-Mail/Passwort-Optionen. Es gibt eine "Angemeldet bleiben"-Funktion und Passwortwiederherstellung per E-Mail.
</Note>

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/ISnj5RWDRs_CR9xg/images/register-light.png?fit=max&auto=format&n=ISnj5RWDRs_CR9xg&q=85&s=ed4cbc775d18df55ad61cff211483dcd" alt="Registrierungsformular" width="2879" height="1542" data-path="images/register-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/eirPFVwD77vgQGj-/images/register-dark.png?fit=max&auto=format&n=eirPFVwD77vgQGj-&q=85&s=5e54d5a6ce98c92fa2350046794109b5" alt="Registrierungsformular" width="2879" height="1542" data-path="images/register-dark.png" />
</Frame>

***

## Unternehmen erstellen

Nach der Anmeldung müssen Sie als Erstes **ein Unternehmen erstellen**. Ein Unternehmen ist die zentrale Einheit in Revol, mit der alle anderen Elemente verknüpft sind: Produkte, Dateien, Agenten, Integrationen, Analysen.

Um ein Unternehmen zu erstellen, füllen Sie Folgendes aus:

| Feld                  | Beschreibung                                                        |
| --------------------- | ------------------------------------------------------------------- |
| **Unternehmensname**  | Marken- oder Firmenname                                             |
| **Website**           | Ihre Website-URL (wird für die Widget-Domain-Validierung verwendet) |
| **Telefon**           | Kontaktnummer des Unternehmens                                      |
| **Logo**              | Bild, das im Widget und Dashboard angezeigt wird                    |
| **Werbebeschreibung** | Kurze Beschreibung Ihres Unternehmens                               |

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/company-setup-light.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=c6b0d8a623cce4859459c4a76a4efc60" alt="Unternehmenseinrichtung" width="2872" height="1557" data-path="images/company-setup-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/company-setup-dark.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=34bea6cc25ecbc2cafb44657a38059f0" alt="Unternehmenseinrichtung" width="2880" height="1559" data-path="images/company-setup-dark.png" />
</Frame>

### Warum ein Unternehmen und nicht einfach nur ein Agent?

Die meisten KI-Chatbot-Plattformen arbeiten mit einem einfachen Ansatz: Sie erstellen einen Agenten, laden PDF-Dateien hoch, und er beantwortet Fragen basierend auf diesen Dokumenten. Das funktioniert für einfache FAQ-Bots, wird aber schnell zur Einschränkung für echte Unternehmen.

Revol ist anders aufgebaut. Wir verwenden ein **strukturiertes Datenmodell**: Unternehmen → Produkte/Dienstleistungen → Produktparameter. Hier ist der Grund:

<AccordionGroup>
  <Accordion title="Strukturierte Daten = genauere Antworten">
    Wenn ein KI-Agent weiß, dass "iPhone 15 Pro" ein bestimmtes Produkt zum Preis von 999 \$ ist, mit 8 Farben und dem Status "auf Lager", antwortet er mit **Fakten** statt Text aus einem PDF zu interpretieren. Keine Halluzinationen über geänderte Preise oder nicht mehr verfügbare Produkte.
  </Accordion>

  <Accordion title="Parameter sind die Sprache Ihres Unternehmens">
    Jedes Unternehmen hat seine eigenen Schlüsselmerkmale. Für einen Online-Shop — Größe, Farbe, Material. Für eine Klinik — Behandlungsdauer, Kontraindikationen. Für SaaS — Planlimits, unterstützte Integrationen. Produktparameter ermöglichen es, diese Details strukturiert zu beschreiben, und der Agent nutzt sie für präzise, kontextbezogene Antworten.
  </Accordion>

  <Accordion title="Ein Datensatz — mehrere Agenten">
    Sie füllen den Produktkatalog einmal aus und erstellen dann mehrere Agenten mit verschiedenen Rollen: einen für den Vertrieb, einen für den Support, einen dritten für interne Schulungen. Jeder Agent wählt aus, welche spezifischen Produkte und Dateien er verwendet. Keine Datenduplizierung.
  </Accordion>

  <Accordion title="Skalierung für Agenturen">
    Wenn Sie mehrere Unternehmen verwalten oder als Agentur arbeiten — jedes Unternehmen hat isolierte Daten, separate Agenten und eigene Analysen. Ein einziges Revol-Konto kann Dutzende von Unternehmen bedienen.
  </Accordion>
</AccordionGroup>

***

## Produkte und Dienstleistungen

Nach der Erstellung eines Unternehmens fügen Sie **Produkte oder Dienstleistungen** hinzu — das sind die Kerneinheiten, die Ihr KI-Agent kennen und Kunden darüber informieren wird.

Um ein Produkt zu erstellen, geben Sie an:

| Feld              | Beschreibung                                   |
| ----------------- | ---------------------------------------------- |
| **Name**          | Dienstleistungs- oder Produktname              |
| **Link**          | Produktseiten-URL auf Ihrer Website (optional) |
| **Verfügbarkeit** | Ob das Produkt bestellbar ist                  |

Nach der Erstellung öffnet sich ein Produkt-Seitenpanel, in dem Sie:

* Eine **ausführliche Beschreibung** (Prompt) hinzufügen können — erweiterter Text über das Produkt, den der Agent für Antworten verwendet
* Den **Preis** festlegen können
* Produkt-**Fotos** hochladen können
* **Dateien** zur Wissensdatenbank des Produkts hinzufügen können (Dokumente, Links, Text, Videos)

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/ISnj5RWDRs_CR9xg/images/product-card-light.png?fit=max&auto=format&n=ISnj5RWDRs_CR9xg&q=85&s=020f0e4dce757b0caa68d9a425795ad7" alt="Produktkarte" width="2873" height="1551" data-path="images/product-card-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/ISnj5RWDRs_CR9xg/images/product-card-dark.png?fit=max&auto=format&n=ISnj5RWDRs_CR9xg&q=85&s=1f29902c2ad0ac623d81948a2729c589" alt="Produktkarte" width="2860" height="1546" data-path="images/product-card-dark.png" />
</Frame>

### Produktparameter

Der leistungsstärkste Teil des Produktmodells sind die **Parameter**. Dies sind strukturierte "Name — Wert"-Paare, die spezifische Produkteigenschaften beschreiben.

**Parameterbeispiele für verschiedene Branchen:**

<Tabs>
  <Tab title="Online-Shop">
    | Parameter | Wert                |
    | --------- | ------------------- |
    | Größe     | S, M, L, XL         |
    | Farbe     | Schwarz, Weiß, Blau |
    | Material  | 100% Baumwolle      |
    | Gewicht   | 250 g               |
    | Garantie  | 12 Monate           |
  </Tab>

  <Tab title="Klinik / Salon">
    | Parameter          | Wert                                      |
    | ------------------ | ----------------------------------------- |
    | Dauer              | 60 Minuten                                |
    | Kontraindikationen | Schwangerschaft, Latexallergie            |
    | Vorbereitung       | 2 Stunden vor der Behandlung nichts essen |
    | Erholung           | 3-5 Tage                                  |
  </Tab>

  <Tab title="SaaS / IT">
    | Parameter     | Wert                                           |
    | ------------- | ---------------------------------------------- |
    | Benutzer      | Bis zu 50                                      |
    | Speicher      | 100 GB                                         |
    | API-Anfragen  | 10.000 / Monat                                 |
    | Support       | E-Mail + Chat, Antwort innerhalb von 4 Stunden |
    | Integrationen | Slack, Jira, GitHub                            |
  </Tab>
</Tabs>

**Warum ist das nötig?** Wenn ein Kunde fragt "Welche Größen gibt es?" oder "Wie lange dauert die Behandlung?" — nimmt der Agent die Antwort direkt aus den Produktparametern, anstatt diese Information in einem langen Text zu suchen. Das bietet:

* **Genauigkeit** — konkrete Werte statt vager Formulierungen
* **Aktualität** — ändern Sie einen Parameter an einer Stelle, und der Agent antwortet sofort mit der aktualisierten Information
* **Vergleich** — der Agent kann Produkte anhand spezifischer Parameter vergleichen

***

## Dateimanager

Der **Dateimanager** ist der zentrale Speicher für alle Dateien Ihres Unternehmens. Hier laden Sie Inhalte hoch, die zum Training von KI-Agenten verwendet werden.

Gehen Sie im Seitenmenü zu **Dateimanager**. Sie sehen eine Liste von Unternehmen — wählen Sie das gewünschte aus, um dessen Dateien zu öffnen.

### Inhaltstypen

<Tabs>
  <Tab title="Dokumente">
    Laden Sie Dateien in den Formaten **PDF**, **DOCX**, **TXT** hoch. Revol extrahiert automatisch den Text, teilt ihn in Abschnitte auf und erstellt Vektor-Embeddings für die semantische Suche.

    | Format | Max. Größe | Was extrahiert wird   |
    | ------ | ---------- | --------------------- |
    | PDF    | 10 MB      | Text von allen Seiten |
    | DOCX   | 10 MB      | Text mit Formatierung |
    | TXT    | 5 MB       | Vollständiger Text    |
  </Tab>

  <Tab title="Links">
    Fügen Sie die URL einer beliebigen Webseite ein. Revol lädt automatisch den Seiteninhalt herunter, extrahiert den Text und fügt ihn der Wissensdatenbank hinzu.

    Das ist praktisch für:

    * Website-Seiten mit Leistungsbeschreibungen
    * FAQ-Bereiche
    * Blogbeiträge und Artikel
    * Externe Ressourcen
  </Tab>

  <Tab title="Text">
    Fügen Sie Inhalte direkt als Textblock hinzu. Ideal für:

    * Häufig gestellte Fragen (FAQ)
    * Unternehmensrichtlinien
    * Agenten-Skripte
    * Kurze Anleitungen
  </Tab>

  <Tab title="Video">
    Laden Sie ein Video hoch — Revol transkribiert automatisch die Audiospur in Text und fügt sie der Wissensdatenbank hinzu. Unterstützte Formate: **MP4**, **WebM**, **MOV**.
  </Tab>

  <Tab title="Fotos">
    Laden Sie Bilder mit Text hoch — Revol verwendet OCR zur Textextraktion. Nützlich für Screenshots, Dokumentfotos, Infografiken.
  </Tab>
</Tabs>

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/file-manager-light.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=d24d28dd98f250a4b5a219a2e53e3164" alt="Dateimanager" width="2878" height="1554" data-path="images/file-manager-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/NanTY36X8lEh-_hW/images/file-manager-dark.png?fit=max&auto=format&n=NanTY36X8lEh-_hW&q=85&s=f0c25374111eeb2902f371e38d934b9e" alt="Dateimanager" width="2879" height="1556" data-path="images/file-manager-dark.png" />
</Frame>

<Note>
  Dateien können sowohl auf Unternehmensebene (für alle Agenten verfügbar) als auch auf der Ebene einzelner Produkte (mit einem bestimmten Produkt/einer Dienstleistung verknüpft) hinzugefügt werden.
</Note>

***

## KI-Agent erstellen

Jetzt, wo Sie ein Unternehmen mit Produkten und Dateien haben — ist es Zeit, einen KI-Agenten zu erstellen.

Gehen Sie im Seitenmenü zu **KI-Agenten** und klicken Sie auf **Agent erstellen**.

### Grundeinstellungen

| Feld               | Beschreibung                                                                        |
| ------------------ | ----------------------------------------------------------------------------------- |
| **Name**           | Agentenname (z.B. "Verkaufsberater")                                                |
| **Unternehmen**    | Zu welchem Unternehmen der Agent gehört                                             |
| **Anwendungsfall** | Agentenrolle: Vertrieb, Support, Lead-Generierung, Terminplanung, Benutzerdefiniert |
| **LLM-Anbieter**   | KI-Modellanbieter                                                                   |
| **Modell**         | Spezifisches zu verwendendes Modell                                                 |

### Verfügbare LLM-Anbieter

<CardGroup cols={2}>
  <Card title="OpenAI" icon="bolt">
    GPT-4o, GPT-4o-mini — die beliebteste Wahl für die meisten Aufgaben
  </Card>

  <Card title="Anthropic" icon="brain">
    Claude Sonnet, Claude Haiku — ausgezeichnete Antwortqualität und Sicherheit
  </Card>

  <Card title="Google" icon="google">
    Gemini 2.0 Flash, Gemini 2.5 Pro — schnelle und effiziente Modelle
  </Card>

  <Card title="Groq" icon="microchip">
    Llama 3.1 8B, Llama 3.3 70B — schnellste Inferenz, Open-Source-Modelle
  </Card>
</CardGroup>

### System-Prompt

Nach der Erstellung des Agenten öffnet sich ein Vollbild-Einstellungspanel. Der erste Schritt ist das Schreiben eines **System-Prompts** — der Kernanweisung, die das Verhalten des Agenten definiert.

```text theme={null}
You are a sales consultant for [Company Name].
Your goal is to help customers choose the right product.

Rules:
- Always be polite and professional
- If you don't know the answer — honestly say so
- Do not discuss competitors' products
- Suggest relevant products from the knowledge base
- Respond in the customer's language
```

<Tip>
  Je spezifischer der System-Prompt, desto genauer die Antworten des Agenten. Geben Sie die Rolle, den Kommunikationston, Einschränkungen und Antwortbeispiele an.
</Tip>

***

## Agenten-Wissensdatenbank

Navigieren Sie zum **Wissen**-Tab im Agentenpanel. Hier wählen Sie aus, welche spezifischen Daten der Agent für Antworten verwenden soll.

### Wissensquellen

Der Agent kann aus zwei Arten von Quellen lernen:

<AccordionGroup>
  <Accordion title="Unternehmensprodukte">
    Wählen Sie bestimmte Produkte oder Dienstleistungen aus, die der Agent kennen soll. Der Agent erhält Zugriff auf Namen, Beschreibungen, Preise, Parameter und Fotos der ausgewählten Produkte.
  </Accordion>

  <Accordion title="Wissensdatenbank-Dateien">
    Wählen Sie Dokumente, Links, Texte und Videos aus dem Dateimanager. Sie können Dateien sowohl auf Unternehmensebene als auch solche auswählen, die mit bestimmten Produkten verknüpft sind.
  </Accordion>
</AccordionGroup>

### Training

Nachdem Sie die Quellen ausgewählt haben, klicken Sie auf **Trainieren**. Revol wird:

1. Alle Textinhalte aus den ausgewählten Quellen extrahieren
2. Sie in optimale Abschnitte aufteilen
3. Vektor-Embeddings über OpenAI text-embedding-3-small erstellen
4. Sie in PostgreSQL mit pgvector für die semantische Suche speichern

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/Eqyg_VGeDQWA95PL/images/agents-knowledge-base-light.png?fit=max&auto=format&n=Eqyg_VGeDQWA95PL&q=85&s=54073d8431563eaf5efba937d70552db" alt="Agenten-Wissensdatenbank" width="2867" height="1551" data-path="images/agents-knowledge-base-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/Eqyg_VGeDQWA95PL/images/agents-knowledge-base-dark.png?fit=max&auto=format&n=Eqyg_VGeDQWA95PL&q=85&s=089b1492ccb3a7c45341fc8993327da4" alt="Agenten-Wissensdatenbank" width="2874" height="1555" data-path="images/agents-knowledge-base-dark.png" />
</Frame>

<Warning>
  Nach dem Ändern von Dateien oder Produkten müssen Sie erneut auf **Trainieren** klicken, damit der Agent die aktualisierten Daten erhält.
</Warning>

***

## Agent testen

Testen Sie den Agenten vor der Veröffentlichung direkt im Dashboard. Klicken Sie auf die Schaltfläche **Vorschau** in der oberen Leiste des Agenten — ein integriertes Chat-Fenster öffnet sich.

### Standard-Workflow

Jeder neue Agent wird mit einem **fertigen Workflow** geliefert, der grundlegende Anforderungen ohne zusätzliche Konfiguration abdeckt. Seine Struktur:

```
Voice Input (STT) → Start → Product Agent  ─┐
                         ├→ Media Agent    ─┤→ Response Formatter → Voice Output (TTS)
                         └→ Company Agent  ─┘
```

| Knoten                   | Was er tut                                                      | Tools                                                                               |
| ------------------------ | --------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Start**                | Einstiegspunkt — empfängt die Nachricht des Benutzers           | —                                                                                   |
| **Product Agent**        | Sucht nach Produkten, Details, Verfügbarkeit, Parametern        | `get_products`, `get_product_details`, `check_availability`, `search_by_parameters` |
| **Media Agent**          | Findet Fotos, Videos und Dokumente aus der Wissensdatenbank     | `get_photos`, `get_videos`, `get_documents`, `search_documents`                     |
| **Company Agent**        | Beantwortet allgemeine Fragen zum Unternehmen                   | `get_company_info`                                                                  |
| **Response Formatter**   | Sammelt Antworten aller Agenten und bildet die finale Nachricht | —                                                                                   |
| **Voice Input / Output** | STT und TTS für den Sprachmodus (standardmäßig deaktiviert)     | —                                                                                   |

Drei spezialisierte Agenten arbeiten **parallel** — Start verteilt die Anfrage unter ihnen, jeder sucht relevante Informationen in seinem Bereich, und der Formatter kombiniert die Ergebnisse zu einer einzigen zusammenhängenden Antwort.

<Tip>
  Der Standard-Workflow reicht für die meisten Szenarien aus: Produktberatung, FAQ-Antworten, Wissensdatenbank-Suche. Für komplexere Szenarien (Bedingungen, Verzweigungen, benutzerdefinierte Tool-Aufrufe) verwenden Sie den [Workflow-Editor](/agents/workflow).
</Tip>

### Was Sie prüfen sollten

<Steps>
  <Step title="Grundlegende Antworten">
    Fragen Sie nach Ihren Produkten und Dienstleistungen. Stellen Sie sicher, dass der Agent genau antwortet und Daten aus der Wissensdatenbank verwendet.
  </Step>

  <Step title="Wissensgrenzen">
    Fragen Sie etwas, das nicht in der Wissensdatenbank steht. Der Agent sollte ehrlich sagen, dass er diese Information nicht hat, anstatt eine Antwort zu erfinden.
  </Step>

  <Step title="Ton und Stil">
    Überprüfen Sie, ob der Kommunikationston Ihrem System-Prompt entspricht — Höflichkeit, Sprache, Formalität.
  </Step>

  <Step title="Mehrsprachigkeit">
    Schreiben Sie in verschiedenen Sprachen — der Agent sollte in der Sprache des Kunden antworten.
  </Step>
</Steps>

<Tip>
  Verwenden Sie den **Analyse**-Tab, um Gesprächsverläufe, Bewertungen und Agentenstatistiken einzusehen.
</Tip>

***

## Widget installieren

Wenn der Agent bereit ist — installieren Sie das Widget auf Ihrer Website. Klicken Sie auf die Schaltfläche **Einbetten** in der oberen Leiste des Agenten.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/8tD14ZAg_eb7XGXC/images/embed-code-light.png?fit=max&auto=format&n=8tD14ZAg_eb7XGXC&q=85&s=367902b87e32b43dd9d152868c35a636" alt="Einbettungscode-Modal" width="2425" height="1276" data-path="images/embed-code-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/8tD14ZAg_eb7XGXC/images/embed-code-dark.png?fit=max&auto=format&n=8tD14ZAg_eb7XGXC&q=85&s=4d33a3f9339ea0cfa5daaf925fa50cd1" alt="Einbettungscode-Modal" width="2424" height="1319" data-path="images/embed-code-dark.png" />
</Frame>

### Code erhalten

1. Klicken Sie auf **API-Schlüssel generieren** (falls noch kein Schlüssel erstellt wurde)
2. Kopieren Sie den Widget-HTML-Code

### Zu Ihrer Website hinzufügen

Fügen Sie diesen Code vor dem schließenden `</head>`-Tag auf Ihrer Website ein:

```html theme={null}
<script src="https://revol-ai.app/tracker.js"
        data-api-key="YOUR_API_KEY"
        data-company-id="YOUR_COMPANY_ID"
        async>
</script>
```

Ein einziges Skript bietet:

* **Chat-Widget** — eine Schaltfläche in der Ecke der Website zur Kommunikation mit dem Agenten
* **Besucherverfolgung** — Sitzungen, Seiten, Ereignisse, UTM-Tags
* **Sprachkommunikation** — wenn für den Agenten aktiviert

<Note>
  Das Widget wird im **Shadow DOM** gerendert — seine Styles sind vollständig von Ihrer Website isoliert und umgekehrt. Keine CSS-Konflikte.
</Note>

### Verbindung prüfen

Kehren Sie nach der Installation des Skripts zum Einbettungscode-Modal zurück und klicken Sie auf **Verbindung prüfen**. Revol überprüft, ob das Widget korrekt mit Ihrer Website verbunden ist.

***

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Workflow-Editor" icon="diagram-project" href="/agents/workflow">
    Erstellen Sie komplexe Gesprächsszenarien mit Bedingungen, Verzweigungen und Tool-Aufrufen
  </Card>

  <Card title="Integrationen" icon="plug" href="/integrations/overview">
    Verbinden Sie Telegram, WhatsApp, Telefonie und andere Kanäle
  </Card>

  <Card title="Widget-Anpassung" icon="palette" href="/widget/customization">
    Ändern Sie Farben, Texte, Platzierung und das Erscheinungsbild des Widgets
  </Card>

  <Card title="Analysen und Tracking" icon="chart-line" href="/widget/tracker">
    Verfolgen Sie Besuchersitzungen, Ereignisse und Konversionen
  </Card>
</CardGroup>