Fonctionnement
Un feature flag stocke chaque prompt comme la valeur d’une variable de feature, avec une variation par prompt que vous voulez tester. Lorsqu’un visiteur accède à votre application, le SDK Kameleoon affecte le visiteur à une variation et retourne le prompt correspondant, que votre code applicatif envoie au LLM. Un objectif rattaché au feature flag enregistre une conversion lorsque le visiteur interagit avec votre fonctionnalité basée sur un LLM, par exemple en posant une question de suivi ou en menant à bien une tâche grâce à l’aide de l’assistant. Une fois que vous avez collecté suffisamment de trafic, comparez le taux de conversion de chaque variation pour déterminer quel prompt est le plus performant.Prérequis
- Un compte Kameleoon avec un projet configuré pour Feature Experimentation.
- L’ID client et la clé secrète client de votre compte. Pour trouver ces valeurs, consultez Identifiants API.
- Une application Python dans laquelle vous pouvez installer le SDK Kameleoon.
Configurer votre expérience de prompt dans Kameleoon
Configurez le feature flag, les variations de prompt et l’objectif de suivi dans la plateforme Kameleoon avant de toucher à votre code applicatif.Créer le feature flag
Créez un feature flag pour contenir vos variations de prompt et contrôler le déploiement de votre expérience.- Dans l’application Kameleoon, cliquez sur Features > Flags & Experiments > New feature flag.
- Saisissez un nom, par exemple
LLM prompt test, et sélectionnez le projet pour le flag. - Dans le champ Description, notez ce que le flag contrôle, afin que les autres membres de votre équipe comprennent son objectif.
- Cliquez sur Validate.
Stocker le prompt dans une variable de feature
Ajoutez une variable de feature pour contenir le texte du prompt, afin de pouvoir le modifier depuis la plateforme Kameleoon sans éditer votre code applicatif.- Sur la page du flag, dans la barre latérale gauche, cliquez sur Set Up > Variables > Add Variable.
- Définissez le Type de la variable sur String.
- Saisissez une Variable Key, par exemple
prompt_template. - Définissez la Default Value sur le prompt actuellement utilisé par votre application. Kameleoon délivre cette valeur aux visiteurs qui ne font pas partie de votre expérience.
- Cliquez sur Save.

Créer une variation par prompt
Créez une variation par prompt que vous voulez tester, et définissez la variableprompt_template avec le texte correspondant dans chacune.
- Dans la barre latérale gauche, cliquez sur Set Up > Variations > Add variation.
- Saisissez un Name pour la variation, par exemple
Detailed summary. - Définissez la variable
prompt_templateavec le texte du prompt pour cette variation. - Cliquez sur Save.
- Répétez ces étapes pour chaque prompt supplémentaire que vous voulez tester.

Attacher un objectif pour mesurer l’engagement
Attachez un objectif au feature flag afin que Kameleoon puisse mesurer quelle variation de prompt génère le plus d’engagement. Kameleoon étant une plateforme unifiée, vous pouvez attacher n’importe quel objectif déjà existant dans votre organisation, comme un objectif de transaction défini par une autre équipe, ou créer un objectif spécifique à votre fonctionnalité basée sur un LLM.- Sur la page du flag, dans le menu Set Up, cliquez sur Goals > Add goal.
- Sélectionnez un objectif existant, ou cliquez sur Create a new goal pour en définir un, comme un objectif personnalisé déclenché lorsqu’un visiteur interagit avec votre fonctionnalité basée sur un LLM.
- Cliquez sur Save.

Déployer l’expérience
Créez une règle d’expérience qui répartit le trafic entre vos variations de prompt, puis activez l’environnement pour commencer à collecter des données.- Dans le Rollout Planner, sélectionnez l’environnement que vous voulez cibler, par exemple Production.
- Cliquez sur Add a rule > Experiment.
- Sous Variations to serve, ajoutez chaque variation de prompt et définissez son pourcentage d’exposition. Par exemple, répartissez le trafic également entre deux variations à 50 % chacune.
- Définissez le ciblage de la règle pour inclure les visiteurs que vous voulez tester, par exemple tous les visiteurs qui accèdent à l’application.
- Activez le toggle ON/OFF de l’environnement sur ON.
- Cliquez sur Save.

Récupérer le prompt dans votre application
Installez le SDK Python de Kameleoon, puis récupérez le prompt affecté au visiteur et suivez une conversion lorsque le visiteur interagit avec votre fonctionnalité basée sur un LLM. Le même principe s’applique à n’importe quel SDK Kameleoon côté serveur, y compris Node.js, Java et Go.-
Installez le SDK comme dépendance :
-
Initialisez le client avec votre site code et vos identifiants :
-
Récupérez le prompt affecté avant d’appeler votre LLM, et suivez une conversion lorsque le visiteur interagit avec la fonctionnalité basée sur un LLM :
Appelez
get_prompt_for_visitor()avec levisitor_codedu visiteur avant d’envoyer une requête à votre LLM, et utilisez la valeur retournée comme prompt. Appeleztrack_llm_interaction()lorsque le visiteur interagit avec la fonctionnalité basée sur un LLM, par exemple en soumettant une question ou en recevant une réponse.
Utilisez
get_visitor_code() pour attribuer un ID unique à chaque visiteur, et set_legal_consent() si votre application nécessite le consentement du visiteur avant tout suivi de données. Pour la référence complète d’initialisation et de configuration du client, consultez le guide du développeur du SDK Python.Suivre et itérer
Ouvrez la page de résultats du feature flag pour comparer le taux de conversion de chaque variation de prompt par rapport à l’objectif attaché. Kameleoon suit les expositions et les conversions automatiquement dès que votre application appelleget_variation() et track_conversion(), vous n’avez donc besoin d’aucune instrumentation supplémentaire.
Pour en savoir plus, consultez Consulter les résultats globaux de votre feature flag.
Étapes suivantes
- Consultez la référence du SDK Python pour des options avancées telles que les custom data, l’expérimentation cross-device et les conditions de ciblage.
- Attachez des critères de segmentation précis pour cibler l’expérience sur une audience spécifique.
- Explorez les variables de feature pour variabiliser d’autres parties de votre fonctionnalité basée sur un LLM, comme les paramètres du modèle ou les paramètres de récupération.