PTENES
MÓDULO 3.3

🗺️ Diseñar la arquitectura

Ya elegiste el problema y definiste la intención. Ahora es momento de diseñar el camino: tomar todo lo que aprendiste el Día 1 (canales, infraestructura) y el Día 2 (alma, servicios, agentes, herramientas, seguridad) y reunirlo en un blueprint: el diseño de la solución que guía la construcción.

las reglas y la seguridad afectan el flujo Intención el destino Canales la puerta Enrutamiento lo envía a quien corresponde servicios agentes herramientas resultado De la intención al resultado: canales → enrutamiento → servicios/agentes → herramientas, todo dentro de las reglas. Es el blueprint.
6
Temas
~50
Minutos
Aplicado
Nivel
Práctica
Tipo
Progreso del módulo0 de 6 · 0%
1

🗺️ Del problema al diseño

Llegaste aquí con dos cosas en la mano: un problema elegido (Módulo 3.2) y una intención clara (Módulo 3.1). Diseñar la arquitectura es traducir esto en un camino concreto: quién habla con el sistema, qué hace con eso y qué devuelve. El diseño es el puente entre "quiero resolver esto" y "construí esto" — y diseñar antes evita tener que rehacerlo después.

🧭 La arquitectura es solo un diagrama de flujo

No te asustes con la palabra "arquitectura". Aquí no se refiere a código ni a un diagrama de ingeniería: es un dibujo sencillo del recorrido de la intención. Entra por algún lugar, pasa por algunas manos, usa algunas herramientas, respeta algunas reglas y sale como resultado. Dibujar ese recorrido es el trabajo de este módulo.

1

Identifica el problema y la intención

El punto de partida siempre es el problema elegido y el resultado que quieres, no la herramienta de moda.

2

Traza el camino

Por dónde entra, por dónde pasa, qué usa y qué devuelve: en cuadros y flechas, en papel o en pantalla.

3

Se convierte en un blueprint

El diseño definido guía el prototipo del Módulo 3.4: construir se convierte en ejecución, no en improvisación.

Entrada
problema + intención
Trabajo
diseñar el camino
Salida
el blueprint
Beneficio
diseñar antes de hacer
2

🚪 Canales y enrutamiento

Toda solución necesita una puerta de entrada — el canal por el que llega la intención (WhatsApp, sitio web, correo electrónico, formulario). Pero el canal por sí solo no basta: el sistema necesita enrutamiento — saber, al recibir el mensaje, a qué servicio o agente enviarlo dentro del sistema. El canal correcto + el enrutamiento correcto hacen que la solución parezca fluida; si son incorrectos, todo se atasca en la puerta.

🔀 Canal × enrutamiento, lado a lado

  • Canal: por dónde entra la intención y por dónde sale la respuesta (la puerta visible para el usuario).
  • Enrutamiento: la decisión interna de "¿este mensaje es para qué parte del sistema?" — invisible para el usuario.
  • Juntos: el usuario habla en un solo lugar y cada solicitud llega a quien corresponde, sin que note cómo funciona el mecanismo.

✓ Enrutamiento bien diseñado

  • ✓Cada tipo de solicitud tiene un destino claro.
  • ✓Hay una vía para el «no entendí» (fallback).
  • ✓El usuario habla por un solo canal y todo fluye.
  • ✓Se puede agregar un destino nuevo sin romper nada.

✗ Sin enrutamiento planificado

  • ✗Todo cae en el mismo lugar y se mezcla.
  • ✗Una solicitud inesperada se bloquea sin respuesta.
  • ✗Cada canal nuevo se convierte en un arreglo improvisado aparte.
  • ✗Nadie sabe por dónde pasó el mensaje.

💡 Consejo práctico

Empieza con UN canal: el que ya usa tu público. WhatsApp para la atención, un formulario en el sitio web para captar contactos, correo electrónico para el equipo interno. Un canal bien configurado vale más que cinco canales desordenados. Agrega los demás cuando el primero funcione.

Canal
la puerta visible
Enrutamiento
la decisión interna
Fallback
camino del "no sé"
Empieza con
un solo canal
3

🧱 Servicios y agentes de la solución

Dentro del sistema, el trabajo lo realizan dos tipos de componentes que ya conociste en el Día 2: servicios (bloques de capacidad — buscar un dato, generar un texto, registrar algo) y agentes (trabajadores con una misión, que toman decisiones y usan servicios y herramientas). Diseñar la arquitectura es decidir qué piezas necesita tu solución y cómo se reparten el trabajo.

La solución (la arquitectura) Agentes el agente atiende el agente resuelve Servicios buscar un dato generar texto registrar cada pieza una responsabilidad

💡 Consejo práctico

