> ## 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.

# Installatiehandleiding AI-agent

> Ga van een licentiesleutel naar een AI-agent die je Discord-tickets beantwoordt.

De installatie duurt ongeveer 15 minuten. Je hebt vier dingen nodig:

* Een EchoAuth AI Agent-**licentiesleutel**. [Koop er een in de shop](https://shop.echoauth.dev/product/echos-ai-agent-hosted) als je er nog geen hebt.
* Een **Discord-server** waar je bots kunt toevoegen en rollen kunt beheren.
* Een **[OpenRouter](https://openrouter.ai)-API-sleutel**. Eén OpenRouter-sleutel dekt alles wat de agent nodig heeft: antwoorden, screenshots en zoeken.
* Optioneel een **docs-site** of wat geschreven documentatie waaruit de agent kan antwoorden.

Wij hosten je agent en houden hem draaiende. Je stelt hem in via het dashboard op [agent.echoauth.dev](https://agent.echoauth.dev).

> [!NOTE]
>
> **Aanbevolen setup.** Langdurige tests zijn alleen met OpenRouter gedaan, met deze drie modellen:
>
> | Rol | Model |
> | - | - |
> | Chat / Agent | `deepseek/deepseek-v4-flash-0731` |
> | Embedding | `qwen/qwen3-embedding-8b` |
> | Vision (beelddetectie) | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> Andere providers (NVIDIA, OpenAI, Anthropic) zijn beschikbaar in het dashboard, maar dit is de combinatie die we al langere tijd hebben getest.

## 1. Maak je account aan

**1. Open de registratiepagina**

Ga naar [agent.echoauth.dev/register](https://agent.echoauth.dev/register).

**2. Voer je licentiesleutel in**

Plak de sleutel uit je aankoopmail. Die ziet eruit als `ECHO-XXXX-XXXX-XXXX-XXXX`.

**3. Kies een gebruikersnaam en wachtwoord**

Je wachtwoord moet minimaal 8 tekens hebben. Klik op **Create account**.

![Registratieformulier met velden voor licentiesleutel, gebruikersnaam en wachtwoord](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

De registratiepagina

Zodra je licentie actief is, wordt je agent voor je aangemaakt. Je komt op het dashboard, waar je de agent, je licentie en gebruiksstatistieken ziet.

![Dashboard met één agent, licentiestatus en gebruik](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

Het dashboard na het inloggen

> [!NOTE]
>
> Zie je **No agents yet**, open dan **License** in de zijbalk en controleer of je licentie actief is.

Klik op je agent om de pagina te openen. Al het andere in deze handleiding begint hier: **Configure** opent de instellingen, **Live logs** toont wat de agent doet en **Update Agent** past instellingen toe die een nieuwe deploy nodig hebben.

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

De agentpagina

## 2. Maak je Discord-bot aan

Je agent antwoordt via een Discord-bot die van jou is. Maak er een aan in het Discord Developer Portal.

**1. Maak een applicatie aan**

Open het [Discord Developer Portal](https://discord.com/developers/applications) en klik op **New Application**. Noem hem naar je supportagent, bijvoorbeeld "Acme Support".

**2. Schakel de Message Content-intent in**

Ga naar **Bot**. Zet onder **Privileged Gateway Intents** de **Message Content Intent** aan en sla op.

> [!WARNING]
>
> Zonder deze intent ontvangt de bot lege berichten en antwoordt hij nooit.

**3. Kopieer het bottoken**

Klik, nog steeds bij **Bot**, op **Reset Token** en kopieer het token. Je plakt het in de volgende sectie in het dashboard. Houd het privé: iedereen met het token kan je bot besturen.

**4. Nodig de bot uit op je server**

Ga naar **OAuth2** → **URL Generator**. Vink de scopes `bot` en `applications.commands` aan en daarna deze botpermissies:

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

Open de gegenereerde URL en voeg de bot toe aan je server.

**5. Geef de bot toegang tot je ticketcategorie**

Zorg dat de rol van de bot de categorie kan zien waarin je ticketkanalen worden aangemaakt. Kan hij het kanaal niet zien, dan kan hij niet antwoorden.

## 3. Voeg je sleutels toe

Maak een API-sleutel aan op [openrouter.ai/keys](https://openrouter.ai/keys) en voeg wat tegoed toe aan je OpenRouter-account. Het vision-model is gratis, maar de chat- en embeddingmodellen worden per gebruik betaald.

Klik vervolgens op je agentpagina op **Configure** en open het tabblad **API Keys**.

![Tabblad API Keys met de OpenRouter-API-sleutel en het Discord-bottoken gemarkeerd als configured](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

Het tabblad API Keys, met de OpenRouter-sleutel en het Discord-bottoken ingesteld

1. Plak je sleutel in **OpenRouter API Key**.
2. Plak je **Discord Bot Token**.
3. Klik op **Save**.

De velden voor OpenAI, Anthropic en NVIDIA kun je leeg laten. Sleutels worden versleuteld opgeslagen en na het opslaan nooit meer getoond. Een badge **configured** bevestigt dat een sleutel is ingesteld.

## 4. Kies je AI-modellen

Open het tabblad **AI Settings**. De agent gebruikt drie modellen. Zet ze alle drie op **OpenRouter** en kies de aanbevolen modellen:

| Instelling | Wat het doet | Provider | Model |
| - | - | - | - |
| **Chat / Agent Model** | Schrijft de antwoorden en bepaalt wat er in je docs moet worden opgezocht. | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | Leest screenshots die klanten aan tickets toevoegen. | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | Indexeert je documentatie en doorzoekt die. | OpenRouter | `qwen/qwen3-embedding-8b` |

![Tabblad AI Settings met OpenRouter geselecteerd voor chat-, vision- en embeddingmodellen](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

Het tabblad AI Settings met de aanbevolen OpenRouter-modellen

> [!NOTE]
>
> Onder het embeddingmodel waarschuwt het dashboard dat het boven de 2000 dimensies zit. Dat is te verwachten bij `qwen/qwen3-embedding-8b`. Zoeken werkt nog steeds: het controleert elke passage in plaats van een index te gebruiken, en dat blijft snel bij een kennisbank van enkele duizenden passages.

Schrijf daarna je **Base Prompt**. Dat zijn de vaste instructies van de agent: voor wie hij werkt, welke toon hij gebruikt en wat hij nooit mag doen. Bijvoorbeeld:

```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]
>
> Kies je embeddingmodel voordat je iets indexeert. Als je het later wijzigt, is de bestaande index onbruikbaar totdat je hem opnieuw opbouwt.

## 5. Koppel hem aan je tickets

Open het tabblad **Discord**. Deze instellingen vertellen de agent waar hij moet antwoorden en wie als staff telt.

![Tabblad Discord met owner-rollen, staff-rollen, ticketcategorie-ID's, ticketbot-ID's en afbeeldingsmodellen](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

Het tabblad Discord

Om ID's te kopiëren zet je in Discord **Developer Mode** aan onder **User Settings** → **Advanced**. Klik daarna met de rechtermuisknop op een rol, categorie of gebruiker en kies **Copy ID**.

> [accordion] Owner Role IDs
>
> Rollen die alle slash-commando's mogen gebruiken, inclusief `/pause_bot` en `/edit_base`. Scheid meerdere ID's met komma's.

> [accordion] Staff Role IDs
>
> De rollen van je supportteam. Wanneer een staffmedewerker in een ticket schrijft, trekt de agent zich terug en blijft hij stil in dat ticket. Om hem terug te halen, vermeld je de bot in het ticket of gebruik je daar `/restart`.

> [accordion] Ticket Category IDs
>
> De categorieën waarin je ticketkanalen worden aangemaakt. De agent antwoordt alleen binnen deze categorieën.

> [accordion] Ticket Bot IDs
>
> Het gebruikers-ID van je ticketbot, zoals Ticket Tool of SellAuth Tickets. De agent negeert andere bots, dus voeg die van jou hier toe zodat de agent het openingsbericht van het ticket kan lezen.

> [accordion] Image Models
>
> Back-up-vision-modellen, één per regel, die op volgorde worden geprobeerd als het vision-model uit AI Settings faalt. Zet hier deze fallbacks:\
> `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`

Klik op **Save**.

## 6. Geef de agent je documentatie

Open het tabblad **Knowledge Base**. De agent antwoordt vanuit twee bronnen en je kunt één of beide gebruiken.

![Tabblad Knowledge Base met de knop Index documentation, Docs URL en interne kennisbank](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

Het tabblad Knowledge Base

> [tab] Docs site
>
> Gebruik dit als je documentatie op Mintlify is gepubliceerd.
>
> 1. Voer je **Docs URL** in, bijvoorbeeld `https://docs.acme-store.com`, zonder slash aan het einde. De site moet `/llms.txt` aanbieden, wat Mintlify automatisch doet.
> 2. Klik op **Save**, ga naar je agentpagina en klik op **Update Agent**.
> 3. Klik terug op dit tabblad op **Index documentation**. Een paar honderd pagina's duurt een paar minuten en je kunt de pagina verlaten terwijl het loopt.
>
> Met **Sync Mode** op **Poll llms.txt hourly** controleert de agent elk uur je docs en indexeert alleen de gewijzigde pagina's opnieuw.

> [tab] Internal knowledge base
>
> Gebruik dit voor alles wat niet op een docs-site staat: veelgestelde vragen, beleid, foutcodes.
>
> 1. Scroll naar **Internal Knowledge Base**.
> 2. Plak je tekst, of klik op **Load file** en kies een `.txt`- of `.md`-bestand.
> 3. Klik op **Save**.
>
> De agent indexeert het binnen ongeveer een minuut. Platte tekst is prima: koppen in HOOFDLETTERS of tussen regels met `=====` worden doorzoekbare secties.

Laat **Documentation Retrieval** en **Agentic Retrieval** aan staan. Met retrieval zoekt de agent alleen de passages op die relevant zijn voor elke vraag, in plaats van elke keer alles te lezen.

## 7. Stel antwoordtiming en escalatie in

Open het tabblad **Behavior**.

![Tabblad Behavior met antwoordtiming en trefwoorden voor menselijke hulp](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

Het tabblad Behavior

De agent wacht tot de klant is gestopt met typen en beantwoordt dan alles in één antwoord. Elk nieuw bericht zet de timer opnieuw in gang.

| Instelling | Standaard | Betekenis |
| - | - | - |
| After ticket opens | 45 s | Wachttijd na het eerste bericht, omdat klanten vaak details of screenshots toevoegen. |
| After each message | 30 s | Rustige tijd die nodig is na latere berichten voordat er wordt geantwoord. |
| Maximum wait | 180 s | Antwoord na zoveel tijd, ook als de klant blijft typen. |

Noem onder **Human Help Keywords** woorden die het ticket aan je team moeten overdragen, één per regel. Bijvoorbeeld `refund`, `chargeback` of `real person`.

## 8. Ontvang meldingen (optioneel)

Open het tabblad **Notifications** en plak het ID van een privé-stafkanaal. De agent plaatst daar een bericht wanneer je licentie bijna verloopt en wanneer een AI-provider je sleutel weigert of je quotum op is.

![Tabblad Notifications met het ID van het notificatiekanaal](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

Het tabblad Notifications

## 9. Start de agent

Ga terug naar je agentpagina en klik op **Update Agent**. Hiermee wordt de agent opnieuw uitgerold met je bottoken, docs-URL en embeddingmodel. De uitvoer verschijnt onder de knop terwijl het loopt.

> [!NOTE]
>
> De meeste instellingen bereiken de draaiende agent binnen ongeveer een minuut, zonder nieuwe deploy. Je hebt **Update Agent** alleen nodig na het wijzigen van het **Discord Bot Token**, de **Docs URL**, het **Embedding Model** of de **Sync Mode**.

Om te controleren of alles werkt:

1. Open een testticket in je server en stel een vraag die je docs beantwoorden.
2. Open **Live logs** op je agentpagina en kijk hoe de agent het bericht ontvangt, je docs doorzoekt en antwoordt.

![Live logs waarin de agent start, synchroniseert, de docs doorzoekt en in een ticket antwoordt](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

Live logs

De statusbadge van je agent toont **Online** wanneer hij draait.

## Slash-commando's

Zodra de agent in je server zit, kunnen owners en staff hem vanuit Discord besturen.

| Commando | Wie | Wat het doet |
| - | - | - |
| `/stop` | Owner, staff | Laat de agent in dit kanaal niet meer antwoorden. |
| `/restart` | Owner, staff | Laat de agent in dit kanaal weer antwoorden. |
| `/mute_existing` | Owner, staff | Zet de agent stil in elk ticket dat al open is. |
| `/pause_bot` | Owner | Pauzeer de agent overal. |
| `/resume_bot` | Owner | Hervat de agent overal. |
| `/edit_base` | Owner | Bewerk de base prompt. |
| `/chat_model` | Owner | Wijzig het chatmodel. |

Je kunt de agent ook pauzeren vanuit het dashboard met **Global Bot Pause** op het tabblad **Discord**.

## Houd je licentie actief

Je agent blijft online zolang je licentie actief is. De pagina **License** toont de resterende dagen en je verloopdatum.

![Licentiepagina met status, resterende dagen en beschikbare plannen](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

De pagina License

Om te verlengen koop je een nieuwe sleutel in de [shop](https://shop.echoauth.dev/product/echos-ai-agent-hosted), klik je op **Renew license** en plak je de sleutel. De tijd wordt bij je huidige licentie opgeteld.

## Probleemoplossing

> [accordion] De bot is online maar antwoordt nooit
>
> * Controleer of **Message Content Intent** aan staat in het Discord Developer Portal.
> * Controleer of het categorie-ID van het ticket in **Ticket Category IDs** staat.
> * Controleer of de bot in die categorie kan kijken en berichten kan versturen.
> * Controleer of een staffmedewerker nog niet in het ticket heeft geschreven. Vermeld de bot of gebruik `/restart` om hem terug te halen.
> * Controleer of **Global Bot Pause** uit staat.

> [accordion] De bot negeert het openingsbericht van het ticket
>
> Voeg het gebruikers-ID van je ticketbot toe aan **Ticket Bot IDs** op het tabblad **Discord**.

> [accordion] De agent gebruikt mijn documentatie niet
>
> Open het tabblad **Knowledge Base**. Staat er **Documentation is not indexed yet**, klik dan op **Index documentation**. Staat er **The index does not match the embedding model**, klik dan op **Clear and rebuild the index**, of zet het embeddingmodel terug naar het getoonde model en sla op.

> [accordion] Antwoorden of indexeren mislukken met een OpenRouter-fout
>
> Controleer of je OpenRouter-account tegoed heeft en of de sleutel op het tabblad **API Keys** nog geldig is. Gratis modellen zoals het vision-model kunnen op drukke momenten een ratelimit krijgen; de agent valt dan terug op het volgende model in **Image Models**.

> [accordion] De agent reageert niet meer
>
> Open **Live logs** en zoek naar fouten, bijvoorbeeld een ongeldige sleutel of op tegoed. Klik daarna op **Restart** op de agentpagina. Helpt dat niet, klik dan op **Update Agent**.


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