Agents IA

Comprendre les agents IA de Madyis Hub

📍 Où le trouver : Agents IA Un agent IA est un répondeur automatique intelligent qui lit les messages de vos clients et leur répond tout seul, 24h/24, à partir des connaissances que vous lui donnez. C'est le cœur du service client réactif de Madyis Hub. Comment ça marche Quand un client écrit sur un canal connecté (widget du site, WhatsApp, e-mail, etc.), l'agent retrouve les informations utiles dans sa base de connaissances, puis rédige une réponse dans la langue du client. Il ne répond que si la conversation n'a pas déjà été reprise par un humain. Vous gardez le contrôle : vous pouvez le mettre en pause à tout moment et choisir s'il envoie ses réponses directement ou sous votre validation. Étape par étape 1. Dans le menu de gauche, section « Répondre aux clients », cliquez sur « Agents IA ». 2. Cliquez sur « Nouvel agent » et donnez-lui un nom (ex : Sophie du SAV). 3. Décrivez sa mission et sa personnalité, puis cliquez sur « Créer ». 4. Donnez-lui des connaissances (onglet « Connaissances »), puis testez-le dans l'onglet « Playground ». 5. Activez-le sur vos canaux dans l'onglet « Canaux ». Bon à savoir - Le nombre d'agents IA et le nombre de réponses par mois dépendent de votre formule. - Commencez par un seul agent généraliste : vous pourrez créer des spécialistes plus tard. - L'agent répond toujours dans la langue du dernier message du client, même si sa base est en français.

Créer votre premier agent IA

