CASO PRÁCTICO DESDE CERO – ORQUESTACIÓN DE AGENTES Y AGENTE PARA GENERAR REUNIONES DE FEEDBACK

---

🎯 Objetivo de la clase

• Comprender qué es la orquestación de agentes y cuándo conviene usarla (frente a un solo agente “monolítico”). [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
• Diferenciar Child agents (subagentes dentro del mismo agente) vs Connected agents (agentes separados/públicados) y cómo diseñarlos sin traslapes. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
• Construir un flujo conversacional con datos (SharePoint), generar una salida estructurada (JSON) con un prompt, y ejecutar una acción real mediante agent flows como herramientas. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

1) 🧠 Orquestación agéntica: concepto y beneficios

¿Qué es?

La orquestación multi‑agente permite que un agente “orquestador” (principal) delegue partes de una solicitud a agentes especializados (subagentes/hijos), mejorando modularidad y mantenimiento. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

Beneficios principales

• ✅ Especialización por dominio: cada agente se enfoca en un área (RH, TI, Finanzas, etc.), mejorando calidad en su nicho. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
• ✅ Escalabilidad organizacional: distintos equipos pueden mantener “su” agente sin chocar en un solo bot compartido. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
• ✅ Un solo punto de entrada (orquestador) con múltiples capacidades detrás, manteniendo buena UX. [learn.microsoft.com], [learn.microsoft.com]

Costos / contras (a tener en cuenta)

• ⚠️ Mayor complejidad de pruebas, trazabilidad y gobernanza: al aumentar piezas (agentes y herramientas), sube la dificultad de evaluar y controlar el sistema. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

2) 🧩 Tipos de arquitectura multi‑agente vistos

A) Child agents (subagentes dentro del agente)

• Son agentes “ligeros” que viven dentro del agente principal.
• Útiles cuando el alcance está acotado y el mismo equipo gestiona todo. [learn.microsoft.com]

B) Connected agents (agentes separados)

• Son agentes independientes, con su propia configuración, herramientas y conocimiento, que el orquestador puede invocar. [learn.microsoft.com], [learn.microsoft.com]
• Requisitos típicos para conectarlos:
  • El agente conectado debe estar publicado.
  • Debe permitir que otros agentes se conecten y el creador debe tener permisos/compartición adecuados. [learn.microsoft.com], [learn.microsoft.com]

📌 Regla clave de diseño enfatizada: la descripción del subagente/agente conectado es crítica para que el orquestador sepa cuándo delegar y no confunda dominios. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

3) 🗂️ Gestión de conocimiento en multi‑agentes (lo importante)

• En lugar de “duplicar” toda la base de conocimiento en el agente padre, se recomienda distribuir el conocimiento en los agentes especializados y dejar al orquestador con:
  • instrucciones generales,
  • descripciones claras de cada subagente,
  • y reglas de enrutamiento (implícitas por metadata). [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

Fuentes de conocimiento mencionadas/relacionadas

• SharePoint como fuente de conocimiento empresariaI (sitios/listas). [learn.microsoft.com], [learn.microsoft.com]
• Documentos (PDF/Word/Excel) como conocimiento, almacenados e indexados en Dataverse para respuestas fundamentadas. [learn.microsoft.com], [learn.microsoft.com]

---

4) 🔧 Demo principal: Agente para reunión de feedback (end‑to‑end)

Objetivo del ejemplo

Construir un agente que:

1. Capture fecha/hora y participantes en lenguaje natural,
2. Consulte una lista de empleados en SharePoint,
3. Genere una lista estructurada (JSON) de correos,
4. Llame un agent flow para crear una reunión en Teams. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

4.1 Datos (SharePoint)

• Se definió SharePoint como “base” de datos del ejemplo (lista simple de empleados con Nombre y Correo).
• Esto alinea el agente con fuentes razonables y fáciles de mantener para la mayoría de organizaciones. [learn.microsoft.com], [learn.microsoft.com]

4.2 Captura conversacional (Topics + Variables)

• Se usaron preguntas para capturar:
  • Fecha y hora (entidad de fecha/hora),
  • Implicados (texto completo).
• Se guardó la información en variables para reutilizarla luego. [learn.microsoft.com], [learn.microsoft.com]

4.3 Prompt para convertir “empleados + implicados” a JSON

• Se utilizó un prompt para pedir salida estructurada (lista de objetos con nombre y correo). [learn.microsoft.com], [learn.microsoft.com]
• Se reforzó que los prompts pueden usarse en un topic o como tool y entregar salida (texto/JSON) que luego se procesa. [learn.microsoft.com], [learn.microsoft.com]

4.4 Parseo y modelado de salida (para usarla como lista)

• Se buscó transformar la salida del prompt (JSON) en una estructura “usable” (tabla/lista) para poder iterar y formar parámetros para el flujo.
• Lección clave: cuando la salida es una lista, el esquema debe reflejarlo; cuando conviene, envolverla en un objeto con una propiedad lista puede simplificar el parseo. (Patrón de “tipado” para que el flujo/tema consuma mejor la estructura). [learn.microsoft.com], [learn.microsoft.com]

Microsoft recomienda pasar datos entre topics, herramientas y flujos mediante variables/inputs/outputs y mantener tipos compatibles. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

4.5 Agent flow: crear reunión como herramienta

• Se creó un agent flow para ejecutar la acción de negocio (crear reunión) y devolver resultados al agente.
• Requisitos clave del flow como tool:
  • trigger When an agent calls the flow,
  • acción Respond to the agent,
  • respuesta sincrónica y dentro del límite de tiempo recomendado. [learn.microsoft.com], [learn.microsoft.com]

