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

# Guide de configuration de l'agent IA

> D'une clé de licence à un agent IA qui répond à tes tickets Discord.

La configuration prend environ 15 minutes. Il te faut quatre choses :

* Une **clé de licence** EchoAuth AI Agent. [Achète-en une dans la boutique](https://shop.echoauth.dev/product/echos-ai-agent-hosted) si tu n'en as pas encore.
* Un **serveur Discord** où tu peux ajouter des bots et gérer des rôles.
* Une **clé API [OpenRouter](https://openrouter.ai)**. Une seule clé OpenRouter couvre tout ce dont l'agent a besoin : réponses, captures d'écran et recherche.
* Facultativement, un **site de documentation** ou de la documentation écrite à partir de laquelle l'agent peut répondre.

Nous hébergeons ton agent et le gardons en marche. Tu le configures depuis le tableau de bord sur [agent.echoauth.dev](https://agent.echoauth.dev).

> [!NOTE]
>
> **Configuration recommandée.** Les tests à long terme ont été réalisés uniquement avec OpenRouter, avec ces trois modèles :
>
> | Rôle | Modèle |
> | - | - |
> | Chat / Agent | `deepseek/deepseek-v4-flash-0731` |
> | Embedding | `qwen/qwen3-embedding-8b` |
> | Vision (détection d'images) | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> D'autres fournisseurs (NVIDIA, OpenAI, Anthropic) sont disponibles dans le tableau de bord, mais c'est cette combinaison que nous avons testée dans la durée.

## 1. Créer ton compte

**1. Ouvrir la page d'inscription**

Va sur [agent.echoauth.dev/register](https://agent.echoauth.dev/register).

**2. Saisir ta clé de licence**

Colle la clé de ton e-mail d'achat. Elle ressemble à `ECHO-XXXX-XXXX-XXXX-XXXX`.

**3. Choisir un nom d'utilisateur et un mot de passe**

Ton mot de passe doit contenir au moins 8 caractères. Clique sur **Create account**.

![Formulaire d'inscription avec les champs clé de licence, nom d'utilisateur et mot de passe](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

La page d'inscription

Une fois ta licence active, ton agent est créé pour toi. Tu arrives sur le tableau de bord, où tu vois l'agent, ta licence et les statistiques d'utilisation.

![Tableau de bord affichant un agent, l'état de la licence et l'utilisation](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

Le tableau de bord après la connexion

> [!NOTE]
>
> Si **No agents yet** s'affiche, ouvre **License** dans la barre latérale et vérifie que ta licence est active.

Clique sur ton agent pour ouvrir sa page. Tout le reste de ce guide part d'ici : **Configure** ouvre les paramètres, **Live logs** montre ce que fait l'agent, et **Update Agent** applique les paramètres qui nécessitent un redéploiement.

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

La page de l'agent

## 2. Créer ton bot Discord

Ton agent répond via un bot Discord qui t'appartient. Crée-le dans le Discord Developer Portal.

**1. Créer une application**

Ouvre le [Discord Developer Portal](https://discord.com/developers/applications) et clique sur **New Application**. Donne-lui le nom de ton agent de support, par exemple "Acme Support".

**2. Activer l'intent Message Content**

Va dans **Bot**. Sous **Privileged Gateway Intents**, active **Message Content Intent** et enregistre.

> [!WARNING]
>
> Sans cet intent, le bot reçoit des messages vides et ne répond jamais.

**3. Copier le token du bot**

Toujours dans **Bot**, clique sur **Reset Token** et copie le token. Tu le colleras dans le tableau de bord dans la section suivante. Garde-le privé : quiconque possède le token peut contrôler ton bot.

**4. Inviter le bot sur ton serveur**

Va dans **OAuth2** → **URL Generator**. Coche les scopes `bot` et `applications.commands`, puis ces permissions du bot :

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

Ouvre l'URL générée et ajoute le bot à ton serveur.

**5. Donner au bot l'accès à ta catégorie de tickets**

Assure-toi que le rôle du bot peut voir la catégorie dans laquelle tes salons de tickets sont créés. S'il ne voit pas le salon, il ne peut pas répondre.

## 3. Ajouter tes clés

Crée une clé API sur [openrouter.ai/keys](https://openrouter.ai/keys) et ajoute du crédit à ton compte OpenRouter. Le modèle de vision est gratuit, mais les modèles de chat et d'embedding sont payés à l'usage.

Ensuite, sur la page de ton agent, clique sur **Configure** et ouvre l'onglet **API Keys**.

![Onglet API Keys montrant la clé API OpenRouter et le token du bot Discord marqués comme configured](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

L'onglet API Keys, avec la clé OpenRouter et le token du bot Discord configurés

1. Colle ta clé dans **OpenRouter API Key**.
2. Colle ton **Discord Bot Token**.
3. Clique sur **Save**.

Tu peux laisser vides les champs OpenAI, Anthropic et NVIDIA. Les clés sont stockées chiffrées et ne sont plus jamais affichées après l'enregistrement. Un badge **configured** confirme qu'une clé est définie.

## 4. Choisir tes modèles d'IA

Ouvre l'onglet **AI Settings**. L'agent utilise trois modèles. Règle les trois sur **OpenRouter** et choisis les modèles recommandés :

| Paramètre | À quoi il sert | Fournisseur | Modèle |
| - | - | - | - |
| **Chat / Agent Model** | Rédige les réponses et décide quoi chercher dans ta documentation. | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | Lit les captures d'écran que les clients joignent aux tickets. | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | Indexe ta documentation et la parcourt. | OpenRouter | `qwen/qwen3-embedding-8b` |

![Onglet AI Settings avec OpenRouter sélectionné pour les modèles de chat, vision et embedding](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

L'onglet AI Settings avec les modèles OpenRouter recommandés

> [!NOTE]
>
> Sous le modèle d'embedding, le tableau de bord avertit qu'il dépasse 2000 dimensions. C'est normal pour `qwen/qwen3-embedding-8b`. La recherche fonctionne quand même : elle examine chaque passage au lieu d'utiliser un index, ce qui reste rapide pour une base de connaissances de quelques milliers de passages.

Rédige ensuite ton **Base Prompt**. Ce sont les instructions permanentes de l'agent : pour qui il travaille, le ton à employer et ce qu'il ne doit jamais faire. Par exemple :

```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]
>
> Choisis ton modèle d'embedding avant d'indexer quoi que ce soit. Le changer plus tard rend l'index existant inutilisable tant que tu ne le reconstruis pas.

## 5. Le connecter à tes tickets

Ouvre l'onglet **Discord**. Ces paramètres indiquent à l'agent où répondre et qui fait partie du staff.

![Onglet Discord avec rôles owner, rôles staff, ID des catégories de tickets, ID des bots de tickets et modèles d'image](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

L'onglet Discord

Pour copier des ID, active **Developer Mode** dans Discord sous **User Settings** → **Advanced**. Fais ensuite un clic droit sur un rôle, une catégorie ou un utilisateur et choisis **Copy ID**.

> [accordion] Owner Role IDs
>
> Rôles qui peuvent utiliser toutes les commandes slash, y compris `/pause_bot` et `/edit_base`. Sépare plusieurs ID par des virgules.

> [accordion] Staff Role IDs
>
> Les rôles de ton équipe de support. Quand un membre du staff écrit dans un ticket, l'agent s'efface et reste silencieux dans ce ticket. Pour le faire revenir, mentionne le bot dans le ticket ou utilise `/restart` là-bas.

> [accordion] Ticket Category IDs
>
> Les catégories dans lesquelles tes salons de tickets sont créés. L'agent ne répond qu'à l'intérieur de ces catégories.

> [accordion] Ticket Bot IDs
>
> L'ID utilisateur de ton bot de tickets, comme Ticket Tool ou SellAuth Tickets. L'agent ignore les autres bots : ajoute donc le tien ici pour que l'agent puisse lire le message d'ouverture du ticket.

> [accordion] Image Models
>
> Modèles de vision de secours, un par ligne, essayés dans l'ordre si le modèle de vision des AI Settings échoue. Indique ces solutions de repli :\
> `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`

Clique sur **Save**.

## 6. Donner ta documentation à l'agent

Ouvre l'onglet **Knowledge Base**. L'agent répond à partir de deux sources, tu peux en utiliser une ou les deux.

![Onglet Knowledge Base avec le bouton Index documentation, l'URL de la documentation et la base de connaissances interne](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

L'onglet Knowledge Base

> [tab] Docs site
>
> Utilise ceci si ta documentation est publiée sur Mintlify.
>
> 1. Saisis ton **Docs URL**, par exemple `https://docs.acme-store.com`, sans barre oblique finale. Le site doit servir `/llms.txt`, ce que Mintlify fait automatiquement.
> 2. Clique sur **Save**, puis va sur la page de ton agent et clique sur **Update Agent**.
> 3. De retour dans cet onglet, clique sur **Index documentation**. Quelques centaines de pages prennent quelques minutes, et tu peux quitter la page pendant ce temps.
>
> Avec **Sync Mode** sur **Poll llms.txt hourly**, l'agent vérifie ta documentation toutes les heures et ne réindexe que les pages modifiées.

> [tab] Internal knowledge base
>
> Utilise ceci pour tout ce qui ne figure pas sur un site de documentation : FAQ, politiques, codes d'erreur.
>
> 1. Fais défiler jusqu'à **Internal Knowledge Base**.
> 2. Colle ton texte, ou clique sur **Load file** et choisis un fichier `.txt` ou `.md`.
> 3. Clique sur **Save**.
>
> L'agent l'indexe en environ une minute. Le texte brut suffit : les titres en MAJUSCULES ou entre des lignes de `=====` deviennent des sections consultables.

Laisse **Documentation Retrieval** et **Agentic Retrieval** activés. Avec la récupération activée, l'agent ne cherche que les passages pertinents pour chaque question au lieu de tout relire à chaque fois.

## 7. Définir les délais de réponse et l'escalade

Ouvre l'onglet **Behavior**.

![Onglet Behavior avec les délais de réponse et les mots-clés d'aide humaine](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

L'onglet Behavior

L'agent attend que le client ait fini de taper, puis répond à tout en une seule réponse. Chaque nouveau message relance le minuteur.

| Paramètre | Par défaut | Signification |
| - | - | - |
| After ticket opens | 45 s | Attente après le premier message, car les clients ajoutent souvent des détails ou des captures d'écran. |
| After each message | 30 s | Temps de silence nécessaire après les messages suivants avant de répondre. |
| Maximum wait | 180 s | Répond après ce délai même si le client continue de taper. |

Sous **Human Help Keywords**, liste les mots qui doivent transmettre le ticket à ton équipe, un par ligne. Par exemple `refund`, `chargeback` ou `real person`.

## 8. Recevoir des alertes (facultatif)

Ouvre l'onglet **Notifications** et colle l'ID d'un salon privé du staff. L'agent y publie quand ta licence est sur le point d'expirer et quand un fournisseur d'IA rejette ta clé ou épuise ton quota.

![Onglet Notifications avec l'ID du salon de notification](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

L'onglet Notifications

## 9. Démarrer l'agent

Retourne sur la page de ton agent et clique sur **Update Agent**. Cela redéploie l'agent avec ton token de bot, ton URL de documentation et ton modèle d'embedding. La sortie s'affiche sous le bouton pendant l'exécution.

> [!NOTE]
>
> La plupart des paramètres atteignent l'agent en cours d'exécution en environ une minute, sans redéploiement. Tu n'as besoin de **Update Agent** qu'après avoir modifié le **Discord Bot Token**, le **Docs URL**, le **Embedding Model** ou le **Sync Mode**.

Pour vérifier que tout fonctionne :

1. Ouvre un ticket de test sur ton serveur et pose une question dont ta documentation donne la réponse.
2. Ouvre **Live logs** sur la page de ton agent et regarde l'agent recevoir le message, chercher dans ta documentation et répondre.

![Live logs montrant l'agent démarrer, se synchroniser, chercher dans la documentation et répondre dans un ticket](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

Live logs

Le badge d'état de ton agent indique **Online** quand il fonctionne.

## Commandes slash

Une fois l'agent sur ton serveur, les owners et le staff peuvent le contrôler depuis Discord.

| Commande | Qui | Ce qu'elle fait |
| - | - | - |
| `/stop` | Owner, staff | Empêche l'agent de répondre dans ce salon. |
| `/restart` | Owner, staff | Permet à l'agent de répondre à nouveau dans ce salon. |
| `/mute_existing` | Owner, staff | Arrête l'agent dans tous les tickets déjà ouverts. |
| `/pause_bot` | Owner | Met l'agent en pause partout. |
| `/resume_bot` | Owner | Relance l'agent partout. |
| `/edit_base` | Owner | Modifie le base prompt. |
| `/chat_model` | Owner | Change le modèle de chat. |

Tu peux aussi mettre l'agent en pause depuis le tableau de bord avec **Global Bot Pause** dans l'onglet **Discord**.

## Garder ta licence active

Ton agent reste en ligne tant que ta licence est active. La page **License** affiche les jours restants et ta date d'expiration.

![Page License avec l'état, les jours restants et les offres disponibles](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

La page License

Pour renouveler, achète une nouvelle clé dans la [boutique](https://shop.echoauth.dev/product/echos-ai-agent-hosted), clique sur **Renew license** et colle la clé. Le temps est ajouté à ta licence actuelle.

## Dépannage

> [accordion] Le bot est en ligne mais ne répond jamais
>
> * Vérifie que **Message Content Intent** est activé dans le Discord Developer Portal.
> * Vérifie que l'ID de catégorie du ticket figure dans **Ticket Category IDs**.
> * Vérifie que le bot peut voir et envoyer des messages dans cette catégorie.
> * Vérifie qu'un membre du staff n'a pas déjà écrit dans le ticket. Mentionne le bot ou utilise `/restart` pour le faire revenir.
> * Vérifie que **Global Bot Pause** est désactivé.

> [accordion] Le bot ignore le message d'ouverture du ticket
>
> Ajoute l'ID utilisateur de ton bot de tickets dans **Ticket Bot IDs** sur l'onglet **Discord**.

> [accordion] L'agent n'utilise pas ma documentation
>
> Ouvre l'onglet **Knowledge Base**. S'il indique **Documentation is not indexed yet**, clique sur **Index documentation**. S'il indique **The index does not match the embedding model**, clique sur **Clear and rebuild the index**, ou remets le modèle d'embedding sur celui affiché et enregistre.

> [accordion] Les réponses ou l'indexation échouent avec une erreur OpenRouter
>
> Vérifie que ton compte OpenRouter a du crédit et que la clé de l'onglet **API Keys** est toujours valide. Les modèles gratuits comme le modèle de vision peuvent être limités en débit aux heures de pointe ; l'agent bascule alors sur le modèle suivant de **Image Models**.

> [accordion] L'agent ne répond plus
>
> Ouvre **Live logs** et cherche des erreurs, par exemple une clé invalide ou un crédit épuisé. Clique ensuite sur **Restart** sur la page de l'agent. Si cela ne suffit pas, clique sur **Update Agent**.


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