Este workshop guía a los participantes en el diseño e implementación de una arquitectura multi-agente usando servicios de Microsoft, aplicada a un escenario de negocio tipo Contoso Retail. El foco del ejercicio no es construir un sistema productivo, sino entender cómo orquestar agentes con responsabilidades claras para resolver distintos tipos de preguntas de negocio sobre un mismo conjunto de datos.
La arquitectura integra tres capas bien definidas:
- Microsoft Fabric, como fuente de datos: aloja la base SQL de retail y un Data Agent que responde preguntas en lenguaje natural.
- Microsoft Foundry, como capa de razonamiento y ejecución: agentes que generan reportes HTML vía OpenAPI y planifican campañas de marketing consultando la base de datos.
- Copilot Studio, como capa de orquestación y experiencia conversacional: un agente orquestador que conecta todos los agentes, un agente de producto con conocimiento en SharePoint y un agente hijo que envía correos electrónicos.
Observaremos las capacidades de orquestación tanto en Copilot Studio como en Microsoft Foundry.
Contoso es una empresa de retail que vende productos a clientes empresariales y finales. Su modelo de datos incluye información de clientes, cuentas, órdenes, líneas de orden, facturas, pagos, productos y categorías.
Sobre esta base, el negocio necesita responder dos tipos de preguntas frecuentes:
- Preguntas operativas, orientadas a entender qué ocurrió en un caso puntual.
- Preguntas analíticas, orientadas a entender patrones, tendencias y señales del negocio.
El workshop muestra cómo una misma arquitectura puede atender ambos tipos de necesidades sin duplicar sistemas ni lógica.
El flujo operativo responde a solicitudes concretas sobre clientes, órdenes y facturación. En este flujo, el objetivo es reconstruir los hechos transaccionales con precisión y producir artefactos visuales (reportes HTML) que sinteticen la información.
El pipeline implementado funciona así:
- El usuario pide información operativa (p. ej. un reporte de órdenes de un cliente).
- Bill (orquestador) delega a Mark (Fabric) para obtener los hechos transaccionales exactos: órdenes, líneas de orden, montos, fechas, etc.
- Bill delega a Anders (Foundry) para generar un reporte visual a partir de esos datos. Anders invoca la Azure Function
OrdersReportervía su herramienta OpenAPI, la cual construye un reporte HTML y lo sube a Blob Storage. - Anders retorna la URL del reporte publicado y Bill consolida la respuesta al usuario.
Ejemplos de preguntas operativas:
- Genera un reporte de las órdenes de Izabella Celma.
- ¿Cuáles son las órdenes y productos de Marco Rivera?
- Necesito un resumen visual de las compras recientes de un cliente.
El flujo analítico responde a preguntas de carácter estratégico y exploratorio. Aquí el objetivo no es explicar un caso puntual, sino identificar señales relevantes que ayuden a priorizar acciones y generar planes concretos.
En este flujo, Julie (Foundry) actúa como agente orquestador de campañas de marketing, definido como un workflow. Julie coordina un flujo de 5 pasos: (1) extrae el filtro de segmento de clientes del prompt del usuario, (2) invoca a SqlAgent para generar la consulta T-SQL correspondiente, (3) ejecuta el T-SQL contra la base de datos de Fabric vía la herramienta OpenAPI (SqlExecutor de la Azure Function FxContosoRetail), (4) para cada cliente retornado, invoca a MarketingAgent (que usa Bing Search para encontrar eventos relevantes y genera un mensaje de marketing personalizado), y (5) organiza todo como un JSON de campaña de correos electrónicos.
Ejemplos de preguntas analíticas y de planificación:
- Crea una campaña para clientes que hayan comprado bicicletas.
- Planifica una campaña de retención para clientes inactivos.
- Mark (Data Agent)
Data Agent de Fabric que interpreta lenguaje natural y consulta el modelo semántico construido sobre la base SQL
db_retail(tablascustomer,orders,orderline,product). Reconstruye hechos transaccionales exactos y los entrega como datos trazables, sin interpretación.
Para comprender mejor el modelo de datos sobre el cual operan los agentes de Fabric, se ha agregado documentación detallada de la base de datos de Contoso Retail. Esta documentación incluye:
- Diagrama ER (Entidad-Relación) que muestra las relaciones entre las tablas principales
- Esquemas de tablas con todos los campos y tipos de datos
Puedes consultar la documentación completa aquí: Database Documentation
- Anders (Executor Agent)
Ejecuta acciones operativas invocando servicios externos mediante una herramienta OpenAPI. Recibe datos de órdenes y llama al endpoint
OrdersReporterde la Azure FunctionFxContosoRetail, que genera un reporte HTML y lo publica en Blob Storage, retornando la URL del documento. Usa el SDKAzure.AI.Agents.Persistentcon un modelo GPT-4.1 para interpretar la solicitud, construir el payload JSON y orquestar la llamada a la API. - Julie (Planner Agent)
Agente orquestador de campañas de marketing definido como
kind: "workflow". Coordina 3 herramientas: SqlAgent (type: "agent") que genera consultas T-SQL a partir de lenguaje natural, y tiene una Azure Function como tool llamada SqlExecutor (type: "openapi") que ejecuta el SQL contra la base de datos de Fabric. Dicha función también se encuentra en la Function AppFxContosoRetailusada previamente por Anders. Finalmente tenemos al MarketingAgent (type: "agent") que usa Bing Search para encontrar eventos relevantes y genera mensajes de marketing personalizados por cliente. El resultado final es un JSON de campaña con correos electrónicos listos para enviar.
- Charles (Product Q&A Agent) Agente analista de producto que responde preguntas usando documentación almacenada en SharePoint como fuente de conocimiento. También realiza análisis competitivo y comparaciones de mercado usando información pública cuando el usuario lo solicita.
- Bill (Orchestrator) Orquestador central. Detecta la intención del usuario y delega al agente correcto: conecta agentes externos de Fabric (Mark) y Foundry (Anders) y agentes internos de Copilot Studio (Charles, Ric). Se publica en Microsoft 365 y Teams.
- Ric (Child Agent) Agente hijo de Bill responsable de enviar correos electrónicos al usuario con la información solicitada (p. ej., resultados de consultas o reportes).
Al finalizar el workshop, los participantes comprenderán:
- Cómo separar datos, razonamiento y experiencia de usuario.
- Cómo diseñar agentes con responsabilidades bien delimitadas.
- Cómo orquestar flujos operativos y analíticos sobre un mismo dominio de negocio.
- Cómo usar Copilot Studio o Microsoft Foundry como capa central de control en soluciones multi-agente.
Este repositorio sirve como guía práctica y reutilizable para entender y replicar este patrón arquitectónico en escenarios reales.
El workshop está dividido en laboratorios independientes pero conectados, organizados por capa arquitectónica. Se recomienda seguirlos en el orden indicado.
- Lab 1 – Setup del ambiente: capacidad de Fabric, workspace, base SQL y modelo semántico
- Lab 2 – Agente Mark: Data Agent sobre el modelo semántico de retail
- Setup de infraestructura de Foundry
- Lab 3 – Agente Anders: soporte OpenAPI, despliegue de Function App y ejecución del agente executor
- Lab 4 – Agente Julie: workflow agent con sub-agentes SqlAgent y MarketingAgent
- Lab 5 – Setup de Copilot Studio: entorno, solución y publisher
- Lab 6 – Agente Charles: Q&A de producto con SharePoint y análisis de mercado
- Lab 7 – Agente Ric: agente hijo para envío de correos + configuración inicial de Bill
- Lab 8 – Orquestador Bill: conexión de agentes externos (Mark, Anders) e internos (Charles) y reglas de orquestación
- Lab 9 – Publicación de Bill en Microsoft 365 / Teams y pruebas end-to-end
Al finalizar el workshop, los participantes habrán construido y comprendido:
- Cómo diseñar agentes con responsabilidades claras.
- Cómo separar datos, razonamiento y experiencia de usuario.
- Cómo orquestar múltiples agentes desde Copilot Studio.
- Cómo reutilizar el mismo patrón arquitectónico para distintos escenarios de negocio.
Este repositorio sirve como guía práctica y reutilizable para diseñar soluciones multi‑agente en proyectos reales.
- Conocimientos básicos de Azure.
- Familiaridad general con conceptos de datos y analítica.
- No se requiere experiencia previa profunda en Fabric, Foundry o Copilot Studio.
Cada participante debe tener las siguientes herramientas instaladas en su máquina antes de llegar al workshop:
| Herramienta | Descripción | Descarga |
|---|---|---|
| .NET 8 SDK | Compilar y ejecutar las Azure Functions y los agentes de Foundry | Descargar |
| Azure CLI | Autenticarse en Azure, desplegar recursos y asignar roles RBAC | Instalar |
| Azure Functions Core Tools v4 | Publicar Azure Functions a Azure | Instalar |
| PowerShell 7+ | Ejecutar scripts de despliegue de infraestructura. Requerido en todos los OS (incluido Windows). No usar PowerShell 5.1. | Instalar · Windows: winget install Microsoft.PowerShell |
| Git | Clonar el repositorio del taller | Descargar |
| VS Code (recomendado) | Editor de código con extensiones para Azure y .NET | Descargar |
Tip
En macOS, puedes instalar todas las herramientas con Homebrew:
brew install dotnet-sdk azure-cli azure-functions-core-tools@4 powershell git
brew install --cask visual-studio-codeTip
En Linux (Ubuntu/Debian), puedes instalar PowerShell 7 con:
# Instalar PowerShell 7
sudo apt-get update && sudo apt-get install -y wget apt-transport-https software-properties-common
wget -q "https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb"
sudo dpkg -i packages-microsoft-prod.deb && rm packages-microsoft-prod.deb
sudo apt-get update && sudo apt-get install -y powershell
# Otras herramientas
sudo apt-get install -y dotnet-sdk-8.0 azure-cli gitVer instrucciones completas en: Instalar PowerShell en Linux
Tip
En Windows, puedes instalar todas las herramientas con winget:
winget install Microsoft.DotNet.SDK.8 Microsoft.AzureCLI Microsoft.Azure.FunctionsCoreTools Microsoft.PowerShell Git.Git Microsoft.VisualStudioCodeDespués de instalar, verifica que todo esté disponible ejecutando estos comandos en una terminal:
dotnet --version # Debe mostrar 8.x.x
az --version # Debe mostrar azure-cli 2.x.x
func --version # Debe mostrar 4.x.x
pwsh --version # Debe mostrar PowerShell 7.x.x (REQUERIDO en todos los OS)
git --version # Debe mostrar git version 2.x.xPowerShell en Windows puede bloquear la ejecución de scripts por defecto. Ejecuta una sola vez en pwsh:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserEsto permite ejecutar scripts locales y scripts descargados que estén firmados. Solo afecta al usuario actual, no requiere permisos de administrador.
- Una suscripción de Azure activa con permisos de Owner o Contributor
- El nombre del tenant temporal asignado para el workshop (se proporcionará el día del evento)
Este workshop está pensado como un ejercicio pedagógico y arquitectónico. El foco está en el diseño del flujo y la colaboración entre agentes, no en optimizar modelos ni consultas al extremo.