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

# Einrichtungsanleitung KI-Agent

> Vom Lizenzschlüssel zu einem KI-Agenten, der deine Discord-Tickets beantwortet.

Die Einrichtung dauert etwa 15 Minuten. Du brauchst vier Dinge:

* Einen EchoAuth-KI-Agent-**Lizenzschlüssel**. [Kaufe einen im Shop](https://shop.echoauth.dev/product/echos-ai-agent-hosted), falls du noch keinen hast.
* Einen **Discord-Server**, auf dem du Bots hinzufügen und Rollen verwalten kannst.
* Einen **[OpenRouter](https://openrouter.ai)-API-Key**. Ein OpenRouter-Key deckt alles ab, was der Agent braucht: Antworten, Screenshots und Suche.
* Optional eine **Docs-Website** oder schriftliche Dokumentation, aus der der Agent antworten kann.

Wir hosten deinen Agenten und halten ihn am Laufen. Du richtest ihn über das Dashboard unter [agent.echoauth.dev](https://agent.echoauth.dev) ein.

> [!NOTE]
>
> **Empfohlenes Setup.** Langzeittests liefen nur mit OpenRouter und diesen drei Modellen:
>
> | Rolle | Modell |
> | - | - |
> | Chat / Agent | `deepseek/deepseek-v4-flash-0731` |
> | Embedding | `qwen/qwen3-embedding-8b` |
> | Vision (Bilderkennung) | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> Weitere Anbieter (NVIDIA, OpenAI, Anthropic) stehen im Dashboard zur Verfügung, aber diese Kombination haben wir über längere Zeit getestet.

## 1. Account erstellen

**1. Registrierungsseite öffnen**

Gehe zu [agent.echoauth.dev/register](https://agent.echoauth.dev/register).

**2. Lizenzschlüssel eingeben**

Füge den Schlüssel aus deiner Kauf-E-Mail ein. Er sieht aus wie `ECHO-XXXX-XXXX-XXXX-XXXX`.

**3. Benutzernamen und Passwort wählen**

Dein Passwort braucht mindestens 8 Zeichen. Klicke auf **Create account**.

![Registrierungsformular mit Feldern für Lizenzschlüssel, Benutzername und Passwort](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

Die Registrierungsseite

Sobald deine Lizenz aktiv ist, wird dein Agent für dich erstellt. Du landest im Dashboard, wo du den Agenten, deine Lizenz und Nutzungsstatistiken siehst.

![Dashboard mit einem Agenten, Lizenzstatus und Nutzung](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

Das Dashboard nach der Anmeldung

> [!NOTE]
>
> Wenn **No agents yet** angezeigt wird, öffne **License** in der Seitenleiste und prüfe, ob deine Lizenz aktiv ist.

Klicke auf deinen Agenten, um seine Seite zu öffnen. Alles Weitere in dieser Anleitung beginnt hier: **Configure** öffnet die Einstellungen, **Live logs** zeigt, was der Agent gerade tut, und **Update Agent** wendet Einstellungen an, die ein erneutes Deployment brauchen.

![Agent-Seite mit Configure, Live logs, Restart und Update Agent](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/03-agent.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=6c4ca792bd16efd8e9e175519f337123)

Die Agent-Seite

## 2. Discord-Bot erstellen

Dein Agent antwortet über einen Discord-Bot, der dir gehört. Erstelle ihn im Discord Developer Portal.

**1. Anwendung erstellen**

Öffne das [Discord Developer Portal](https://discord.com/developers/applications) und klicke auf **New Application**. Benenne sie nach deinem Support-Agenten, zum Beispiel "Acme Support".

**2. Message Content Intent aktivieren**

Gehe zu **Bot**. Aktiviere unter **Privileged Gateway Intents** den **Message Content Intent** und speichere.

> [!WARNING]
>
> Ohne diesen Intent erhält der Bot leere Nachrichten und antwortet nie.

**3. Bot-Token kopieren**

Klicke weiterhin unter **Bot** auf **Reset Token** und kopiere den Token. Du fügst ihn im nächsten Abschnitt in das Dashboard ein. Halte ihn geheim: Jeder mit dem Token kann deinen Bot steuern.

**4. Bot auf deinen Server einladen**

Gehe zu **OAuth2** → **URL Generator**. Wähle die Scopes `bot` und `applications.commands` sowie diese Bot-Berechtigungen:

* View Channels
* Send Messages
* Read Message History
* Embed Links
* Attach Files

Öffne die erzeugte URL und füge den Bot deinem Server hinzu.

**5. Dem Bot Zugriff auf deine Ticket-Kategorie geben**

Stelle sicher, dass die Rolle des Bots die Kategorie sehen kann, in der deine Ticket-Kanäle erstellt werden. Wenn er den Kanal nicht sehen kann, kann er nicht antworten.

## 3. Keys hinzufügen

Erstelle einen API-Key unter [openrouter.ai/keys](https://openrouter.ai/keys) und lade etwas Guthaben auf dein OpenRouter-Konto. Das Vision-Modell ist kostenlos, Chat- und Embedding-Modell werden pro Nutzung bezahlt.

Klicke dann auf deiner Agent-Seite auf **Configure** und öffne den Tab **API Keys**.

![API-Keys-Tab mit OpenRouter-API-Key und Discord-Bot-Token, beide als configured markiert](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

Der Tab API Keys mit konfiguriertem OpenRouter-Key und Discord-Bot-Token

1. Füge deinen Key in **OpenRouter API Key** ein.
2. Füge deinen **Discord Bot Token** ein.
3. Klicke auf **Save**.

Die Felder für OpenAI, Anthropic und NVIDIA kannst du leer lassen. Keys werden verschlüsselt gespeichert und nach dem Speichern nie wieder angezeigt. Ein Badge **configured** bestätigt, dass ein Key gesetzt ist.

## 4. KI-Modelle auswählen

Öffne den Tab **AI Settings**. Der Agent nutzt drei Modelle. Stelle alle drei auf **OpenRouter** und wähle die empfohlenen Modelle:

| Einstellung | Wofür es da ist | Anbieter | Modell |
| - | - | - | - |
| **Chat / Agent Model** | Schreibt die Antworten und entscheidet, was in deiner Dokumentation nachgeschlagen wird. | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | Liest Screenshots, die Kunden an Tickets anhängen. | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | Indexiert deine Dokumentation und durchsucht sie. | OpenRouter | `qwen/qwen3-embedding-8b` |

![AI-Settings-Tab mit OpenRouter für Chat-, Vision- und Embedding-Modell](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

Der Tab AI Settings mit den empfohlenen OpenRouter-Modellen

> [!NOTE]
>
> Unter dem Embedding-Modell warnt das Dashboard, dass es über 2000 Dimensionen hat. Das ist bei `qwen/qwen3-embedding-8b` zu erwarten. Die Suche funktioniert trotzdem: Sie prüft jede Passage, statt einen Index zu nutzen, was bei einer Wissensdatenbank mit einigen tausend Passagen schnell bleibt.

Schreibe dann deinen **Base Prompt**. Das sind die Dauer-Anweisungen des Agenten: für wen er arbeitet, welchen Ton er nutzen soll und was er nie tun darf. Zum Beispiel:

```text theme={null}
You are the support agent for Acme Store. Be friendly and concise.
Answer only from the documentation. If you are not sure, ask a staff member to step in.
```

> [!WARNING]
>
> Wähle dein Embedding-Modell, bevor du etwas indexierst. Wenn du es später änderst, ist der bestehende Index unbrauchbar, bis du ihn neu aufbaust.

## 5. Mit deinen Tickets verbinden

Öffne den Tab **Discord**. Diese Einstellungen sagen dem Agenten, wo er antworten soll und wer als Team zählt.

![Discord-Tab mit Owner-Rollen, Staff-Rollen, Ticket-Kategorie-IDs, Ticket-Bot-IDs und Bildmodellen](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

Der Tab Discord

Um IDs zu kopieren, aktiviere in Discord unter **User Settings** → **Advanced** den **Developer Mode**. Klicke dann mit der rechten Maustaste auf eine Rolle, Kategorie oder einen Benutzer und wähle **Copy ID**.

> [accordion] Owner Role IDs
>
> Rollen, die jeden Slash-Befehl nutzen dürfen, einschließlich `/pause_bot` und `/edit_base`. Trenne mehrere IDs mit Kommas.

> [accordion] Staff Role IDs
>
> Die Rollen deines Support-Teams. Wenn ein Teammitglied in einem Ticket schreibt, tritt der Agent zurück und bleibt in diesem Ticket still. Um ihn zurückzuholen, erwähne den Bot im Ticket oder nutze dort `/restart`.

> [accordion] Ticket Category IDs
>
> Die Kategorien, in denen deine Ticket-Kanäle erstellt werden. Der Agent antwortet nur innerhalb dieser Kategorien.

> [accordion] Ticket Bot IDs
>
> Die Benutzer-ID deines Ticket-Bots, etwa Ticket Tool oder SellAuth Tickets. Der Agent ignoriert andere Bots. Füge deinen hier hinzu, damit der Agent die erste Nachricht des Tickets lesen kann.

> [accordion] Image Models
>
> Ersatz-Vision-Modelle, eines pro Zeile, die der Reihe nach probiert werden, falls das Vision-Modell aus den AI Settings fehlschlägt. Trage diese Fallbacks ein:\
> `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free`\
> `google/gemma-4-31b-it:free`\
> `google/gemma-4-26b-a4b-it:free`\
> `thinkingmachines/inkling-small:free`\
> `dots-studio/dots-3-note-preview:free`

Klicke auf **Save**.

## 6. Dem Agenten deine Dokumentation geben

Öffne den Tab **Knowledge Base**. Der Agent antwortet aus zwei Quellen, du kannst eine oder beide nutzen.

![Knowledge-Base-Tab mit dem Button Index documentation, Docs-URL und interner Wissensdatenbank](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

Der Tab Knowledge Base

> [tab] Docs site
>
> Nutze das, wenn deine Dokumentation auf Mintlify veröffentlicht ist.
>
> 1. Gib deine **Docs URL** ein, zum Beispiel `https://docs.acme-store.com`, ohne abschließenden Schrägstrich. Die Seite muss `/llms.txt` ausliefern, was Mintlify automatisch tut.
> 2. Klicke auf **Save**, gehe dann zu deiner Agent-Seite und klicke auf **Update Agent**.
> 3. Klicke zurück in diesem Tab auf **Index documentation**. Einige hundert Seiten brauchen ein paar Minuten, und du kannst die Seite währenddessen verlassen.
>
> Mit **Sync Mode** auf **Poll llms.txt hourly** prüft der Agent deine Dokumentation jede Stunde und indexiert nur die geänderten Seiten neu.

> [tab] Internal knowledge base
>
> Nutze das für alles, was nicht auf einer Docs-Website steht: FAQs, Richtlinien, Fehlercodes.
>
> 1. Scrolle zu **Internal Knowledge Base**.
> 2. Füge deinen Text ein oder klicke auf **Load file** und wähle eine `.txt`- oder `.md`-Datei.
> 3. Klicke auf **Save**.
>
> Der Agent indexiert den Inhalt innerhalb etwa einer Minute. Reiner Text reicht aus: Überschriften in GROSSBUCHSTABEN oder zwischen `=====`-Zeilen werden zu durchsuchbaren Abschnitten.

Lass **Documentation Retrieval** und **Agentic Retrieval** eingeschaltet. Mit aktivem Retrieval schlägt der Agent nur die für jede Frage relevanten Passagen nach, statt jedes Mal alles zu lesen.

## 7. Antwortzeiten und Eskalation festlegen

Öffne den Tab **Behavior**.

![Behavior-Tab mit Antwortzeiten und Human-Help-Keywords](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

Der Tab Behavior

Der Agent wartet, bis der Kunde aufgehört zu tippen, und beantwortet dann alles in einer Antwort. Jede neue Nachricht startet den Timer neu.

| Einstellung | Standard | Bedeutung |
| - | - | - |
| After ticket opens | 45 s | Wartezeit nach der ersten Nachricht, da Kunden oft Details oder Screenshots nachliefern. |
| After each message | 30 s | Ruhezeit, die nach späteren Nachrichten nötig ist, bevor geantwortet wird. |
| Maximum wait | 180 s | Der Agent antwortet nach dieser Zeit, auch wenn der Kunde weiter tippt. |

Trage unter **Human Help Keywords** Wörter ein, die das Ticket an dein Team übergeben sollen, eines pro Zeile. Zum Beispiel `refund`, `chargeback` oder `real person`.

## 8. Benachrichtigungen einrichten (optional)

Öffne den Tab **Notifications** und füge die ID eines privaten Team-Kanals ein. Der Agent postet dort, wenn deine Lizenz bald abläuft und wenn ein KI-Anbieter deinen Key ablehnt oder das Kontingent aufgebraucht ist.

![Notifications-Tab mit der ID des Benachrichtigungskanals](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

Der Tab Notifications

## 9. Agent starten

Gehe zurück zu deiner Agent-Seite und klicke auf **Update Agent**. Das stellt den Agenten mit deinem Bot-Token, deiner Docs-URL und deinem Embedding-Modell neu bereit. Die Ausgabe erscheint währenddessen unter dem Button.

> [!NOTE]
>
> Die meisten Einstellungen erreichen den laufenden Agenten innerhalb etwa einer Minute, ganz ohne erneutes Deployment. **Update Agent** brauchst du nur, nachdem du den **Discord Bot Token**, die **Docs URL**, das **Embedding Model** oder den **Sync Mode** geändert hast.

So prüfst du, ob alles funktioniert:

1. Öffne auf deinem Server ein Test-Ticket und stelle eine Frage, die deine Dokumentation beantwortet.
2. Öffne **Live logs** auf deiner Agent-Seite und beobachte, wie der Agent die Nachricht empfängt, deine Dokumentation durchsucht und antwortet.

![Live logs zeigen, wie der Agent startet, synchronisiert, die Dokumentation durchsucht und in einem Ticket antwortet](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

Live logs

Das Status-Badge deines Agenten zeigt **Online**, wenn er läuft.

## Slash-Befehle

Sobald der Agent auf deinem Server ist, können Owner und Team ihn über Discord steuern.

| Befehl | Wer | Was er tut |
| - | - | - |
| `/stop` | Owner, Staff | Verhindert, dass der Agent in diesem Kanal antwortet. |
| `/restart` | Owner, Staff | Erlaubt dem Agenten wieder, in diesem Kanal zu antworten. |
| `/mute_existing` | Owner, Staff | Stoppt den Agenten in jedem bereits offenen Ticket. |
| `/pause_bot` | Owner | Pausiert den Agenten überall. |
| `/resume_bot` | Owner | Setzt den Agenten überall fort. |
| `/edit_base` | Owner | Bearbeitet den Base Prompt. |
| `/chat_model` | Owner | Ändert das Chat-Modell. |

Du kannst den Agenten auch im Dashboard mit **Global Bot Pause** im Tab **Discord** pausieren.

## Lizenz aktiv halten

Dein Agent bleibt online, solange deine Lizenz aktiv ist. Die Seite **License** zeigt die verbleibenden Tage und dein Ablaufdatum.

![Lizenzseite mit Status, verbleibenden Tagen und verfügbaren Tarifen](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

Die Seite License

Zum Verlängern kaufst du im [Shop](https://shop.echoauth.dev/product/echos-ai-agent-hosted) einen neuen Schlüssel, klickst auf **Renew license** und fügst den Schlüssel ein. Die Zeit wird auf deine aktuelle Lizenz aufgeschlagen.

## Fehlerbehebung

> [accordion] Der Bot ist online, antwortet aber nie
>
> * Prüfe, dass **Message Content Intent** im Discord Developer Portal aktiviert ist.
> * Prüfe, dass die Kategorie-ID des Tickets in den **Ticket Category IDs** steht.
> * Prüfe, dass der Bot in dieser Kategorie sehen und Nachrichten senden kann.
> * Prüfe, ob nicht schon ein Teammitglied im Ticket geschrieben hat. Erwähne den Bot oder nutze `/restart`, um ihn zurückzuholen.
> * Prüfe, dass **Global Bot Pause** ausgeschaltet ist.

> [accordion] Der Bot ignoriert die erste Nachricht des Tickets
>
> Füge die Benutzer-ID deines Ticket-Bots im Tab **Discord** unter **Ticket Bot IDs** hinzu.

> [accordion] Der Agent nutzt meine Dokumentation nicht
>
> Öffne den Tab **Knowledge Base**. Steht dort **Documentation is not indexed yet**, klicke auf **Index documentation**. Steht dort **The index does not match the embedding model**, klicke auf **Clear and rebuild the index** oder stelle das Embedding-Modell auf das angezeigte zurück und speichere.

> [accordion] Antworten oder Indexierung schlagen mit einem OpenRouter-Fehler fehl
>
> Prüfe, dass dein OpenRouter-Konto Guthaben hat und der Key im Tab **API Keys** noch gültig ist. Kostenlose Modelle wie das Vision-Modell können zu Stoßzeiten ratenlimitiert sein. Der Agent weicht dann auf das nächste Modell unter **Image Models** aus.

> [accordion] Der Agent antwortet nicht mehr
>
> Öffne **Live logs** und suche nach Fehlern, zum Beispiel einem ungültigen Key oder aufgebrauchtem Guthaben. Klicke dann auf der Agent-Seite auf **Restart**. Wenn das nicht hilft, klicke auf **Update Agent**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.