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

# フィーチャーフラグツール

> フラグ、そのルール、バリエーション、変数を扱うMCPツールです。

フィーチャーフラグツールは、フラグが各環境で機能をどのように提供するかを制御します。アシスタントは、フラグのオン・オフの切り替え、ロールアウトやテストを行うルールの追加、フラグが提供するバリエーションと型付き変数の定義を行えます。

## ツール

### フィーチャーフラグ

| ツール | 説明 | プロンプトの例 |
| - | - | - |
| `feature_flag_list` | キー、名前、またはIDでフィーチャーフラグを検索します。 | "List all feature flags for site `d1alzzxd7k`." |
| `feature_flag_get` | 環境内のフラグの完全な設定を取得します。バリエーション、変数、プライマリゴール、ルールのチェーンが含まれます。 | "Show configuration for flag `snake_game`." |
| `feature_flag_create` | デフォルトの `on` と `off` のバリエーションを持つフラグを作成します。 | "Create a flag `ui_refresh` for site `d1alzzxd7k`." |
| `feature_flag_duplicate` | 既存のフラグをクローンします（コピーは、すべての環境でオフの状態から始まります）。 | "Duplicate the `new_search` flag." |
| `feature_flag_delete` | フラグと、そのすべての設定を完全に削除します。 | "Delete the flag `ui_refresh`." |
| `feature_flag_enable` | 環境ごとのマスタースイッチをオンにして、SDKがルールを評価するようにします。 | "Turn on `new_search` in production." |
| `feature_flag_disable` | 環境ごとのマスタースイッチをオフにします（ルールのチェーンは保持されます）。 | "Turn off `new_search` in staging." |
| `feature_flag_activity_logs_get` | フラグの変更の監査証跡を読み取ります（誰が、何を、いつ変更したか）。 | "Show the recent change history for these feature flags." |
| `feature_flag_experiment_results_get` | フラグの実験ルールにアタッチされたすべてのゴールの統計結果を取得します。`experiment_results_get` と同じ `breakdown`、`filters`、日付、`statisticalMethod`、`conversionType`、`referenceVariationId` の設定を受け付けます。 | "Get the experiment results for the rule on `new_search`." |

### ルール、バリエーション、変数

フラグがユーザーに価値を届ける方法を形作ります。配信ルールと実験ルールを追加し、フラグが提供するバリエーションと型付き変数を定義します。

| ツール | 説明 | プロンプトの例 |
| - | - | - |
| `feature_flag_rule_targeted_create` | ターゲット配信ルールを追加します。1 つのバリエーションを、スケジュールされた開始日時で、トラフィックの一定の割合に提供します。 | "Roll `new_search` out to 20% in production." |
| `feature_flag_rule_progressive_create` | プログレッシブ配信ルールを追加します。バリエーションの露出を一定のステップで段階的に上げます。統計的な比較を行わずに段階的なロールアウトを行う場合に使用します。 | "Roll `new_search` out in production from 5% to 100%, adding 10% every day." |
| `feature_flag_rule_experimentation_create` | A/B実験ルールを追加します。統計的なトラッキングを行いながら、トラフィックを複数のバリエーションに分割します。 | "A/B test `off` vs `on` 50/50 on `new_search`." |
| `feature_flag_variation_create` | フラグにカスタムバリエーション（機能の名前付きの状態）を追加します。 | "Add a `variant_a` variation to `new_search`." |
| `feature_flag_variable_create` | デフォルト値を持つ型付き変数（BOOLEAN、NUMBER、STRING、JSON、JS、CSS、ENUM）を定義します。 | "Add a STRING variable `label` defaulting to `Search`." |
| `feature_flag_variation_variable_set` | 特定のバリエーションについて、変数の値を上書きします。 | "Set `label` to `Find` on `variant_a`." |

## パラメータ

`tools/list` が返す正確なパラメータ名を使用してください。

### フィーチャーフラグ

| ツール | 必須パラメータ | オプションのパラメータ |
| - | - | - |
| `feature_flag_list` | なし | `siteCode`、`filterQuery`、`page`、`perPage`、`sortField`、`sortOrder` |
| `feature_flag_get` | `featureKey`、`siteCode` | `environmentKey`（すべての環境の場合は `*`） |
| `feature_flag_create` | `siteCode`、`featureKey`、`name` | `description` |
| `feature_flag_duplicate` | `featureKey`、`siteCode` | なし |
| `feature_flag_delete` | `featureKey`、`siteCode` | `confirm`（変更を適用するには必須） |
| `feature_flag_enable` | `featureKey`、`siteCode`、`environmentKey` | `confirm`（変更を適用するには必須） |
| `feature_flag_disable` | `featureKey`、`siteCode`、`environmentKey` | `confirm`（変更を適用するには必須） |
| `feature_flag_activity_logs_get` | なし | `type`、`sortKey`（`timestamp`）、`sortOrder`、`page`、`perPage` |
| `feature_flag_experiment_results_get` | `featureKey`、`siteCode`、`environmentKey`、`experimentId` | `goalIds`、`audienceBasis`（デフォルトは `VISITORS`、または `VISITS`）、`includeRawReport`、`breakdown`、`filters`、`dateFrom`、`dateTo`、`statisticalMethod`、`conversionType`、`referenceVariationId`（バリエーションIDまたはキー。オフのバリエーションの場合は `0` または `off`）。値は `experiment_results_get` と同じです |

### ルール、バリエーション、変数

| ツール | 必須パラメータ | オプションのパラメータ |
| - | - | - |
| `feature_flag_rule_targeted_create` | `siteCode`、`featureKey`、`environmentKey`、`variationKey`、`exposition`、`releaseDateTime`、`timeZone` | `ruleName`、`confirm`（フラグがその環境で既に有効な場合に必須） |
| `feature_flag_rule_progressive_create` | `siteCode`、`featureKey`、`environmentKey`、`variationKey`、`startExposition`、`stopExposition`、`increaseBy`、`frequencyValue`、`frequencyUnit`（`MINUTES`、`HOURS`、または `DAYS`）、`releaseDateTime`、`timeZone` | `ruleName`、`confirm`（フラグがその環境で既に有効な場合に必須） |
| `feature_flag_rule_experimentation_create` | `siteCode`、`featureKey`、`environmentKey`、`controlVariationKey`、`trafficAllocations`、`exposition`、`releaseDateTime`、`timeZone` | `ruleName`、`confirm`（フラグがその環境で既に有効な場合に必須） |
| `feature_flag_variation_create` | `siteCode`、`featureKey`、`variationKey`、`variationName` | なし |
| `feature_flag_variable_create` | `siteCode`、`featureKey`、`variableKey`、`variableType`、`defaultValue` | なし |
| `feature_flag_variation_variable_set` | `siteCode`、`featureKey`、`variationKey`、`variableKey`、`value` | なし |

**受け付ける列挙値:** `variableType` は `BOOLEAN`、`NUMBER`、`STRING`、`JSON`、`JS`、`CSS`、`ENUM` のいずれかです。`trafficAllocations` は、`variationKey:percentage` をカンマで区切った文字列で、合計が 100 になります（例: `off:50,on:50`）。`releaseDateTime` は、オフセットなしのISO-8601形式のローカル日時です（例: `2026-07-01T09:00:00`）。`timeZone` はIANAタイムゾーンです（例: `Europe/Paris` または `UTC`）。`frequencyUnit` は `MINUTES`、`HOURS`、`DAYS` のいずれかです。

> [!TIP]
>
> 環境ごとのクエリでは、サポートされている場合に `environmentKey = "production"` または `environmentKey = "staging"` を指定してください。