---

5) 📌 Recapitulación (qué habilidades se integraron en la sesión)

En esta sesión se “conectaron” varias capacidades vistas en el curso:

• Multi‑agente (orquestador + especialistas). [learn.microsoft.com], [learn.microsoft.com]
• Variables/inputs/outputs para pasar información entre topics y herramientas. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
• Prompts para generar salida estructurada (JSON) en vez de texto libre. [learn.microsoft.com], [learn.microsoft.com]
• Agent flows para ejecutar acciones externas (creación de reunión). [learn.microsoft.com], [learn.microsoft.com]
• SharePoint como fuente de conocimiento/datos empresariales. [learn.microsoft.com], [learn.microsoft.com]

---

❓ Preguntas y respuestas destacadas (con refuerzo oficial)

1) “Tengo 7 dominios en mi empresa, ¿conviene un orquestador + subagentes por dominio?”

✅ Respuesta del docente (síntesis): Sí, un agente general puede enrutar a agentes especializados según el tema (onboarding, gobierno, data, etc.).
🔎 Refuerzo oficial: Microsoft describe patrones de orquestador y subagentes como una forma efectiva de separar dominios y mantener un punto de entrada único. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

2) “¿Debo duplicar la base de conocimiento en el agente padre?”

✅ Respuesta del docente (síntesis): No necesariamente; es mejor que cada subagente tenga su conocimiento y el padre enrute.
🔎 Refuerzo oficial: Para agentes conectados, la recomendación es describir bien el propósito del agente y administrar el traspaso de contexto; el conocimiento puede estar en el agente especializado. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

3) “¿Un agente puede llamar a otro agente? ¿Qué se requiere?”

✅ Respuesta del docente (síntesis): Sí, pero el agente llamado debe estar publicado y habilitado para conectarse.
🔎 Refuerzo oficial: Microsoft establece que para conectar a otro agente de Copilot Studio, este debe estar en el mismo entorno, publicado, y permitir conexiones. [learn.microsoft.com], [learn.microsoft.com]

---

4) “¿Cuándo usar subagentes (child) vs agentes independientes (connected)?”

✅ Respuesta del docente (síntesis):

• Subagentes: para casos pequeños, centrados en conocimiento y con menos control.
• Agentes independientes: cuando necesitas temas, flujos, control y capacidades más completas.
  🔎 Refuerzo oficial: Microsoft diferencia cuándo conviene crear child agents vs conectar agentes separados, considerando gobernanza, reutilización y configuración independiente. [learn.microsoft.com], [learn.microsoft.com]

---

5) “¿Puedo usar el agente para generar una recomendación y enviarla por correo/acción?”

✅ Respuesta del docente (síntesis): Sí, usando un nodo/herramienta de prompt para generar el contenido y un flow/tool para ejecutar la acción (enviar correo, notificar, etc.).
🔎 Refuerzo oficial: Copilot Studio permite crear prompts como herramientas o nodos y combinarlos con tools/flows para acciones operativas. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

✅ Conclusiones

• La sesión consolidó el enfoque “agentic”: dividir por dominios, con un orquestador que decide a qué especialista delegar. [learn.microsoft.com], [learn.microsoft.com]
• La calidad del enrutamiento depende fuertemente de:
  • descripciones claras (metadata) de agentes/skills,
  • minimización de traslapes,
  • y un diseño con responsabilidades únicas. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
• Integrar SharePoint + Prompts + Agent Flows habilita escenarios de productividad reales (como programar reuniones) sin requerir código complejo. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]

---

⭐ Recomendaciones

1. 🧩 Evita traslapes de dominios: si dos agentes “hacen lo mismo” en su descripción, el orquestador puede enrutar mal. Haz descripciones específicas y no redundantes. [learn.microsoft.com], [learn.microsoft.com]
2. 🏷️ Define responsabilidades únicas por agente (single responsibility): mejora mantenibilidad y precisión. [learn.microsoft.com], [learn.microsoft.com]
3. 🔧 Para acciones operativas, prefiere agent flows como tools, con inputs/outputs definidos y tiempos de respuesta controlados. [learn.microsoft.com], [learn.microsoft.com], [learn.microsoft.com]
4. 🧠 Si necesitas salida estructurada, usa prompts con especificación de formato y valida esquema antes de iterar datos. [learn.microsoft.com], [learn.microsoft.com]
5. 🚀 Publica y versiona: los cambios a agentes conectados solo se consumen correctamente tras publicación y buena gestión de descripciones localmente. [learn.microsoft.com], [learn.microsoft.com]

---

📚 Referencias oficiales

• Add other agents overview [learn.microsoft.com]
• Explore multi-agent orchestration patterns [learn.microsoft.com]
• Orchestrator and subagent multi-agent patterns [learn.microsoft.com]
• Connect to an existing Copilot Studio agent [learn.microsoft.com]
• Add tools to custom agents [learn.microsoft.com]
• Use prompts to make your agent perform tasks [learn.microsoft.com]
• Add SharePoint as a knowledge source [learn.microsoft.com]
• Work with variables [learn.microsoft.com]
• Use input and output variables to pass information (agent flows) [learn.microsoft.com]
• Create an agent flow as a tool [learn.microsoft.com]
• Add an agent flow or workflow as a tool to an agent [learn.microsoft.com]
• Publish and deploy your agent (key concepts) [learn.microsoft.com]