For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/web/feature-flags.md (or send Accept: text/markdown).
Feature flags y anuncios
Despliega en oscuro, limita por workspace y difunde a los miembros.
Guía paso a paso para principiantes
Requisitos previos: lea las dos guías para principiantes a continuación, finalice la configuración local web y abra este monorepo en la raíz de su editor. La configuración web pertenece a apps/web/.env.local; Next.js no lee la raíz .env. /dashboard en el modo falso predeterminado es una demostración sin base de datos; /auth necesita una base de datos migrada.
Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio.
1. Inicie sesión como administrador de la plataforma y abra /admin/flags; cree o seleccione un indicador de prueba y configúrelo explícitamente como habilitado y luego deshabilitado.
2. Actualizar la superficie del producto que lee la bandera y confirmar sus cambios de presentación.
3. Las funciones y derechos aún deben proteger las acciones del servidor cuando se habilita una bandera. Si el API permanece accesible mientras está deshabilitado, agregue una marca de verificación del lado del servidor donde esté previsto.
Para obtener código personalizado, comience con el prompts/README.md proporcionado y copie el mensaje más cercano: prompts/new-app-screen.md para una pantalla de aplicación o prompts/new-landing-page.md para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea AGENTS.md, .ai/PROJECT_CONTEXT.md y los espejos .ai/ correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto.
Configura los flags en Administración
/admin/flags y feature-flags.ts proporcionan la ruta de administración/evaluación de flags del kit. La configuración de flags pertenece a quien administra la plataforma; una interfaz de producto puede reaccionar a una función permitida, pero no adquiere autoridad para cambiar el flag.
Verifica el comportamiento habilitado y deshabilitado
Prueba los valores predeterminados, flags ausentes, actualizaciones, denegación por rol y acciones de servidor controladas por flags. Conserva las comprobaciones de acceso al espacio de trabajo al añadir lógica de despliegue gradual.
Configuración y ajustes
feature-flag-runtime resuelve flags para un contexto de llamada: los flags no configurados están desactivados por defecto y los overrides por flag apuntan a workspaces o usuarios concretos. Un flag ausente nunca puede habilitar una superficie en silencio.
Los anuncios de plataforma (announcement-actions) difunden avisos in-app por la misma superficie de notificaciones que los miembros ya leen — listActiveAnnouncements alimenta el banner y dismissAnnouncementAction registra el descarte.
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)Flujo de implementación
Publica el código en oscuro: fusiona detrás de un flag, actívalo en tu propio workspace y luego amplía. Retira el flag cuando la superficie sea permanente — un flag obsoleto es una segunda fuente de verdad.
Comprueba el flag en la frontera del servidor Y en la navegación: un enlace oculto con la ruta abierta no es una funcionalidad protegida. Mantén los anuncios fuera del correo transaccional — son noticias de producto, no recibos.
Verificación y solución de problemas
Verifica que un flag desactivado oculta navegación, ruta y acción de extremo a extremo; que un override se aplica solo a su objetivo; y que un flag limpiado vuelve al valor por defecto. Prueba que los anuncios llegan a los workspaces previstos y que el descarte persiste.