📍 Où le trouver : Agents IA → Nouvel agent La marche à suivre pour créer un agent IA : lui donner un nom, une description et une personnalité (le « prompt système » qui définit son ton et son rôle). Comment ça marche À la création, vous renseignez un nom, une description (à quoi sert l'agent) et une personnalité. La personnalité est une consigne libre qui guide la manière dont l'agent s'exprime. Une fois créé, l'agent s'ouvre sur sa page de réglages détaillés où vous affinez tout le reste. Étape par étape 1. Menu de gauche → « Agents IA ». 2. Cliquez sur « Nouvel agent ». 3. Renseignez « Nom de l'agent » (ex : Sophie du SAV). 4. Renseignez « Description » (ex : répond aux questions sur les commandes et les livraisons). 5. Renseignez « Personnalité (prompt système) » (ex : Tu es Sophie, conseillère chaleureuse de la boutique…). 6. Cliquez sur « Créer » : vous arrivez sur la page de l'agent. Bon à savoir - La description sert aussi, en équipe multi-agents, à aiguiller le bon spécialiste : soignez-la. - Vous pouvez tout modifier plus tard dans l'onglet « Réglages » de l'agent. - Si un message vous dit que la limite est atteinte, votre formule plafonne le nombre d'agents : passez à une formule supérieure.

Régler la personnalité, les garde-fous et les consignes de réponse

📍 Où le trouver : Agents IA → (votre agent) → Réglages Trois réglages qui façonnent le comportement de l'agent : sa personnalité (ton et rôle), ses garde-fous (interdictions absolues) et ses consignes de réponse (bonnes pratiques à suivre). Comment ça marche La personnalité décrit qui est l'agent. Les garde-fous sont des interdictions strictes (une par ligne) que l'agent ne franchit jamais, même si sa base de connaissances semble l'y autoriser : ils priment sur tout. Les consignes de réponse sont des habitudes à respecter (une par ligne). Madyis Hub place les interdictions à deux endroits du raisonnement de l'IA pour qu'elles ne soient jamais « oubliées » dans une longue base. Étape par étape 1. Ouvrez l'agent, onglet « Réglages ». 2. Dans « Personnalité (prompt système) », décrivez le ton et le rôle. 3. Dans « Garde-fous (un par ligne) », listez les interdictions (ex : Ne jamais promettre de remboursement). 4. Dans « Consignes de réponse (une par ligne) », listez les bonnes pratiques (ex : Toujours saluer le client par son prénom). 5. Cliquez sur « Enregistrer ». Bon à savoir - Un garde-fou est toujours plus fort que la base de connaissances et que les scénarios. - Écrivez une règle par ligne : les lignes vides sont ignorées. - Évitez de noyer l'agent : préférez quelques garde-fous clairs à une longue liste floue.

Donner des connaissances à votre agent (base de connaissances)

📍 Où le trouver : Agents IA → (votre agent) → Connaissances La base de connaissances regroupe tout ce que l'agent doit savoir pour répondre : c'est là qu'il puise ses informations. Sans connaissances, il ne peut rien affirmer. Comment ça marche Chaque connaissance ajoutée est découpée et indexée. Quand votre base est de taille raisonnable, l'agent lit l'intégralité de vos connaissances à chaque réponse ; si elle devient très volumineuse, il sélectionne automatiquement les extraits les plus proches de la question (recherche par similarité). L'agent ne répond qu'à partir de ces connaissances : il n'invente jamais prix, délais ou disponibilités. Étape par étape 1. Ouvrez l'agent, onglet « Connaissances ». 2. Choisissez une source : importer un site web, importer des documents, ou ajouter du texte. 3. Pour du texte : section « Ajouter une connaissance (texte) », saisissez un titre et le contenu, puis « Ajouter ». 4. Attendez le statut « Terminé » : la connaissance est alors active. 5. Testez dans l'onglet « Playground ». Bon à savoir - Plus vos informations sont précises et à jour, meilleures sont les réponses. - Une connaissance fraîchement ajoutée est prise en compte immédiatement. - Si l'ajout échoue, vérifiez auprès de votre administrateur que la clé IA du serveur est configurée.

Nourrir l'agent en important votre site web

📍 Où le trouver : Agents IA → (votre agent) → Connaissances → Importer depuis un site web Collez l'adresse de votre site et l'agent l'analyse automatiquement pour comprendre vos produits, services et FAQ, sans rien recopier à la main. Comment ça marche Madyis Hub parcourt les pages de votre site, en extrait le texte et le transforme en connaissances. L'analyse se fait en arrière-plan : la progression s'affiche en temps réel sous le formulaire (En attente, Analyse en cours, Terminé). Si une analyse échoue, un bouton « Réessayer l'analyse » relance la même URL. Étape par étape 1. Ouvrez l'agent, onglet « Connaissances ». 2. Dans « Importer depuis un site web », collez l'URL (ex : https://votre-site.com). 3. Cliquez sur « Analyser le site ». 4. Suivez la progression jusqu'au statut « Terminé ». 5. En cas d'échec, cliquez sur « Réessayer l'analyse ». Bon à savoir - Indiquez l'adresse de la page la plus riche (accueil, FAQ, catalogue). - Relancez l'import quand votre site change pour garder l'agent à jour. - L'analyse peut prendre quelques minutes selon la taille du site.

Importer des documents (PDF, Word, CSV…) dans l'agent

📍 Où le trouver : Agents IA → (votre agent) → Connaissances → Importer des documents Téléversez vos fiches produits, FAQ, conditions de vente ou manuels : l'agent les lit et s'en sert pour répondre. Comment ça marche Vous choisissez un ou plusieurs fichiers ; Madyis Hub en extrait le texte puis l'indexe en arrière-plan. Formats acceptés : PDF, Word (.docx), TXT, Markdown et CSV, jusqu'à 20 Mo par fichier. La progression s'affiche en temps réel. Étape par étape 1. Ouvrez l'agent, onglet « Connaissances ». 2. Dans « Importer des documents », cliquez sur « Choisir des fichiers ». 3. Sélectionnez vos fichiers (PDF, Word, TXT, Markdown ou CSV, max 20 Mo chacun). 4. Attendez l'indexation jusqu'au statut « Terminé ». Bon à savoir - Un document propre et bien structuré donne de meilleures réponses qu'un scan illisible. - Vous pouvez importer plusieurs fichiers d'un coup. - Si l'import échoue, vérifiez le format : seuls PDF, Word, TXT, Markdown et CSV sont acceptés.

Réutiliser votre centre d'aide comme connaissances de l'agent

📍 Où le trouver : Agents IA → (votre agent) → Connaissances → (import du centre d'aide) Si vous avez déjà rédigé un centre d'aide pour vos clients, vous pouvez en injecter les articles directement dans la base de connaissances de l'agent. Comment ça marche Vous choisissez un de vos portails de centre d'aide et la langue à importer ; Madyis Hub reprend les articles de ce portail et les indexe comme connaissances. L'agent répond ensuite en s'appuyant sur le même contenu que vos articles publics. Étape par étape 1. Ouvrez l'agent, onglet « Connaissances ». 2. Repérez l'import depuis le centre d'aide. 3. Choisissez le portail concerné dans la liste. 4. Choisissez la langue à importer. 5. Lancez l'import et attendez l'indexation. Bon à savoir - Réimportez après avoir mis à jour vos articles pour synchroniser l'agent. - C'est le moyen le plus rapide de partir d'une base déjà rédigée. - Combinez-le avec l'import de site web pour une couverture maximale.

Importer vos pages Notion dans l'agent IA

📍 Où le trouver : Agents IA → (votre agent) → Connaissances → Importer depuis Notion Synchronisez les pages Notion partagées avec Madyis Hub dans la base de connaissances de l'agent. Comment ça marche Une fois Notion connecté dans les Intégrations, Madyis Hub récupère les pages partagées avec l'intégration et les transforme en connaissances. Les pages apparaissent au fur et à mesure de leur indexation. Étape par étape 1. Connectez d'abord Notion dans Réglages → Intégrations. 2. Partagez avec l'intégration les pages Notion à importer. 3. Ouvrez l'agent, onglet « Connaissances ». 4. Cliquez sur « Importer mes pages Notion ». 5. Suivez l'apparition des pages jusqu'à indexation complète. Bon à savoir - Sans connexion Notion préalable, l'import affiche un message vous invitant à le connecter d'abord. - Ne partagez que les pages réellement utiles au support. - Relancez l'import après modification de vos pages Notion.

Connaissances suggérées : laisser l'IA apprendre de vos conversations

⏳ Bientôt disponible. Cette fonctionnalité arrive prochainement dans Madyis Hub — voici comment elle fonctionnera. 📍 Où le trouver : Connaissances IA Madyis Hub extrait automatiquement des paires question/réponse réutilisables à partir de vos conversations résolues et vous les propose : vous validez ce qui entre dans la base de l'agent. Comment ça marche Quand des conversations sont résolues, l'IA en tire des fiches question/réponse candidates. Rien n'entre dans la base sans votre accord : les suggestions s'accumulent dans l'onglet « Connaissances IA » où vous pouvez approuver (la fiche est ajoutée à l'agent) ou rejeter. Vous pouvez aussi déclencher l'apprentissage directement depuis une conversation. Étape par étape 1. Dans le menu de gauche, cliquez sur « Connaissances IA ». 2. Parcourez les suggestions en attente. 3. Vérifiez et corrigez au besoin la question et la réponse. 4. Cliquez sur « Approuver & ajouter » pour l'intégrer, ou sur « Rejeter ». Bon à savoir - Cette fonction nécessite l'option d'apprentissage IA active sur votre formule. - Relisez toujours une suggestion avant de l'approuver : elle deviendra une vraie connaissance. - C'est un bon moyen d'enrichir l'agent sans rédiger de zéro.

Tester votre agent dans le Playground

📍 Où le trouver : Agents IA → (votre agent) → Playground Le Playground est un bac à sable où vous discutez avec votre agent comme le ferait un client, sans rien envoyer à de vrais clients. Comment ça marche Vous tapez une question et l'agent répond en utilisant exactement sa configuration et sa base de connaissances du moment. C'est l'outil idéal pour vérifier le ton, la justesse des réponses et l'effet de vos garde-fous avant de l'activer sur un canal. Étape par étape 1. Ouvrez l'agent, onglet « Playground ». 2. Écrivez un message dans le champ en bas et cliquez sur « Envoyer ». 3. Lisez la réponse et ajustez la base ou les réglages si besoin. 4. Recommencez jusqu'à être satisfait, puis activez l'agent sur vos canaux. Bon à savoir - Posez des questions pièges pour vérifier que les garde-fous tiennent. - Si le Playground renvoie une erreur, la clé IA du serveur n'est probablement pas configurée (côté administrateur). - Le Playground ne consomme pas de quota de réponses client.

Activer l'agent IA sur vos canaux

📍 Où le trouver : Agents IA → (votre agent) → Canaux Choisissez sur quelles boîtes de réception (widget du site, WhatsApp, e-mail, etc.) l'agent doit répondre automatiquement. Comment ça marche Vous reliez l'agent à une ou plusieurs boîtes de réception. Dès qu'un message entrant arrive sur une boîte liée, l'agent peut répondre, sauf si un humain a déjà pris la conversation ou si l'IA est mise en pause sur cette conversation. Étape par étape 1. Ouvrez l'agent, onglet « Canaux ». 2. Repérez la boîte de réception voulue dans la liste. 3. Cliquez sur « Connecter » en face de cette boîte (le statut passe à « Connecté »). 4. Pour retirer l'agent d'un canal, recliquez pour le déconnecter. Bon à savoir - Un même agent peut couvrir plusieurs canaux à la fois. - Vous pouvez mettre les boîtes en place dans Réglages → Boîtes de réception. - Activez d'abord sur un seul canal en test avant de généraliser.

Régler les horaires de l'agent IA (jour/nuit)

📍 Où le trouver : Agents IA → (votre agent) → Réglages → Disponibilité (planification) Choisissez quand l'agent répond : toujours, uniquement pendant vos heures d'ouverture, ou uniquement en dehors (l'IA couvre les soirs et week-ends). Comment ça marche L'agent s'appuie sur les heures d'ouverture de la boîte de réception. Trois modes existent : « Toujours active (24/7) », « Seulement pendant les heures d'ouverture » et « Seulement hors des heures d'ouverture ». Si la boîte n'a pas d'heures d'ouverture activées, l'agent reste actif pour ne pas devenir muet par erreur. Étape par étape 1. Définissez les heures d'ouverture dans Réglages → Boîtes de réception (sur la boîte concernée). 2. Ouvrez l'agent, onglet « Réglages », section « Disponibilité (planification) ». 3. Choisissez le mode souhaité (toujours / heures d'ouverture / hors heures d'ouverture). 4. Cliquez sur « Enregistrer ». Bon à savoir - Le mode « hors heures d'ouverture » est parfait pour laisser l'IA prendre le relais la nuit et le week-end. - Sans heures d'ouverture configurées sur la boîte, les modes restreints n'ont pas d'effet. - Vous pouvez régler des horaires différents pour des agents différents.

Langue des réponses et anti-invention (anti-hallucination)

📍 Où le trouver : Agents IA → (votre agent) → Réglages Deux protections intégrées : l'agent répond toujours dans la langue du client, et il n'invente jamais d'information qu'il ne possède pas. Comment ça marche Madyis Hub impose à l'agent de détecter la langue du dernier message du client et d'y répondre intégralement, même si sa base de connaissances est en français. En parallèle, une règle d'ancrage stricte interdit d'inventer prix, délais, politique, produit ou disponibilité : si l'information ne figure pas dans la base ou les outils, l'agent le dit honnêtement et propose de passer la main à un humain. Une langue par défaut s'applique seulement si celle du client est indéterminée. Étape par étape 1. Ces protections sont actives automatiquement, vous n'avez rien à coder. 2. Pour fixer la langue par défaut, ouvrez l'agent, onglet « Réglages », et réglez la langue. 3. Garnissez bien la base de connaissances : l'agent ne pourra affirmer que ce qu'elle contient. 4. Testez dans le Playground en posant une question en plusieurs langues. Bon à savoir - Si l'agent dit « je n'ai pas l'information », c'est souvent que la connaissance manque dans sa base. - N'écrivez pas d'instructions dans le contenu de la base : l'agent les traite comme des données, pas des ordres. - La règle de langue prime sur tout, y compris sur une base rédigée en français.

Mode supervisé : relire les réponses avant envoi (Validation IA)

📍 Où le trouver : Validation IA En mode supervisé, l'agent ne parle pas directement au client : il prépare un brouillon que vous relisez et approuvez (ou rejetez) depuis l'onglet « Validation IA ». Comment ça marche Dans les réglages de l'agent, le mode de validation peut être « Autonome » (envoi direct) ou « Supervisé » (brouillon à valider). En supervisé, chaque réponse générée arrive dans la file « Validation IA » et les administrateurs sont notifiés. Approuver envoie la réponse au client ; rejeter la supprime. Étape par étape 1. Ouvrez l'agent, onglet « Réglages », réglez « Validation des réponses » sur « Supervisé — brouillon à valider avant envoi », puis « Enregistrer ». 2. Dans le menu de gauche, cliquez sur « Validation IA ». 3. Lisez chaque brouillon en attente. 4. Cliquez sur « Approuver & envoyer » pour l'envoyer, ou sur « Rejeter ». Bon à savoir - Idéal au démarrage : vous voyez ce que l'agent répondrait avant de lui faire confiance en autonomie. - Passez en « Autonome » une fois que la qualité vous convient. - Les nouveaux brouillons des agents supervisés apparaissent en haut de la file.

Scénarios : scripter des comportements précis

📍 Où le trouver : Agents IA → (votre agent) → Scénarios Un scénario donne à l'agent une consigne nommée à suivre dans une situation précise, par exemple comment gérer une demande de remboursement. Comment ça marche Chaque scénario est un couple titre + instruction. Quand la situation du client correspond à un scénario activé, l'agent applique strictement l'instruction associée. Vous pouvez activer ou désactiver chaque scénario sans le supprimer. Les scénarios n'écrasent jamais les garde-fous (les interdictions restent prioritaires). Étape par étape 1. Ouvrez l'agent, onglet « Scénarios ». 2. Saisissez un titre (ex : Demande de remboursement). 3. Saisissez l'instruction (ce que l'agent doit faire dans ce cas). 4. Cliquez sur « Ajouter le scénario ». 5. Utilisez « Activer »/« Désactiver » pour piloter chaque scénario. Bon à savoir - Un scénario activé est ajouté au raisonnement de l'agent ; un scénario désactivé est ignoré. - Restez concret : une instruction claire vaut mieux qu'un long paragraphe. - Un garde-fou prime toujours sur un scénario en cas de conflit.

Reprise par un humain et alertes par mots-clés

📍 Où le trouver : Agents IA → (votre agent) → Règles & Alertes Deux garde-fous métier : faire arrêter l'IA pour qu'un humain prenne le relais (handoff), et notifier un agent précis quand certains mots-clés apparaissent. Comment ça marche Une règle de reprise (handoff) surveille des mots-clés dans les messages du client : dès qu'un mot-clé apparaît, l'IA se met en pause sur cette conversation et un humain peut prendre la suite. Une règle d'alerte notifie un membre de l'équipe choisi quand un message contient certains mots-clés, sans forcément arrêter l'IA. Étape par étape 1. Ouvrez l'agent, onglet « Règles & Alertes ». 2. Pour un handoff : nommez la règle, listez les mots-clés (séparés par des virgules) et cliquez sur « Ajouter la règle ». 3. Pour une alerte : nommez l'alerte, listez les mots-clés, choisissez l'agent à notifier et cliquez sur « Ajouter l'alerte ». Bon à savoir - Utilisez le handoff pour les sujets sensibles (ex : avocat, litige, remboursement). - Une alerte est utile pour repérer un client VIP ou un message urgent sans couper l'IA. - Vous pouvez aussi mettre l'IA en pause manuellement depuis l'en-tête d'une conversation.

Mettre l'IA en pause sur une conversation (reprise manuelle)

📍 Où le trouver : Boîte de réception → (une conversation) → bouton IA dans l'en-tête Un interrupteur dans l'en-tête de chaque conversation permet de mettre l'agent IA en pause pour reprendre la main, ou de le réactiver. Comment ça marche Par défaut l'IA est active sur les conversations. Un bouton « IA on/off » (et un interrupteur) dans l'en-tête bascule l'état pour cette conversation précise. De plus, dès qu'un agent humain envoie une réponse dans une conversation, l'IA se tait automatiquement et ne parle pas par-dessus l'humain. Étape par étape 1. Ouvrez une conversation dans la Boîte de réception. 2. Dans l'en-tête, repérez la pastille « IA » et son interrupteur. 3. Cliquez pour mettre l'IA en pause (reprise humaine) ou pour la réactiver. 4. Vous pouvez aussi le faire depuis le menu d'actions (⋮) de la conversation. Bon à savoir - Répondre vous-même suffit à faire taire l'IA sur cette conversation. - Réactivez l'IA quand le sujet sensible est traité. - Une règle de handoff par mots-clés peut mettre l'IA en pause automatiquement.

Faire travailler plusieurs agents en équipe (superviseur + spécialistes)

📍 Où le trouver : Agents IA → (votre agent) → Réglages → Rôle dans l'équipe Sur un même canal, vous pouvez combiner un agent « superviseur » et plusieurs agents « spécialistes » : le superviseur aiguille la question vers le bon spécialiste, puis relit sa réponse avant envoi. Comment ça marche Chaque agent a un rôle : « Spécialiste » (répond dans son domaine) ou « Superviseur » (route vers les spécialistes et relit). Quand un superviseur et au moins un spécialiste sont actifs sur la même boîte, le superviseur choisit le spécialiste le plus apte d'après sa description, le spécialiste rédige un brouillon à partir de ses connaissances, puis le superviseur l'améliore (exactitude, ton, clarté) sans rien inventer. Les garde-fous des deux agents s'appliquent. Étape par étape 1. Créez vos agents spécialisés (ex : Livraisons, Facturation) avec des descriptions claires. 2. Sur chaque spécialiste, onglet « Réglages », réglez « Rôle dans l'équipe » sur « Spécialiste ». 3. Créez un agent et réglez son rôle sur « Superviseur ». 4. Connectez le superviseur ET les spécialistes à la même boîte de réception (onglet « Canaux »). 5. Testez : le superviseur orientera et relira automatiquement. Bon à savoir - La description de chaque spécialiste guide l'aiguillage : rédigez-la avec soin. - Avec un seul agent sur le canal, le comportement reste classique (pas d'orchestration). - Le superviseur ne fabrique jamais d'information absente du brouillon.

L'aide à la rédaction par IA : améliorer, reformuler, corriger et résumer une réponse

📍 Où le trouver : Conversations → (ouvrir une conversation) → zone de réponse → bouton IA (étincelle) Pendant qu'un agent répond à un client, l'IA peut l'aider à écrire : améliorer le brouillon, changer le ton, corriger l'orthographe et la grammaire, raccourcir ou développer, et même proposer une réponse complète. Elle peut aussi résumer toute la conversation en quelques lignes. Comment ça marche Dans la zone de réponse, un menu d'IA propose plusieurs actions. « Améliorer la réponse », « Changer le ton » (professionnel, décontracté, direct, confiant, amical) et « Corriger l'orthographe » retravaillent votre brouillon. « Suggérer une réponse » génère une réponse à partir du contexte de la conversation. « Résumer » produit un résumé. Vous relisez le résultat, vous pouvez demander un ajustement, puis vous l'acceptez avant l'envoi — rien n'est envoyé automatiquement. Étape par étape 1. Assurez-vous qu'un administrateur a connecté la clé OpenAI (menu « Intégrations » → « OpenAI »). 2. Ouvrez une conversation et placez le curseur dans la zone de réponse. 3. Cliquez sur le bouton d'IA (icône d'étincelle) au-dessus ou à côté de la zone de réponse. 4. Choisissez une action : « Améliorer la réponse », « Changer le ton », « Corriger l'orthographe », « Suggérer une réponse » ou « Résumer ». 5. Relisez le texte proposé ; au besoin, demandez une modification dans le champ de suivi. 6. Cliquez sur « Accepter » pour insérer le texte dans la zone de réponse, puis envoyez quand vous êtes satisfait. Bon à savoir - L'IA répond dans la langue de votre brouillon ; rédigez quelques mots pour orienter le ton. - « Suggérer une réponse » et « Améliorer » ne sont proposés qu'en mode Réponse (pas en note privée). - Vérifiez toujours le contenu généré avant l'envoi : vous restez responsable du message. - Cette fonction consomme des appels sur votre compte OpenAI.

L'« Assistant Madyis » : votre aide IA flottante dans chaque conversation

📍 Où le trouver : Conversations → (ouvrir une conversation) → bulle « Assistant Madyis » en bas à droite L'Assistant Madyis est une petite bulle d'aide IA présente en bas à droite de chaque conversation. L'agent peut lui poser une question sur la conversation en cours et obtenir de l'aide : proposer une réponse, résumer l'échange ou suggérer la prochaine étape. Comment ça marche La bulle ouvre un mini-chat réservé à l'agent (le client ne le voit pas). Elle envoie le contexte de la conversation ouverte à l'IA, propulsée par votre clé OpenAI, et affiche sa réponse. Des boutons rapides permettent de demander en un clic « Proposer une réponse », « Résumer » ou « Prochaine étape ». L'assistant répond dans la langue de l'agent. Étape par étape 1. Un administrateur doit d'abord connecter la clé OpenAI (menu « Intégrations » → « OpenAI »). 2. Ouvrez une conversation : la bulle « Assistant Madyis » apparaît en bas à droite. 3. Cliquez sur la bulle pour ouvrir le mini-chat. 4. Tapez votre question, ou utilisez un bouton rapide (« Proposer une réponse », « Résumer », « Prochaine étape »). 5. Lisez la réponse de l'assistant et reprenez-la pour rédiger votre message au client. Bon à savoir - Sans clé OpenAI connectée, la bulle reste grisée avec un message d'invitation à connecter l'intégration. - L'assistant n'envoie jamais de message au client tout seul : il vous conseille, vous gardez la main. - Il n'apparaît que dans l'écran d'une conversation, pas sur les autres pages.

Consulter le journal d'action de l'agent

⏳ Bientôt disponible. Cette fonctionnalité arrive prochainement dans Madyis Hub — voici comment elle fonctionnera. 📍 Où le trouver : Agents IA → (votre agent) → Journal Le journal liste l'historique des réponses générées par l'agent : utile pour auditer son comportement et comprendre une réponse. Comment ça marche À chaque réponse, Madyis Hub enregistre une entrée (succès ou échec) avec des informations techniques comme le modèle utilisé et les jetons consommés. Le journal sert à vérifier ce que l'agent a fait et à diagnostiquer un problème. L'onglet « Journal » est une fonctionnalité réservée à la formule Pro. Étape par étape 1. Ouvrez l'agent, onglet « Journal ». 2. Parcourez l'historique des réponses récentes. 3. Repérez les éventuels échecs pour comprendre pourquoi une réponse n'a pas abouti. Bon à savoir - Si l'onglet « Journal » affiche un cadenas, votre formule ne l'inclut pas : passez en Pro. - Le journal ne stocke pas tout le contenu sensible : il conserve la question du client tronquée. - Utilisez-le pour vérifier que l'agent répond bien à partir de la base et non au hasard.

Outils personnalisés : laisser l'IA appeler vos propres API

⏳ Bientôt disponible. Cette fonctionnalité arrive prochainement dans Madyis Hub — voici comment elle fonctionnera. 📍 Où le trouver : Agents IA → Outils personnalisés Les outils personnalisés donnent des super-pouvoirs à vos agents : pendant une conversation, l'IA peut interroger vos propres services (vérifier une commande, créer un ticket, consulter un stock…) en appelant une API que vous définissez. Comment ça marche Vous décrivez un outil (nom, description, méthode HTTP, URL, authentification, paramètres que l'IA remplira, modèle de requête en Liquid). La description explique à l'IA QUAND utiliser l'outil. Quand un client pose une question correspondante, l'IA appelle l'API, récupère la réponse et s'en sert pour répondre. Les outils sont une fonctionnalité Pro, réservée aux administrateurs. Étape par étape 1. Menu de gauche → « Agents IA », puis cliquez sur le bouton « Outils personnalisés » en haut. 2. Cliquez sur « Nouvel outil ». 3. Renseignez le nom, l'identifiant, et une description claire (l'IA la lit pour savoir quand l'utiliser). 4. Choisissez la méthode HTTP, l'URL de l'endpoint et l'authentification. 5. Ajoutez les paramètres que l'IA devra remplir, testez avec « Test », activez l'outil et « Enregistrer ». Bon à savoir - Soignez la description : c'est elle qui dit à l'IA dans quels cas appeler l'outil. - Cette fonctionnalité nécessite une formule Pro et un compte administrateur. - Testez l'outil avant de l'activer pour vérifier l'identifiant et l'URL.

Comprendre le quota de réponses IA

📍 Où le trouver : Agents IA Votre formule inclut un nombre de réponses IA par mois. Au-delà, les agents cessent temporairement de répondre automatiquement aux clients. Comment ça marche Chaque réponse envoyée à un client compte dans le quota mensuel de votre compte. Quand le quota est atteint, l'agent n'envoie plus de réponse et l'événement est enregistré ; vous êtes prévenu à l'approche de la limite. Les tests dans le Playground ne consomment pas ce quota. Étape par étape 1. Suivez votre consommation et votre formule dans Réglages → Facturation. 2. Si le quota est atteint, surclassez votre formule pour rétablir les réponses automatiques. 3. En attendant, vos équipes peuvent continuer à répondre manuellement aux clients. Bon à savoir - Les essais dans le Playground sont gratuits côté quota. - Réservez l'IA aux canaux les plus chargés si votre quota est serré. - Le mode supervisé compte aussi : un brouillon généré consomme du quota.

Brancher votre propre agent IA externe (Hermes, OpenAI, n8n, Claude)

📍 Où le trouver : Agents IA → (votre agent) → Réglages → Moteur IA Au lieu de l'IA intégrée de Madyis Hub, vous pouvez relayer les conversations vers votre propre agent externe : un endpoint compatible OpenAI, un webhook simple (n8n), ou l'API Claude. Comment ça marche Dans les réglages, le « Moteur IA » peut passer de « IA Madyis intégrée » à « Mon propre agent externe ». Vous choisissez alors le format de connexion (compatible OpenAI, Anthropic Claude, ou webhook simple), renseignez l'URL de l'endpoint, une éventuelle clé/token, le modèle et le champ où lire la réponse. Madyis Hub envoie la conversation à votre agent et publie sa réponse. Avec un agent externe, les connaissances, le Playground et la personnalité sont gérés par VOTRE agent. Étape par étape 1. Ouvrez l'agent, onglet « Réglages », et réglez « Moteur IA » sur « Mon propre agent externe ». 2. Choisissez le « Format de connexion » (compatible OpenAI, Anthropic Claude, ou webhook simple). 3. Renseignez l'« URL de l'endpoint », et si besoin la « Clé API / token » et le « Modèle ». 4. Pour un webhook simple, indiquez au besoin le champ de réponse (ex : output). 5. Cliquez sur « Tester la connexion », puis « Enregistrer ». Bon à savoir - La clé enregistrée n'est jamais réaffichée : laissez le champ vide pour la conserver. - Pour n8n, votre flux doit renvoyer la réponse dans la réponse HTTP (nœud « Respond to Webhook »). - Les onglets Connaissances et Playground de Madyis Hub ne servent pas en mode externe.