Regla de oro: cada pieza hace UNA cosa bien. Si estás describiendo un agente y usas la palabra "y" muchas veces ("atiende e cobra e agenda e relata»), probablemente sean varios agentes disfrazados de uno. Separarlos facilita probar y mejorar cada pieza.

Servicio
un bloque de capacidad
Agente
un trabajador con una misión
Regla
una cosa por pieza
Beneficio
probar y evolucionar poco a poco
4

🔧 Herramientas necesarias

Para actuar en el mundo real, la solución necesita herramientas: la hoja de cálculo donde consultas un precio, el CRM donde registras un cliente, el calendario donde agendas una reunión, la API que envía un mensaje. La regla de oro del Día 2 sigue vigente: la herramienta está al servicio de la intención, nunca al revés. Enumera solo lo que el flujo realmente necesita, y nada más.

📊

Hoja de cálculo / base de datos

Dónde la solución lee y guarda datos.

👥

CRM

Dónde están los clientes y el historial.

📅

Calendario

Para agendar, recordar y organizar el tiempo.

💬

Mensajería

Para enviar y recibir mensajes por los canales.

🔌

APIs externas

Otros sistemas que consulta la solución.

📁

Archivos / docs

La base de conocimiento que consulta.

🧰 La prueba de lo mínimo necesario

Para cada herramienta que piensas incluir, pregúntate: "sin ella, ¿el flujo sigue entregando el resultado?". Si sí, déjala fuera del prototipo: se incorpora después, si hace falta. Una solución sencilla nace, funciona y muestra su valor más rápido. Cada herramienta adicional es un peso que cargas sin necesidad.

Sirven
a la intención
Criterio
¿el flujo lo necesita?
Cantidad
lo mínimo necesario
Resto
entra después, si hace falta
5

🛡️ Reglas y seguridad del flujo

Cuando la IA empieza a actuar en el mundo real —enviar mensajes, modificar datos, programar cosas—, la la seguridad se convierte en parte de la arquitectura, no un detalle para después. Los límites que viste en el Módulo 2.6 forman parte del diseño: qué puede hacer la solución por sí sola, qué debe validar y qué siempre requiere la aprobación de una persona antes de ejecutarse.

✗
Flujo sin permisos deja que la IA haga demasiado.

Sin límites, una acción equivocada provoca daños reales y costosos.

✗
Flujo sin validación acepta basura como verdad.

Sin validar la entrada, el sistema actúa sobre datos incorrectos.

✗
Flujo sin aprobación humana en el punto crítico, asusta.

Las acciones de riesgo (borrar, cobrar, enviar al cliente) requieren el «ok» de una persona.

✅ El muro en el punto adecuado

No todo necesita un muro. El secreto es poner la barrera donde el riesgo es alto: leer un dato puede ser libre; borrar, cobrar o enviarle un mensaje a un cliente requiere validación o aprobación. Marca en tu blueprint, con un candado, cada punto donde una acción solo se realiza después de ser verificada.

Permiso
qué puede hacer
Validación
verificar la entrada
Aprobación
humano en situaciones de riesgo
Dónde
en el punto de riesgo
6

📐 El blueprint de la solución

Ahora reúnes todo en un solo diseño: intención, canales, enrutamiento, servicios, agentes, herramientas y reglas. Ese es el blueprint — el plano de tu solución. Reúne todo lo que viste el Día 1 (terreno y canales) y el Día 2 (esencia, servicios, agentes, herramientas, seguridad), aplicado a TU problema. Con el blueprint en mano, construir el prototipo se vuelve ejecución, no improvisación.

El blueprint, en texto estructurado

intención: _______________________________
problema: _______________________________
canal_entrada: __________________________
enrutamiento: ____________________________
servicos: ______________________________
agentes: _______________________________
herramientas: ___________________________
reglas: ________________________________
resultado: _____________________________
como_medir: ____________________________

Completa una fila a la vez. Cuando todas estén respondidas, tendrás el blueprint de la solución, listo para el prototipo del Módulo 3.4.

1

Empieza por la intención y el resultado

Los dos extremos del diagrama: de dónde parte (el problema) y adónde llega (el beneficio medido).

2

Conecta el canal de entrada

Por donde llega la intención y cómo el enrutamiento la envía a la pieza adecuada.

3

Conecta servicios, agentes y herramientas

Quién hace el trabajo durante el proceso y qué usa cada quien para actuar.

4

Marca los muros

Dónde entran la validación y la aprobación humana: los puntos de riesgo del flujo.

💡 Consejo práctico

Un buen blueprint cabe en una hoja y cualquier persona de la empresa puede seguir el recorrido con el dedo. Si tu diseño quedó demasiado complejo para explicarlo en dos minutos, probablemente intenta resolver más de un problema. Vuelve atrás y delimítalo: enfocarse en UN problema es lo que hace que la solución cobre vida.

Blueprint
el plano de la solución
Reúne
Día 1 + Día 2
Cabe
en una hoja
Guía
el prototipo (3.4)

Autoevaluación (opcional): ¿qué es el blueprint de la solución en el método JARVIS?

🗺️ Resumen del módulo

✓
Del problema al diseño — la arquitectura es un diseño de flujo, no código; diseñar antes evita rehacer el trabajo.
✓
Canales y enrutamiento — la puerta de entrada y la decisión de enviar cada solicitud al componente correcto.
✓
Servicios y agentes — bloques de capacidad y trabajadores; cada componente hace bien una cosa.
✓
Herramientas necesarias — sirven a la intención; solo lo mínimo que el flujo realmente necesita.
✓
Reglas y seguridad — los muros se incorporan al diseño en el punto donde el riesgo es alto.
✓
El blueprint — reúne todo lo del Día 1 y el Día 2 en un diseño que cabe en una hoja y guía el prototipo.

Siguiente módulo:

3.4 — Prototipo funcional: pasar del blueprint a construir algo que funciona de verdad.