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

> Outils MCP pour créer et modifier des segments d'audience.

Les outils de segment définissent les visiteurs ciblés par une campagne. Un segment est un ensemble de conditions sur les visiteurs, comme l'appareil, la localisation ou les données personnalisées, et chaque campagne qui l'utilise ne cible que les visiteurs qui y correspondent.

## Outils

| Outil | Description | Exemple de prompt |
| - | - | - |
| `segment_list` | Parcourt les segments d'un site, avec le nombre d'utilisations. | "List segments for site `d1alzzxd7k`." |
| `segment_get` | Inspecte l'arbre de conditions d'un segment (JSON brut et résumé lisible). | "Show segment `200604`." |
| `segment_create` | Crée un segment d'audience à partir d'un arbre de conditions. Il accepte tous les types de conditions du générateur de segments, comme la géolocalisation, l'appareil, le navigateur, les données personnalisées, le code visiteur, le cookie et les conversions. Un arbre comporte au plus deux niveaux. | "Create a segment for desktop visitors in France." |
| `segment_update` | Modifie le nom, la description ou les conditions d'un segment, avec n'importe quel type de condition du générateur de segments. Chaque campagne qui utilise le segment cible immédiatement la nouvelle audience. La modification des conditions d'un segment utilisé par autre chose que des expériences draft, ou référencé par un autre segment, nécessite une confirmation. | "Add Belgium to segment `200604`." |
| `segment_delete` | Supprime un segment. L'outil bloque la suppression par défaut lorsque le segment est utilisé, y compris lorsqu'un autre segment l'utilise ; contournez ce blocage avec `force`. | "Delete segment `200604`." |

> [!NOTE]
>
> Les conditions d'un segment comportent au plus deux niveaux : des groupes de conditions reliés par un `AND` ou un `OR` de premier niveau. L'outil refuse un arbre plus profond en expliquant pourquoi, au lieu de l'aplatir, car l'aplatissement peut élargir l'audience. Demandez à votre assistant IA de réécrire l'arbre sur deux niveaux.

## Types de conditions

`segment_create` et `segment_update` acceptent tous les types de conditions du générateur de segments. Les conditions existantes, comme la géolocalisation, le type d'appareil, le navigateur et les données personnalisées, restent disponibles. Les groupes suivants sont également disponibles :

* Code visiteur (`VISITOR_CODE`), cookie (`COOKIE`), code JS (`JS_CODE`) et bloqueur de publicités (`AD_BLOCKER`).
* Langage du SDK et version de l'application (`SDK_LANGUAGE`, `APPLICATION_VERSION`).
* Conversions (`CONVERSIONS`).
* AI Targeting (`HEAT_SLICE`).
* Expérience, personnalisation ou feature flag ciblés (`TARGET_EXPERIMENT`, `TARGET_PERSONALIZATION`, `TARGET_FEATURE_FLAG`).
* Expérience exclusive (`EXCLUSIVE_EXPERIMENT`).
* Segment dans un segment (`SEGMENT`).
* Audiences et badges Tealium (`TEALIUM_AUDIENCE`, `TEALIUM_BADGE`).

Une condition qui ne peut pas exclure, à savoir l'expérience exclusive, les visiteurs nouveaux ou de retour, et l'événement, refuse `include=false` au lieu de basculer en inclusion. Supprimer un segment qu'un autre segment utilise exige `force`, et modifier ses conditions exige une confirmation avec `confirm`. Les outils refusent les références aux objectifs, aux expériences, aux feature flags ou aux segments d'un autre site.

## Paramètres

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

| Outil | Paramètres obligatoires | Paramètres facultatifs |
| - | - | - |
| `segment_list` | Aucun | `siteCode`, `query`, `page`, `perPage` |
| `segment_get` | `segmentId` | Aucun |
| `segment_create` | `name`, `siteCode` | `conditionDataTree` (n'importe quel type de condition du générateur de segments), `description` |
| `segment_update` | `segmentId` | `name`, `description`, `conditionDataTree` (remplace tout l'arbre ; n'importe quel type de condition du générateur de segments), `confirm` (obligatoire lorsque les conditions changent sur un segment utilisé par autre chose qu'une expérience draft, ou par un autre segment) |
| `segment_delete` | `segmentId` | `force` (obligatoire lorsqu'une expérience, une personnalisation, un feature flag ou un autre segment utilise le segment) |