Herramientas para feature flags

Las herramientas de feature flags controlan cómo entrega un flag una funcionalidad en cada entorno. Su asistente puede activar o desactivar un flag, añadir reglas que lo desplieguen o lo prueben, y definir las variaciones y las variables tipadas que sirve el flag.

Herramientas

Feature flags

Herramienta	Descripción	Prompt de ejemplo
`feature_flag_list`	Busque feature flags por clave, nombre o ID.	”List all feature flags for site `d1alzzxd7k`.”
`feature_flag_get`	Recupere la configuración completa de un flag en un entorno: variaciones, variables, objetivo principal y cadena de reglas.	”Show configuration for flag `snake_game`.”
`feature_flag_create`	Cree un flag con las variaciones predeterminadas `on` y `off`.	”Create a flag `ui_refresh` for site `d1alzzxd7k`.”
`feature_flag_duplicate`	Clone un flag existente (la copia empieza desactivada en todos los entornos).	”Duplicate the `new_search` flag.”
`feature_flag_delete`	Elimine de forma permanente un flag y toda su configuración.	”Delete the flag `ui_refresh`.”
`feature_flag_enable`	Active el interruptor principal del entorno para que el SDK evalúe las reglas.	”Turn on `new_search` in production.”
`feature_flag_disable`	Desactive el interruptor principal del entorno (la cadena de reglas se mantiene intacta).	”Turn off `new_search` in staging.”
`feature_flag_activity_logs_get`	Lea el registro de auditoría de cambios de los flags (quién cambió qué y cuándo).	”Show the recent change history for these feature flags.”
`feature_flag_experiment_results_get`	Obtenga los resultados estadísticos de todos los objetivos asociados a la regla de experimentación de un flag. Acepta los mismos ajustes de `breakdown`, `filters`, de fechas, `statisticalMethod`, `conversionType` y `referenceVariationId` que `experiment_results_get`.	”Get the experiment results for the rule on `new_search`.”

Reglas, variaciones y variables

Defina cómo entrega un flag el valor a los usuarios: añada reglas de entrega y de experimentación, y defina las variaciones y las variables tipadas que sirve.

Herramienta	Descripción	Prompt de ejemplo
`feature_flag_rule_targeted_create`	Añada una regla de entrega dirigida: sirva una variación a un porcentaje del tráfico, con un inicio programado.	”Roll `new_search` out to 20% in production.”
`feature_flag_rule_progressive_create`	Añada una regla de entrega progresiva que aumente la exposición de una variación en pasos fijos, para un despliegue gradual sin comparación estadística.	”Roll `new_search` out in production from 5% to 100%, adding 10% every day.”
`feature_flag_rule_experimentation_create`	Añada una regla de experimentación A/B que reparta el tráfico entre variaciones con seguimiento estadístico.	”A/B test `off` vs `on` 50/50 on `new_search`.”
`feature_flag_variation_create`	Añada una variación personalizada (un estado con nombre de la funcionalidad) a un flag.	”Add a `variant_a` variation to `new_search`.”
`feature_flag_variable_create`	Defina una variable tipada (BOOLEAN, NUMBER, STRING, JSON, JS, CSS, ENUM) con un valor predeterminado.	”Add a STRING variable `label` defaulting to `Search`.”
`feature_flag_variation_variable_set`	Sobrescriba el valor de una variable para una variación concreta.	”Set `label` to `Find` on `variant_a`.”

Parámetros

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

Feature flags

Herramienta	Parámetros obligatorios	Parámetros opcionales
`feature_flag_list`	Ninguno	`siteCode`, `filterQuery`, `page`, `perPage`, `sortField`, `sortOrder`
`feature_flag_get`	`featureKey`, `siteCode`	`environmentKey` (`*` para todos los entornos)
`feature_flag_create`	`siteCode`, `featureKey`, `name`	`description`
`feature_flag_duplicate`	`featureKey`, `siteCode`	Ninguno
`feature_flag_delete`	`featureKey`, `siteCode`	`confirm` (obligatorio para aplicar el cambio)
`feature_flag_enable`	`featureKey`, `siteCode`, `environmentKey`	`confirm` (obligatorio para aplicar el cambio)
`feature_flag_disable`	`featureKey`, `siteCode`, `environmentKey`	`confirm` (obligatorio para aplicar el cambio)
`feature_flag_activity_logs_get`	Ninguno	`type`, `sortKey` (`timestamp`), `sortOrder`, `page`, `perPage`
`feature_flag_experiment_results_get`	`featureKey`, `siteCode`, `environmentKey`, `experimentId`	`goalIds`, `audienceBasis` (`VISITORS` por defecto, o `VISITS`), `includeRawReport`, `breakdown`, `filters`, `dateFrom`, `dateTo`, `statisticalMethod`, `conversionType`, `referenceVariationId` (un ID o una clave de variación, `0` u `off` para la variación off); los valores son los mismos que en `experiment_results_get`

Reglas, variaciones y variables

Herramienta	Parámetros obligatorios	Parámetros opcionales
`feature_flag_rule_targeted_create`	`siteCode`, `featureKey`, `environmentKey`, `variationKey`, `exposition`, `releaseDateTime`, `timeZone`	`ruleName`, `confirm` (obligatorio cuando el flag ya está activado en el entorno)
`feature_flag_rule_progressive_create`	`siteCode`, `featureKey`, `environmentKey`, `variationKey`, `startExposition`, `stopExposition`, `increaseBy`, `frequencyValue`, `frequencyUnit` (`MINUTES`, `HOURS` o `DAYS`), `releaseDateTime`, `timeZone`	`ruleName`, `confirm` (obligatorio cuando el flag ya está activado en el entorno)
`feature_flag_rule_experimentation_create`	`siteCode`, `featureKey`, `environmentKey`, `controlVariationKey`, `trafficAllocations`, `exposition`, `releaseDateTime`, `timeZone`	`ruleName`, `confirm` (obligatorio cuando el flag ya está activado en el entorno)
`feature_flag_variation_create`	`siteCode`, `featureKey`, `variationKey`, `variationName`	Ninguno
`feature_flag_variable_create`	`siteCode`, `featureKey`, `variableKey`, `variableType`, `defaultValue`	Ninguno
`feature_flag_variation_variable_set`	`siteCode`, `featureKey`, `variationKey`, `variableKey`, `value`	Ninguno

Valores aceptados: variableType es BOOLEAN, NUMBER, STRING, JSON, JS, CSS o ENUM. trafficAllocations es una cadena separada por comas de variationKey:percentage que suma 100 (por ejemplo off:50,on:50). releaseDateTime es una fecha y hora local en formato ISO-8601 sin desfase horario (por ejemplo 2026-07-01T09:00:00), y timeZone es una zona horaria IANA (por ejemplo Europe/Paris o UTC). frequencyUnit es MINUTES, HOURS o DAYS.

Para consultas específicas de un entorno, pase environmentKey = "production" o environmentKey = "staging" cuando la herramienta lo admita.

Inicio

Configuración

Referencia de herramientas

Tutoriales

Solución de problemas

Herramientas

Feature flags

Reglas, variaciones y variables

Parámetros

Feature flags

Reglas, variaciones y variables

Inicio

Configuración

Referencia de herramientas

Tutoriales

Solución de problemas

​Herramientas

​Feature flags

​Reglas, variaciones y variables

​Parámetros

​Feature flags

​Reglas, variaciones y variables

Herramientas

Feature flags

Reglas, variaciones y variables

Parámetros

Feature flags

Reglas, variaciones y variables