Documentación técnica

El contexto de trabajo y las credenciales siguen rutas distintas.

Cada clase de información tiene un propósito, un límite de almacenamiento y un modelo de acceso.

Tres planos que cooperan sin mezclarse

La separación no consiste solamente en guardar información en lugares distintos. También define quién puede resolver cada dato, en qué momento puede usarlo y qué parte puede entrar al contexto del modelo. El plano de identidad decide para quién se ejecuta una solicitud; el plano de datos aporta con qué información se trabaja; y el plano de credenciales demuestra con qué autorización técnica puede actuar una herramienta.

Plano de datos

Contiene la solicitud actual, el historial pertinente, la memoria seleccionada y el estado estructurado de la tarea. El runtime compone una vista mínima para cada interacción: el modelo no recibe automáticamente toda la conversación, toda la memoria ni todos los registros disponibles.

Plano de identidad

Vincula el evento con el cliente, la cuenta, el agente y la sesión correctos usando contexto confiable de enrutamiento y autenticación. Esa identidad determina qué datos, herramientas e integración pueden considerarse; el texto enviado por una persona no puede sustituirla.

Plano de credenciales

Conserva y resuelve los secretos o autorizaciones necesarios para un sistema externo. Las credenciales no forman parte de las instrucciones ni de la memoria del agente: se entregan al componente autorizado únicamente cuando una herramienta válida debe ejecutar una operación.

Ejemplo: si una persona pide por Slack consultar un cliente en el CRM, el plano de identidad vincula el mensaje con la organización, el agente y la cuenta autorizada; el plano de datos entrega al modelo la solicitud y el contexto comercial pertinente; y el plano de credenciales permite que la herramienta consulte el CRM. El modelo recibe el resultado estructurado, no el token utilizado para obtenerlo.

Principios de manejo

Sin entrenamiento con datos del cliente

RunMyDay no utiliza los datos del cliente para entrenar modelos. La información se procesa para responder la solicitud y ejecutar las capacidades autorizadas; usarla durante una sesión no la convierte en material de entrenamiento.

Minimización

El contexto se construye para la tarea; no todo dato disponible se incorpora a cada sesión ni a cada llamada de herramienta.

Memoria selectiva

No todo mensaje se convierte en memoria durable. La persistencia responde a utilidad operativa y reglas de la implementación.

Secretos por referencia

La configuración versionada identifica qué secreto necesita un componente sin incluir su valor sensible.

Autorización separada

Cuando se usa OAuth, la autorización de larga duración permanece en un servicio dedicado y la herramienta obtiene acceso para la operación.

Resultados acotados

Las herramientas devuelven datos estructurados y errores explícitos, reduciendo contenido innecesario en el contexto.

Registro prudente

Los servicios sensibles priorizan identificadores, estado y tiempos sobre payloads completos o credenciales.

Protección de credenciales de extremo a extremo

Gestionar una credencial no es solamente almacenarla de forma segura. Su ciclo completo incluye incorporación, cifrado, resolución de identidad, uso acotado, observabilidad y una ruta explícita de revocación o reautorización.

  1. Incorporación y almacenamiento

    La configuración versionada contiene referencias, nunca valores secretos. Para OAuth, las credenciales de larga duración se cifran antes de persistir mediante cifrado autenticado por envolvente: cada registro usa una nueva clave de datos y un nuevo nonce, y el cifrado queda vinculado a metadatos de la cuenta. Una versión desconocida, metadatos incompatibles o un fallo de descifrado detienen la operación.

  2. Resolución y uso acotado

    Cuando una herramienta necesita actuar, el servicio de autenticación deriva la cuenta desde la identidad confiable de la integración y resuelve la autorización dentro de su propio límite. La herramienta recibe acceso de corta duración junto con su vencimiento y alcance; la credencial de renovación no sale de ese servicio y el modelo solo recibe el resultado de la operación.

  3. Diagnóstico sin exposición

    Los componentes de autenticación filtran encabezados y campos sensibles antes de registrar eventos. La evidencia operativa conserva códigos de razón, estados, conteos, tiempos e identificadores no secretos: suficiente para investigar un fallo sin convertir los logs en otro almacén de credenciales.

  4. Alcance y ciclo de vida

    Para cada integración se definen la cuenta autorizada, los permisos requeridos y las condiciones de reautorización o revocación. Clasificación, fuentes permitidas, retención, eliminación, memoria durable y residencia cuando aplica se acuerdan según el proceso; la documentación privada conserva esas decisiones para las personas autorizadas.