> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils pour les feature flags

> Outils MCP pour les feature flags, leurs règles, leurs variations et leurs variables.

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`.

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