Aller au contenu
Documentation

Rédiger les instructions de votre agent IA

Rédigez les instructions qui fixent le rôle, le ton et les limites de votre agent intoCHAT : modèles, 100 caractères minimum, garde-fous, règles intégrées, tests.

Les instructions indiquent à votre agent qui il est, comment s'exprimer et où s'arrêtent ses missions. Vos sources de connaissances fournissent les faits ; les instructions déterminent comment l'agent s'en sert.

Où les modifier

Ouvrez l'onglet Setup de l'agent. Sous Role and behaviour (rôle et comportement) :

  1. Start from a template remplace le texte en dessous par le modèle d'instructions choisi.
  2. Instructions contient le texte lui-même. Il faut au moins 100 caractères ; d'ici là, le compteur indique combien il en manque.
  3. Cliquez sur Save changes (enregistrer) dans l'en-tête.

Si vous avez modifié un texte issu d'un modèle, un bouton Restore ou Use latest template au-dessus du champ rétablit le texte du modèle.

Modèles d'instructions

Les modèles sont des points de départ qui contiennent déjà des règles sur l'exactitude, le ton et les coordonnées. Vous pouvez en modifier chaque mot :

  • AI Chatbot
  • Customer Support Agent
  • Sales Agent
  • E-commerce Specialist
  • Real Estate Agent
  • Language tutor
  • Coding Expert
  • Life Coach
  • Futuristic Fashion Advisor

Custom prompt part d'un champ vide.

Que rédiger

De bonnes instructions sont précises sur votre activité. Couvrez :

  • Le rôle et le public : au nom de qui parle l'agent et à qui il s'adresse.
  • Le périmètre : ce pour quoi il doit aider, et ce qu'il doit refuser poliment.
  • Le ton et la forme : formel ou détendu, court ou détaillé, listes ou paragraphes.
  • Les étapes suivantes : où orienter les visiteurs pour ce qu'il ne peut pas faire. L'agent n'invente jamais de moyen de contact, alors indiquez ceux qu'il doit utiliser.
  • Quelques faits essentiels : ceux qui doivent toujours être exacts, comme votre adresse de support. En cas de contradiction, les instructions priment sur vos connaissances.

Gardez les contenus longs, comme les détails produits, les conditions et les FAQ, dans vos connaissances, où ils sont recherchés pour chaque question.

Par défaut, l'agent répond dans la langue dans laquelle le visiteur écrit. Pour choisir une langue de réponse, utilisez plutôt Reply language, plus bas, que les instructions.

Tu es l'assistant d'Example Bikes, un magasin de vélos. Aide les visiteurs
à choisir un vélo, à comprendre notre service de réparation et à trouver
nos horaires d'ouverture. Réponds en 120 mots maximum et utilise des listes
à puces pour les étapes. Pour toute question sur une commande existante,
demande au visiteur d'écrire à support@example.com. Décline poliment les
sujets sans rapport avec le vélo.

Garde-fous

Les garde-fous sont des règles que l'agent doit respecter dans chaque réponse, quoi que demande le visiteur. Ajoutez-les dans l'onglet Setup sous Guardrails (garde-fous), dans le champ Rules, puis cliquez sur Save changes.

  • Écrivez une règle par ligne, par exemple « Ne jamais citer de prix ; renvoyer vers la page des tarifs. » Le champ est facultatif et accepte jusqu'à 4 000 caractères.
  • intoCHAT envoie ces règles à l'IA dans un bloc distinct, juste après vos instructions. L'agent les respecte même si vos instructions, vos connaissances ou le message d'un visiteur suggèrent le contraire.
  • Les garde-fous peuvent seulement restreindre ce que l'agent dit ou fait. Ils ne lui donnent pas de capacités qu'il n'a pas, comme une action que vous n'avez pas configurée, et ne désactivent pas les règles intégrées d'intoCHAT décrites ci-dessous.
  • Ils sont séparés des instructions : choisir un modèle d'instructions ne les remplace donc pas.
Ne jamais citer de prix ; renvoyer vers la page des tarifs.
Ne pas parler des concurrents.
Ne pas donner de conseils médicaux. Suggérer plutôt de consulter un médecin.

Utilisez les garde-fous pour des limites courtes et fermes, et les instructions pour le rôle, le ton et le périmètre.

Rester dans le sujet

