Passer au contenu principal
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 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. 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.
Configuration recommandée. Les tests à long terme ont été réalisés uniquement avec OpenRouter, avec ces trois modèles :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

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

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

Le tableau de bord après la connexion

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

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

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 :
Onglet AI Settings avec OpenRouter sélectionné pour les modèles de chat, vision et embedding

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

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 :
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

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.
Rôles qui peuvent utiliser toutes les commandes slash, y compris /pause_bot et /edit_base. Sépare plusieurs ID par des virgules.
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.
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.
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.
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

L'onglet Knowledge Base

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

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

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

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

La page License

Pour renouveler, achète une nouvelle clé dans la boutique, clique sur Renew license et colle la clé. Le temps est ajouté à ta licence actuelle.

Dépannage

  • 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é.
Ajoute l’ID utilisateur de ton bot de tickets dans Ticket Bot IDs sur l’onglet Discord.
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.
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.
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.