Code du widget de chat avec instructions privées : rédiger un system prompt efficace
Le code d’intégration est le même pour tous les widgets de chat. Ce qui rend le vôtre utile, ce sont ses instructions privées. Voici comment les rédiger pour des réponses justes et fidèles à votre marque.
Publié:
Deux widgets de chat peuvent partager la même ligne de code d’intégration et se comporter de façon totalement différente. La différence tient aux instructions privées, souvent appelées system prompt. Elles sont stockées sur le serveur avec votre widget, envoyées avec chaque conversation et jamais montrées aux visiteurs.
Où se trouvent les instructions
Ouvrez un widget de chat dans Widgets et faites défiler jusqu’à Comportement. Le champ des instructions accepte jusqu’à 4 000 caractères. Comme elles restent sur le serveur, un visiteur qui inspecte votre page ne voit que l’identifiant du widget dans la balise script :
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Toute modification des instructions s’applique dès le message suivant. Vous n’avez jamais besoin de mettre à jour le code de votre site.
Une structure qui fonctionne
De bonnes instructions répondent à quatre questions pour le modèle.
- Qui es-tu ? « Tu es l’assistant de Northwind, une boutique en ligne d’équipement outdoor. »
- Que sais-tu ? Collez les informations qui comptent : délais de livraison, conditions de retour, horaires d’ouverture, gammes de produits. Le modèle ne peut être plus précis que les informations que vous lui donnez.
- Que dois-tu éviter ? « Ne promets pas de réductions. Ne donne pas de conseils médicaux ou juridiques. En cas de doute, dis-le et renvoie vers la page de contact. »
- Quel ton adopter ? « Réponds en deux ou trois phrases courtes. Utilise la langue du visiteur. »
Gardez chaque règle courte et concrète. De longs paragraphes vagues sont plus difficiles à suivre pour un modèle qu’une liste courte.
Testez-le comme un visiteur
L’aperçu de l’éditeur envoie de vraies requêtes avec vos instructions non enregistrées, ce qui permet d’itérer rapidement :
- Posez les cinq questions les plus fréquentes de votre boîte de support.
- Posez une question que vos instructions ne couvrent pas et vérifiez que le widget reconnaît qu’il ne sait pas.
- Essayez de lui faire enfreindre une règle, par exemple en demandant un code de réduction.
Ajustez les instructions après chaque série de tests. De petites modifications de formulation règlent souvent la plupart des problèmes.
Restez cohérent avec votre marque
Le widget de chat est en marque blanche : pas de logo, pas de mention « powered by ». Rédigez avec vos propres mots le titre, le message d’accueil, le texte du champ, le libellé du bouton et le message d’erreur, puis accordez la couleur d’accent, l’arrondi des coins et le thème à votre site. Les textes laissés vides utilisent des valeurs par défaut dans la langue de votre compte.
Associez les instructions à des limites
Les instructions façonnent les réponses, mais elles ne constituent pas un budget. Fixez un plafond de longueur de réponse (tokens maximum) pour garder des réponses courtes, et choisissez la clé API avec laquelle fonctionne le widget. La limite de dépense quotidienne et les modèles autorisés de cette clé s’appliquent à chaque requête des visiteurs, ce qui vous offre un second filet de sécurité indépendant.
Commencez par un brouillon sur la page des widgets, puis peaufinez-le dans votre tableau de bord.