Saltar al contenido
focoit.com
04Diagramas

Diagramas que explican un sistema mejor que un párrafo.

Diagramas de arquitectura, secuencia y estados, de mis propios diseños y de las notas.

Un asistente agéntico de preguntas y respuestas, de punta a punta FLUJO · GRAFO DEFINIDO EN CÓDIGO Filtro de datos personales Prompt Shield Consulta al caché clave SHA-256 Recuperar acotado por permisos Redactar perfil: sitio Filtro de contenido + veredicto de seguridad Puerto de revisión revisión humana Entregar / Rechazar SIN ACIERTO ACIERTO Usuario del sitio hace una pregunta Enrutador de modelos Azure OpenAI · PHI Claude · sin PHI Interfaz del revisor aceptar · editar · rechazar PEDIDO / RESPUESTA CAPA DE CONOCIMIENTO · AZURE AI SEARCH Planificación de la consulta (LLM) esfuerzo: mínimo · bajo · medio Subconsultas paralelas + reordenamiento semántico Fuente del estudio A Fuente del estudio B Síntesis + referencias + registro de actividad CONTEXTO Otros agentes de la empresa ENDPOINT MCP Almacén de checkpoints pedidos pendientes guardados Auditoría App Insights + almacén de cumplimiento CADA PASO REFERENCIAS Control de seguridad Paso de revisión humana Almacén Auditoría
01

Un asistente agéntico de preguntas y respuestas, de punta a punta

Un flujo definido en código con controles de seguridad, caché, recuperación acotada por permisos, un paso de revisión humana, enrutamiento de modelos, checkpoints y auditoría.

Arquitectura
Una pregunta, de la pantalla al registro de auditoría Usuario del sitio Flujo grafo definido en código Capa de conocimiento Enrutador de modelos Revisor Auditoría 1 pregunta + estudio + perfil 2 datos personales → Prompt Shield 3 controles superados 4 consulta al caché (clave SHA-256) ACIERTO DE CACHÉ 5 respuesta revisada · 0 llamadas 6 recuperar (por permisos) 7 plan → subconsultas → reorden 8 contexto + referencias 9 redactar (Azure OpenAI · camino con PHI) 10 borrador con citas 11 filtro de contenido → veredicto 12 pedido de revisión (evento) El flujo queda en espera. Un checkpoint conserva el pedido: sobrevive a un reinicio o a un despliegue. 13 aceptar · editar · rechazar · escalar 14 recorrido completo: pregunta, fragmentos, borrador, veredicto, acción 15 entregar o rechazar SIN ACIERTO REFERENCIAS Llamada Retorno / auditoría Revisión humana
02

Una pregunta, de la pantalla al registro de auditoría

Qué pasa con una pregunta: controles, caché, recuperación, borrador, veredicto, revisión, entrega, y qué se escribe en auditoría en el camino.

Secuencia
Orquestación y recuperación agéntica CONSUMIDORES Usuarios y agentes usuarios · otros agentes los agentes entran por una herramienta MCP Grafo del flujo orden definido en código · checkpoints … → Borrador → Veredicto → Revisión → Entrega SERVICIOS COMPARTIDOS Caché determinista solo respuestas revisadas un acierto no llama al modelo Enrutador de modelos Azure OpenAI: PHI (BAA) Claude: razonamiento sin PHI versión fija → clave de caché Auditoría App Insights + cumplimiento cada paso · registro de actividad conteo de tokens RECUPERACIÓN AGÉNTICA · CAPA DE CONOCIMIENTO Planificación un LLM divide la consulta en subconsultas esfuerzo: mín · bajo · medio Subconsultas paralelas texto · vectores · híbrida + reorden semántico Síntesis contexto unificado + citas + registro de actividad Fuentes por estudio un índice por estudio PEDIDO CONSULTA AL CACHÉ RECUPERAR CONTEXTO + REFERENCIAS MODELO POR PASO REFERENCIAS Recorrido del pedido Auditoría Orquestador Servicio Almacén / caché
03

Orquestación y recuperación agéntica

Un grafo de flujo que maneja una capa de conocimiento: planificación de la consulta, subconsultas paralelas sobre fuentes por estudio, y síntesis con referencias.