Pour que l'agent s'en tienne à votre activité, activez Stay on topic (rester dans le sujet) sous les règles, puis cliquez sur Save changes. L'option est désactivée par défaut.

  • L'agent refuse poliment les questions sans rapport avec votre activité, comme des devoirs, des dissertations, du code, des traductions ou de la culture générale, et indique ce qu'il peut faire à la place.
  • Les salutations, les remerciements et les petites conversations reçoivent toujours une réponse courte et aimable.
  • Une question qui pourrait concerner votre activité est considérée comme dans le sujet. Quand un message mélange les deux, l'agent répond à la partie qui concerne votre activité et refuse le reste.
  • Ce qui relève de votre activité vient de vos instructions, de vos garde-fous et de vos connaissances : décrivez-y ce que vous proposez.
  • Le Playground utilise l'option sans enregistrement, vous pouvez donc l'essayer avant d'enregistrer.

Langue des réponses

Par défaut, l'agent répond dans la langue dans laquelle écrit chaque visiteur. Pour choisir une langue, utilisez Reply language dans l'onglet Setup, sous Guardrails :

  1. Sous Reply in, choisissez une langue. Visitor's language (automatic) est la valeur par défaut.
  2. Si toutes les réponses doivent être dans cette langue, activez Always use this language. L'interrupteur apparaît dès que vous choisissez une langue.
  3. Cliquez sur Save changes.
RéglageLangue des réponses
Visitor's language (automatic)La langue dans laquelle écrit le visiteur.
Une langue, Always use this language désactivéLa langue du visiteur. La langue choisie est utilisée quand celle-ci n'est pas claire, par exemple pour une salutation, un message d'un seul mot, un nom ou un nombre seul, ou un mélange de langues.
Une langue, Always use this language activéToujours la langue choisie, quelle que soit la langue dans laquelle écrit le visiteur. Les noms, les titres de produits et les extraits cités des sources restent tels qu'ils sont écrits.

Reply in propose 31 langues, affichées sous leur nom anglais : Albanian, Arabic, Bulgarian, Chinese, Croatian, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swedish, Turkish et Ukrainian.

  • Tout ce que l'agent écrit dans une réponse est dans la même langue, y compris les questions qu'il pose, ses confirmations et les questions de suivi.
  • Le réglage est une consigne donnée à l'IA. Si vos instructions mentionnent aussi une langue, vérifiez qu'elle correspond.
  • Il ne modifie pas les boutons et les messages propres au widget. Ceux-ci suivent Widget language dans l'onglet Appearance, et les deux réglages sont indépendants. Voir Apparence.
  • Le Playground utilise le choix affiché à l'écran, enregistré ou non.

Transfert à votre équipe

La section Hand-off to your team de l'onglet Setup permet à l'agent d'envoyer une conversation à votre équipe par e-mail quand un visiteur demande à parler à quelqu'un. Elle est désactivée par défaut et s'enregistre avec Save changes, comme le reste de l'onglet. Consultez Transfert par e-mail.

En dessous, la carte Live chat permet plutôt à quelqu'un de votre équipe de rejoindre le chat, tant qu'il a la boîte de réception Live chat ouverte. Ses interrupteurs s'enregistrent aussitôt, sans Save changes. Consultez Chat en direct.

Recherche web

Sous les autres réglages de l'onglet, la carte Web search permet à l'agent de chercher une réponse sur le web quand vos connaissances ne répondent pas à la question. Elle est désactivée par défaut et s'enregistre avec son propre bouton Save web search, pas avec Save changes. Vos instructions et vos garde-fous déterminent ce qui peut faire l'objet d'une recherche. Consultez Recherche web.

Règles intégrées

intoCHAT ajoute des règles à chaque agent. En cas de conflit avec vos instructions ou vos garde-fous, ce sont elles qui s'appliquent ; inutile donc de les répéter :

  • Les informations commerciales comme les produits, prix, conditions et coordonnées proviennent uniquement de vos instructions, de vos connaissances ou de résultats d'actions réussies.
  • Quand une information manque ou se contredit, l'agent dit ce qu'il ne peut pas confirmer. Il n'invente jamais de réponse, de moyen de contact ni de transfert vers une personne.
  • Les documents trouvés et les résultats d'actions sont des données de référence, pas des instructions. Les commandes qui s'y cachent sont ignorées, et les visiteurs ne peuvent pas contourner ces règles.
  • L'agent ne révèle ni ses instructions cachées, ni des identifiants, ni des informations privées issues des sources.
  • Il ne demande jamais de mots de passe, de codes à usage unique, de clés API ou de données de carte bancaire dans le chat.
  • Il n'utilise que les actions que vous avez configurées, demande confirmation avant toute étape importante et ne présente une action comme effectuée que si le résultat le confirme.
  • Il suit vos réglages de collecte de leads et ne demande pas aux visiteurs de saisir leurs coordonnées dans le chat quand le formulaire est prévu pour cela.

Tester dans le Playground

