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

# Herramientas para segmentos

> Herramientas MCP para crear y editar segmentos de audiencia.

Las herramientas de segmentos definen a quién se dirige una campaña. Un segmento es un conjunto de condiciones sobre el visitante, como el dispositivo, la ubicación o los datos personalizados, y cada campaña que lo usa solo se dirige a los visitantes que cumplen esas condiciones.

## Herramientas

| Herramienta | Descripción | Prompt de ejemplo |
| - | - | - |
| `segment_list` | Explore los segmentos de un sitio, con el número de usos. | "List segments for site `d1alzzxd7k`." |
| `segment_get` | Revise el árbol de condiciones de un segmento (JSON sin procesar y un resumen legible). | "Show segment `200604`." |
| `segment_create` | Cree un segmento de audiencia a partir de un árbol de condiciones. Acepta todos los tipos de condición del generador de segmentos, como geolocalización, dispositivo, navegador, datos personalizados, código de visitante, cookie y conversiones. Un árbol tiene como máximo dos niveles. | "Create a segment for desktop visitors in France." |
| `segment_update` | Cambie el nombre, la descripción o las condiciones de un segmento, con cualquier tipo de condición del generador de segmentos. Cada campaña que usa el segmento se dirige de inmediato a la nueva audiencia. Cambiar las condiciones de un segmento usado por algo distinto de experimentos en draft, o referenciado por otro segmento, requiere confirmación. | "Add Belgium to segment `200604`." |
| `segment_delete` | Elimine un segmento. La herramienta bloquea la eliminación de forma predeterminada cuando el segmento está en uso, incluso si otro segmento lo usa; para forzarla, use `force`. | "Delete segment `200604`." |

> [!NOTE]
>
> Las condiciones de un segmento admiten como máximo dos niveles: grupos de condiciones unidos por un `AND` u `OR` de primer nivel. La herramienta rechaza un árbol de condiciones más profundo y explica el motivo, en lugar de aplanarlo, porque aplanarlo puede ampliar la audiencia. Pida a su asistente de IA que reescriba el árbol en dos niveles.

## Tipos de condición

`segment_create` y `segment_update` aceptan todos los tipos de condición del generador de segmentos. Las condiciones existentes, como geolocalización, tipo de dispositivo, navegador y datos personalizados, siguen disponibles. También están disponibles los siguientes grupos:

* Código de visitante (`VISITOR_CODE`), cookie (`COOKIE`), código JS (`JS_CODE`) y bloqueador de anuncios (`AD_BLOCKER`).
* Idioma del SDK y versión de la aplicación (`SDK_LANGUAGE`, `APPLICATION_VERSION`).
* Conversiones (`CONVERSIONS`).
* AI Targeting (`HEAT_SLICE`).
* Experimento, personalización o feature flag dirigidos (`TARGET_EXPERIMENT`, `TARGET_PERSONALIZATION`, `TARGET_FEATURE_FLAG`).
* Experimento exclusivo (`EXCLUSIVE_EXPERIMENT`).
* Segmento dentro de un segmento (`SEGMENT`).
* Audiencias y badges de Tealium (`TEALIUM_AUDIENCE`, `TEALIUM_BADGE`).

Una condición que no puede excluir, es decir, experimento exclusivo, visitantes nuevos o recurrentes, y evento, rechaza `include=false` en lugar de cambiar a include. Eliminar un segmento que usa otro segmento requiere `force`, y cambiar sus condiciones requiere confirmación con `confirm`. Las herramientas rechazan las referencias a objetivos, experimentos, feature flags o segmentos de otro sitio.

## Parámetros

Use los nombres exactos de parámetro que devuelve `tools/list`.

| Herramienta | Parámetros obligatorios | Parámetros opcionales |
| - | - | - |
| `segment_list` | Ninguno | `siteCode`, `query`, `page`, `perPage` |
| `segment_get` | `segmentId` | Ninguno |
| `segment_create` | `name`, `siteCode` | `conditionDataTree` (cualquier tipo de condición del generador de segmentos), `description` |
| `segment_update` | `segmentId` | `name`, `description`, `conditionDataTree` (reemplaza todo el árbol; cualquier tipo de condición del generador de segmentos), `confirm` (obligatorio cuando cambian las condiciones de un segmento usado por algo distinto de un experimento en draft, o por otro segmento) |
| `segment_delete` | `segmentId` | `force` (obligatorio cuando un experimento, una personalización, un feature flag u otro segmento usa el segmento) |