> ## Documentation Index > Fetch the complete documentation index at: https://docs.zappway.ai/llms.txt > Use this file to discover all available pages before exploring further. # Runtime de Cognitive Strategy > Integraciones, persistencia, privacidad, despliegue gradual y validación de la estrategia conversacional. ## Arquitectura y responsabilidades AgentRouter conserva el enrutamiento; Cortex selecciona conocimiento, Skills y especialistas; AgentManager elige chat-v4 o generación directa. Customer360 agrega actividad y continuidad de CustomerCase. La inteligencia incremental proporciona snapshots. Livia del dashboard tiene un orquestador separado con permisos, briefing, oportunidades, historial, repositorio y capturas de pantalla. No es sinónimo de Customer360. El módulo `packages/zappway/lib/cognitive-strategy` transforma perfil, configuración y contexto tipados en una decisión conversacional finita. Consume contexto existente sin nuevas llamadas LLM, selección de agentes ni ejecución de herramientas. La auditoría y sus referencias están en `docs/audits/cognitive-strategy-layer.md`. ```mermaid theme={null} flowchart LR Entrada --> Identidad[Contacto y organización] Identidad --> Caso[CustomerCase e historial] Caso --> Router[AgentRouter] Router --> Manager[AgentManager] Manager --> Cortex[Cortex existente] Cortex --> Strategy[Cognitive Strategy opcional] Strategy --> Modelo[Agente, Skills y modelo existente] Modelo --> Herramientas[Herramientas autorizadas y subagentes] Herramientas --> Entrega[Persistencia y entrega en el canal] ``` En Livia autenticada: orquestador → permisos y despliegue gradual → grafo autorizado e historial → estrategia opcional → modelo existente de context-brain → respuesta con fuentes existentes. Aprobación y ejecución de acciones siguen el flujo actual. ## Contratos e identidad `CognitiveStrategyProfile` tiene versiones inmutables. `CognitiveContext` contiene identificadores, acciones disponibles e indicadores limitados. `CognitiveStrategyDecision` contiene objetivo, etapa opcional, movimiento, foco, códigos de evidencia, próxima acción y confianza. No contiene razonamiento privado. La confianza es una puntuación determinista de política, no una probabilidad calibrada ni una previsión de conversión. `zappway_livia` exige la organización canónica y un ID de agente autorizado, o la entrada autenticada de context-brain en el servidor. Un nombre copiado, metadatos del cliente o payload de Flow no seleccionan ese perfil. Livia del dashboard usa `complete_request`; agentes Livia aprovisionados usan activación por defecto. Los perfiles genéricos no tienen objetivo comercial predeterminado. Ningún perfil almacena precios, ofertas o afirmaciones de producto. El LLM existente interpreta el lenguaje natural. Las instrucciones de estrategia están en inglés y conservan idioma de respuesta, personalidad y canal. No existen regex ni listas de frases traducidas para clasificar intención. Las señales explícitas opcionales representan evidencia estructurada. El modelo debe reconocer cierre y solicitudes de atención humana en el idioma de la conversación y darles prioridad sobre la orientación consultiva. ## Persistencia, precedencia y herencia La configuración reside en los JSON existentes `Agent.interfaceConfig` (`interface_config`) y `Tool.config`, validados por Zod. No hay migraciones Prisma, escrituras desnormalizadas ni índices nuevos. La declaración de Flow pertenece al vínculo entre agente y herramienta. Se conservan grafos, versiones, serialización y ejecución en segundo plano de ZappFlux. No se encontró un motor Flow exclusivo de Livia; las rutinas programadas de briefing, informes y alertas siguen siendo deterministas. Seguridad, permisos, reglas organizativas, instrucciones explícitas del agente, límites de herramientas y hechos tienen prioridad. chat-v4 añade un bloque breve después de identidad/Cortex, Skills y reglas de herramientas, conservando conocimiento, historial y mensajes del usuario. Generación directa y Livia usan el mismo compositor. Nunca se interpola texto libre de clientes o snapshots en ese bloque. La delegación transporta una referencia interna vinculada a organización, conversación y ámbito. El hijo conserva identidad, herramientas y Skills privadas; las compartidas del padre y de la organización siguen el resolvedor existente. El hijo puede aportar su propio objetivo; las restricciones se unen. La delegación no eleva shadow. La referencia no forma parte de DTO públicos, argumentos de herramientas ni metadatos de respuesta. Un Flow activado con éxito puede completar objetivo/etapa ausentes y añadir restricciones durante el turno actual. No sustituye el objetivo del agente ni el experimento. Un Flow en shadow emite una decisión sin cambiar mensajes o referencia heredada. La orientación anterior se sustituye conservando las instrucciones originales. La etapa no persiste entre turnos y la activación no demuestra que haya finalizado el trabajo en segundo plano. ## Consultas y minimización El enriquecimiento opcional consulta Conversation por ID primario y organizationId, y ConversationIntelligenceState por conversationId único y organizationId. CustomerCase procede de la relación existente y se comprueba su organización. La proyección existente interpreta caso/snapshot sin otro agregador de contactos o pagos. El caso canónico permite continuidad entre canales. Los snapshots de más de una hora no seleccionan movimientos de preguntas pendientes u objeciones. El presupuesto de enriquecimiento es de 150 ms. Timeout, ausencia y excepciones conservan el contexto de entrada. Una caché local de 256 decisiones y 60 segundos usa organización, conversación, turno/contexto/configuración y hash del mensaje. No almacena texto bruto ni añade llamadas de modelo. El proveedor factura los tokens extra del bloque breve según su política. ## API y privacidad PATCH de agente conserva `agents.write`, `assertSameOrganization` y la estructura existente; valida el ámbito mediante identidad del servidor. GET público y externo eliminan configuración cognitiva de interfaz y herramientas Flow. Las lecturas autorizadas de gestión la conservan. La sanitización de credenciales HTTP permanece activa. No existe herramienta para recuperar configuración. IDs de estrategia, experimentos y decisiones no se envían al cliente. La orientación visible al modelo no contiene datos sensibles; las instrucciones de sistema no garantizan secreto del prompt. Este módulo no resuelve toda inyección de prompt ni elimina campos públicos preexistentes sin relación con la estrategia. ## Despliegue gradual, telemetría y reversión `COGNITIVE_STRATEGY_MODE` admite `disabled`, `shadow` o `enabled`. Su ausencia desactiva salvo adhesión explícita del agente. `disabled` global o `COGNITIVE_STRATEGY_EMERGENCY_DISABLED=true` prevalece sobre ajustes persistidos. `shadow` global es un límite de despliegue y no puede ser promovido por la configuración del agente. `COGNITIVE_STRATEGY_ORGANIZATIONS` limita organizaciones mediante IDs separados por comas; una lista vacía no restringe. Livia del dashboard respeta además los controles PA existentes y `PERSONAL_ASSISTANT_COGNITIVE_STRATEGY_MODE`, desactivado por defecto. Turbo transmite estas variables exclusivas del servidor. La telemetría Cortex registra `cognitive_strategy.evaluated`, `applied`, `shadowed`, `error` y `outcome`. Incluye decisión/perfil/versión, objetivo/etapa, canal, agente/conversación/turno, Flow/experimento/cohorte opcionales, movimiento/acción, confianza, caché, latencia, caracteres y estimación de tokens adicionales. No registra mensajes brutos, prompts, datos sensibles ni razonamiento privado. Los resultados medidos son generación de respuesta, delegación correcta y error de generación. Los eventos existentes de lead, pago y resolución pueden correlacionarse por conversación en análisis posteriores; no constituyen conversiones comerciales atribuidas. El experimento se asigna explícitamente (`id`, `variant`, `cohort` opcional); control evalúa sin aplicar orientación. No existe una plataforma nueva de pruebas A/B. Para revertir, desactive globalmente y reinicie/despliegue mediante el proceso normal, sin migraciones ni eliminación de datos. ## Validación y límites Las pruebas cubren ámbitos, aislamiento, contexto inválido/ausente, timeout, modos, Flow, serialización, sanitización pública, contención de fallos, integración directa, canales, caché y datos con formato de inyección. Las suites existentes de Cortex, Skills/delegación y PA complementan la validación. Comandos y mediciones locales figuran en el informe de implementación. Esta entrega prepara infraestructura. No crea campañas, prospección, adquisición agresiva, playbook definitivo, asignación automática de experimentos, objetivos comerciales, adaptadores de canal, segundo Cortex/Customer360 ni cambios de modelo/proveedor. Las llamadas directas a chat-v4 sin runtime interno conservan su comportamiento. Shadow mide decisiones propuestas; no genera respuesta contrafactual ni demuestra mejoras comerciales.