Arquitectura
La pausa durable del revisor Flujo grafo de ejecutores Puerto de revisión pedido / respuesta tipados Interfaz del revisor proceso separado Almacén de checkpoints durable 1 borrador · citas · veredicto · versiones 2 evento de pedido → pausa 3 checkpoint en el superpaso: pedido pendiente guardado flujo en pausa: estado normal mientras alguien revisa REINICIO O DESPLIEGUE EN MEDIO DE LA REVISIÓN · sin checkpoint, la ejecución se pierde 4 restaurar: estado del ejecutor + pedidos pendientes 5 el evento se vuelve a emitir 6 respuesta · texto editado · identidad idempotente por id de pedido acción: aceptar · editar · rechazar · escalar → puerto del revisor de seguridad 7 la respuesta vuelve al ejecutor Entregar | Rechazar: nunca sin revisión REFERENCIAS Llamada Retorno / restauración / guardado Evento (asíncrono) Puerto de pedidos
04

La pausa durable del revisor

Un paso de revisión que sobrevive a un reinicio: el pedido pendiente queda en un checkpoint y vuelve al revisor cuando el flujo se restaura.

Secuencia
Seguridad, aislamiento y controles de IA responsable INGRESO NO CONFIABLE LÍMITE DE CUMPLIMIENTO · SOLO SERVICIOS GA INFRAESTRUCTURA PRIVADA · RBAC Usuario autenticado usuario · agente MCP Entra ID Fuente remota / preview fuera del límite Controles ordenados PII → Shield → filtro → veredicto el orden es la topología del grafo, no una convención Borrador → veredicto → entrega identidad de mínimo privilegio solo lectura y recuperación Filtro por permisos del lado del servidor armado con los permisos, nunca con el texto escrito Fuentes por estudio 1 índice / estudio Escudo de fragmentos revisa inyección indirecta antes de redactar Almacén de checkpoints un límite de confianza: cifrado, sin cargas no confiables Auditoría + cumplimiento App Insights · inmutable registro de actividad + tokens PEDIDO PREGUNTA FILTRADA POR PERMISOS FRAGMENTOS REVISADOS GUARDAR CADA PASO ALCANCE DESDE EL TEXTO FUENTE EN PREVIEW: BLOQUEADA REFERENCIAS Ruta permitida Bloqueado en el límite Auditoría / guardado Control de seguridad Punto de control Almacén privado
05

Seguridad, aislamiento y controles de IA responsable

Dónde está cada defensa, qué ruta está permitida y qué ingreso se detiene en el límite.

Seguridad
Autonomía por fases Avanza en un solo sentido: adelante solo con evidencia sostenida, atrás solo con el interruptor. VALOR SEGURO POR DEFECTO Fase 1 · Revisión obligatoria cada respuesta pasa por un revisor antes de entregarse EMPIEZA LA AUTONOMÍA Fase 2 · Autonomía selectiva bajo riesgo: entrega automática (muestreada) alto riesgo: se sigue revisando CANDIDATA A FASE 3 Fase 3 · Alcance ampliado farmacovigilancia entre estudios rol · auditoría · cola separados INICIO fundamentación + citas sostenidas, aceptación estable evaluaciones por categoría sostenidas; nuevo rol y modelo de auditoría aprobados INTERRUPTOR INTERRUPTOR Una máquina de estados por categoría de respuesta. El interruptor es configuración: devuelve cualquier fase avanzada a la revisión obligatoria. REFERENCIAS Avance: con evidencia, en un sentido Interruptor: configuración, por categoría Valor seguro Candidata futura
06

Autonomía por fases

La autonomía avanza en un solo sentido, por categoría de respuesta y solo con evidencia sostenida, con un interruptor que devuelve cualquier fase a la revisión obligatoria.

Máquina de estados
LLM, agente y MCP
07

LLM, agente y MCP

Cómo viaja una pregunta: un agente contiene el modelo y llega a tus sistemas a través de MCP.

Arquitectura
Chat empresarial en Azure
08

Chat empresarial en Azure

Un chat privado en Azure: gateway, red privada, agente, búsqueda y modelo.

Arquitectura
El ciclo de cuatro roles
09

El ciclo de cuatro roles

Planificar, ejecutar, revisar y validar, con los revisores independientes de quien ejecuta.

Proceso
La compuerta
10

La compuerta

Qué revisa la compuerta del repositorio antes de un commit, y qué bloquea.

Proceso