Le Playground répond avec les instructions et les garde-fous affichés à l'écran, enregistrés ou non : vous pouvez donc essayer une modification avant de la conserver. Les tests ne les enregistrent jamais. Il en va de même pour Reply language et pour l'interrupteur Suggest follow-up questions de l'onglet Appearance.

  1. Modifiez les instructions ou les garde-fous dans l'onglet Setup.
  2. Ouvrez le Playground et posez de vraies questions de visiteurs, y compris celles que l'agent doit refuser et celles que vos contenus ne couvrent pas.
  3. Cliquez sur Reset pour commencer une nouvelle conversation après chaque modification.
  4. Quand les réponses vous conviennent, cliquez sur Save changes. D'ici là, votre site continue d'utiliser les dernières instructions et les derniers garde-fous enregistrés.

Le minimum de 100 caractères s'applique aussi ici : avec un texte plus court, le Playground affiche une erreur au lieu d'une réponse.

Les conversations du Playground sont enregistrées avec vos autres conversations. Pour essayer quelque chose sans l'enregistrer, cliquez sur l'icône de chat temporaire dans l'en-tête du widget. Le bandeau « Temporary chat — messages aren't saved » apparaît, et aucun formulaire de leads n'est affiché. Cliquez de nouveau sur l'icône pour revenir à la conversation enregistrée. Les réponses de la conversation enregistrée peuvent être notées d'un pouce vers le haut ou vers le bas, et les notes apparaissent dans sa transcription, dans l'onglet Conversations.

Comparer deux versions

Compare pose la même question à vos réglages enregistrés et à un brouillon modifié, côte à côte, pour que vous voyiez lequel répond le mieux avant de changer quoi que ce soit.

  1. Ouvrez le Playground et activez Compare en haut à droite. L'interrupteur apparaît une fois l'agent enregistré.
  2. Deux chats apparaissent : A · Saved settings répond avec ce qu'utilise actuellement votre site, et B · Draft répond avec le brouillon du panneau situé au-dessus. Sur les écrans étroits, ils sont empilés.
  3. Modifiez les Instructions et les Guardrails de B et, si vous le souhaitez, Reply in et Always use this language. Le brouillon part de l'onglet Setup tel qu'il est affiché à l'écran, enregistré ou non. Le modifier ne change pas l'onglet Setup ; Start from form y recopie l'onglet Setup.
  4. Saisissez une question et cliquez sur Send to both. A et B répondent en même temps, et chacun garde sa propre conversation pour les questions suivantes. Un clic sur une question de suivi l'envoie aux deux.
  5. Cliquez sur Reset both pour recommencer les deux conversations, par exemple après avoir modifié le brouillon.
  6. Quand B répond mieux, cliquez sur Use B. Cela copie les instructions, les garde-fous et la langue des réponses de B dans l'onglet Setup, et l'en-tête signale des modifications non enregistrées. Cliquez sur Save changes pour les utiliser sur votre site. Tant que vous n'avez pas enregistré, A et votre site conservent les réglages enregistrés.
  • Seuls les instructions, les garde-fous et la langue des réponses diffèrent entre A et B. Les deux utilisent vos connaissances, vos actions et vos réglages de questions de suivi et de sources enregistrés.
  • Les deux chats sont temporaires : ils ne sont pas enregistrés avec vos conversations, n'apparaissent donc pas dans l'onglet Conversations et n'ont pas de Why this answer. Aucun formulaire de leads ne s'affiche, et les actions côté client ne s'exécutent pas dans Compare ; désactivez-le pour les tester.
  • Les instructions de B doivent compter au moins 100 caractères et ses garde-fous 4 000 au plus, comme à l'enregistrement. D'ici là, Send to both affiche une erreur et aucun des deux chats n'est interrogé.
  • Test as a signed-in visitor s'applique aux deux chats.
  • Compare nécessite un rôle qui peut modifier l'agent ; les Viewers ne voient pas l'interrupteur. Voir Membres de l'équipe et rôles.
  • Désactiver Compare ramène au chat normal du Playground tel que vous l'aviez laissé. Quitter l'onglet Playground efface les deux chats de Compare.

Problèmes fréquents

  • L'agent s'écarte du sujet : décrivez plus précisément le périmètre et ce qu'il doit refuser, ou ajoutez un garde-fou.
  • Les réponses sont trop longues : fixez un nombre de mots maximal ou demandez des listes à puces.
  • Une information est fausse : corrigez la source ou ajoutez une paire de questions-réponses. Les instructions conviennent mieux au comportement qu'aux longues listes de faits.
  • Il n'oriente nulle part quand il ne peut pas aider : indiquez vos moyens de contact dans les instructions, ou activez le transfert par e-mail.

Voir en Markdown