Outils pour les feature flags

Les outils de feature flag contrôlent la manière dont un feature flag livre une fonctionnalité dans chaque environnement. Votre assistant peut activer ou désactiver un feature flag, ajouter des règles qui déploient ou testent la fonctionnalité, et définir les variations et les variables typées que le feature flag sert.

Outils

Feature flags

Outil	Description	Exemple de prompt
`feature_flag_list`	Trouve des feature flags par clé, nom ou ID.	”List all feature flags for site `d1alzzxd7k`.”
`feature_flag_get`	Récupère la configuration complète d’un feature flag dans un environnement : variations, variables, objectif principal et chaîne de règles.	”Show configuration for flag `snake_game`.”
`feature_flag_create`	Crée un feature flag avec les variations `on` et `off` par défaut.	”Create a flag `ui_refresh` for site `d1alzzxd7k`.”
`feature_flag_duplicate`	Clone un feature flag existant (la copie démarre désactivée dans chaque environnement).	”Duplicate the `new_search` flag.”
`feature_flag_delete`	Supprime définitivement un feature flag et toute sa configuration.	”Delete the flag `ui_refresh`.”
`feature_flag_enable`	Met l’interrupteur principal de l’environnement sur ON pour que le SDK évalue les règles.	”Turn on `new_search` in production.”
`feature_flag_disable`	Met l’interrupteur principal de l’environnement sur OFF (la chaîne de règles reste intacte).	”Turn off `new_search` in staging.”
`feature_flag_activity_logs_get`	Lit le journal d’audit des modifications de feature flags (qui a changé quoi, et quand).	”Show the recent change history for these feature flags.”
`feature_flag_experiment_results_get`	Récupère les résultats statistiques de chaque objectif attaché à la règle d’expérimentation d’un feature flag. Accepte les mêmes paramètres `breakdown`, `filters`, de date, `statisticalMethod`, `conversionType` et `referenceVariationId` que `experiment_results_get`.	”Get the experiment results for the rule on `new_search`.”

Règles, variations et variables

Définissez la manière dont un feature flag livre sa valeur aux utilisateurs : ajoutez des règles de diffusion et d’expérimentation, et définissez les variations et les variables typées qu’il sert.

Outil	Description	Exemple de prompt
`feature_flag_rule_targeted_create`	Ajoute une règle de diffusion ciblée : sert une variation à un pourcentage du trafic, avec un démarrage planifié.	”Roll `new_search` out to 20% in production.”
`feature_flag_rule_progressive_create`	Ajoute une règle de diffusion progressive qui augmente l’exposition d’une variation par paliers fixes, pour un déploiement graduel sans comparaison statistique.	”Roll `new_search` out in production from 5% to 100%, adding 10% every day.”
`feature_flag_rule_experimentation_create`	Ajoute une règle d’expérimentation A/B qui répartit le trafic entre les variations, avec un suivi statistique.	”A/B test `off` vs `on` 50/50 on `new_search`.”
`feature_flag_variation_create`	Ajoute une variation personnalisée (un état nommé de la fonctionnalité) à un feature flag.	”Add a `variant_a` variation to `new_search`.”
`feature_flag_variable_create`	Définit une variable typée (BOOLEAN, NUMBER, STRING, JSON, JS, CSS, ENUM) avec une valeur par défaut.	”Add a STRING variable `label` defaulting to `Search`.”
`feature_flag_variation_variable_set`	Remplace la valeur d’une variable pour une variation précise.	”Set `label` to `Find` on `variant_a`.”

Paramètres

Utilisez les noms exacts des paramètres renvoyés par tools/list.

Feature flags

Outil	Paramètres obligatoires	Paramètres facultatifs
`feature_flag_list`	Aucun	`siteCode`, `filterQuery`, `page`, `perPage`, `sortField`, `sortOrder`
`feature_flag_get`	`featureKey`, `siteCode`	`environmentKey` (`*` pour tous les environnements)
`feature_flag_create`	`siteCode`, `featureKey`, `name`	`description`
`feature_flag_duplicate`	`featureKey`, `siteCode`	Aucun
`feature_flag_delete`	`featureKey`, `siteCode`	`confirm` (obligatoire pour appliquer la modification)
`feature_flag_enable`	`featureKey`, `siteCode`, `environmentKey`	`confirm` (obligatoire pour appliquer la modification)
`feature_flag_disable`	`featureKey`, `siteCode`, `environmentKey`	`confirm` (obligatoire pour appliquer la modification)
`feature_flag_activity_logs_get`	Aucun	`type`, `sortKey` (`timestamp`), `sortOrder`, `page`, `perPage`
`feature_flag_experiment_results_get`	`featureKey`, `siteCode`, `environmentKey`, `experimentId`	`goalIds`, `audienceBasis` (`VISITORS` par défaut, ou `VISITS`), `includeRawReport`, `breakdown`, `filters`, `dateFrom`, `dateTo`, `statisticalMethod`, `conversionType`, `referenceVariationId` (un ID ou une clé de variation, `0` ou `off` pour la variation off) ; valeurs identiques à celles de `experiment_results_get`

Règles, variations et variables

Outil	Paramètres obligatoires	Paramètres facultatifs
`feature_flag_rule_targeted_create`	`siteCode`, `featureKey`, `environmentKey`, `variationKey`, `exposition`, `releaseDateTime`, `timeZone`	`ruleName`, `confirm` (obligatoire lorsque le feature flag est déjà activé dans l’environnement)
`feature_flag_rule_progressive_create`	`siteCode`, `featureKey`, `environmentKey`, `variationKey`, `startExposition`, `stopExposition`, `increaseBy`, `frequencyValue`, `frequencyUnit` (`MINUTES`, `HOURS` ou `DAYS`), `releaseDateTime`, `timeZone`	`ruleName`, `confirm` (obligatoire lorsque le feature flag est déjà activé dans l’environnement)
`feature_flag_rule_experimentation_create`	`siteCode`, `featureKey`, `environmentKey`, `controlVariationKey`, `trafficAllocations`, `exposition`, `releaseDateTime`, `timeZone`	`ruleName`, `confirm` (obligatoire lorsque le feature flag est déjà activé dans l’environnement)
`feature_flag_variation_create`	`siteCode`, `featureKey`, `variationKey`, `variationName`	Aucun
`feature_flag_variable_create`	`siteCode`, `featureKey`, `variableKey`, `variableType`, `defaultValue`	Aucun
`feature_flag_variation_variable_set`	`siteCode`, `featureKey`, `variationKey`, `variableKey`, `value`	Aucun

Valeurs acceptées : variableType vaut BOOLEAN, NUMBER, STRING, JSON, JS, CSS ou ENUM. trafficAllocations est une liste de variationKey:percentage séparés par des virgules, dont la somme vaut 100 (par exemple off:50,on:50). releaseDateTime est une date et heure locales au format ISO 8601, sans décalage (par exemple 2026-07-01T09:00:00), et timeZone est un fuseau IANA (par exemple Europe/Paris ou UTC). frequencyUnit vaut MINUTES, HOURS ou DAYS.

Pour les requêtes propres à un environnement, transmettez environmentKey = "production" ou environmentKey = "staging" lorsque cela est pris en charge.

Accueil

Configuration

Référence des outils

Tutoriels

Dépannage

Outils

Feature flags

Règles, variations et variables

Paramètres

Feature flags

Règles, variations et variables

Accueil

Configuration

Référence des outils

Tutoriels

Dépannage

​Outils

​Feature flags

​Règles, variations et variables

​Paramètres

​Feature flags

​Règles, variations et variables

Outils

Feature flags

Règles, variations et variables

Paramètres

Feature flags

Règles, variations et variables