Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions docs/00-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,8 +76,8 @@ For the workshop, we strongly recommend using GitHub Codespaces to save time set
You might see a message like the one below:

```text
You don't have write access to the Azure-Samples/maf-workshop-in-a-day-ko repository, so you cannot push changes to it.
To obtain write access we will point this codespace at your fork of Azure-Samples/maf-workshop-in-a-day-ko, creating that fork if it doesn't exist.
You don't have write access to the Azure-Samples/multi-agent-orchestration-workshop repository, so you cannot push changes to it.
To obtain write access we will point this codespace at your fork of Azure-Samples/multi-agent-orchestration-workshop, creating that fork if it doesn't exist.

Would you like to proceed?
```
Expand All @@ -93,10 +93,10 @@ For the workshop, we strongly recommend using GitHub Codespaces to save time set
This time, you should see the following four lines.

```text
origin https://github.com/{{YOUR_GITHUB_ID}}/maf-workshop-in-a-day-ko.git (fetch)
origin https://github.com/{{YOUR_GITHUB_ID}}/maf-workshop-in-a-day-ko.git (push)
upstream https://github.com/Azure-Samples/maf-workshop-in-a-day-ko (fetch)
upstream https://github.com/Azure-Samples/maf-workshop-in-a-day-ko (push)
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (fetch)
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (push)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (fetch)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (push)
```

If you don't see those four lines, delete and recreate the GitHub Codespaces instance.
Expand Down Expand Up @@ -174,10 +174,10 @@ If you already have a GitHub Codespaces instance, skip this section and go direc
You should see the following four lines.

```text
origin https://github.com/{{YOUR_GITHUB_ID}}/maf-workshop-in-a-day-ko.git (fetch)
origin https://github.com/{{YOUR_GITHUB_ID}}/maf-workshop-in-a-day-ko.git (push)
upstream https://github.com/Azure-Samples/maf-workshop-in-a-day-ko (fetch)
upstream https://github.com/Azure-Samples/maf-workshop-in-a-day-ko (push)
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (fetch)
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (push)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (fetch)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (push)
```

1. Open the repository in VS Code.
Expand Down
65 changes: 65 additions & 0 deletions localization/es-es/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Taller de Orquestación Multi-Agente

Este es material de taller para construir aplicaciones multi-agente basadas en .NET utilizando [Microsoft Agent Framework](https://aka.ms/agent-framework), [Microsoft Foundry](https://aka.ms/microsoft-foundry), y [Aspire](https://aspire.dev).

![Taller MAF + Foundry](../../images/hero.jpg)

## ¿Para qué es este taller?

Construir una aplicación de un solo agente es fácil. Sin embargo, hay muchos casos de uso del mundo real que requieren múltiples agentes trabajando juntos, y construir una aplicación multi-agente no es tan simple como construir una de un solo agente. [Microsoft Agent Framework](https://aka.ms/agent-framework) ofrece cinco patrones de orquestación multi-agente:

| Patrón | Descripción |
|----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
| [Secuencial](https://learn.microsoft.com/agent-framework/workflows/orchestrations/sequential?pivots=programming-language-csharp) | Los agentes se ejecutan uno tras otro en un orden definido |
| [Concurrente](https://learn.microsoft.com/agent-framework/workflows/orchestrations/concurrent?pivots=programming-language-csharp) | Los agentes se ejecutan en paralelo |
| [Handoff](https://learn.microsoft.com/agent-framework/workflows/orchestrations/handoff?pivots=programming-language-csharp) | Los agentes transfieren el control entre sí según el contexto |
| [Group Chat](https://learn.microsoft.com/agent-framework/workflows/orchestrations/group-chat?pivots=programming-language-csharp) | Los agentes colaboran en una conversación compartida |
| [Magentic](https://learn.microsoft.com/agent-framework/workflows/orchestrations/magentic?pivots=programming-language-python) | Un agente administrador coordina dinámicamente agentes especializados |

## Características

En este taller, construimos todos los patrones de orquestación multi-agente excepto el patrón Magentic. Una vez que complete cada patrón, tendrá la siguiente arquitectura:

- Frontend [Blazor](https://blazor.net) para la interfaz de chat
- Backend [ASP.NET](https://asp.net) con [Microsoft Agent Framework](https://aka.ms/agent-framework)
- [Microsoft Foundry Agent Service](https://aka.ms/microsoft-foundry/agent-service) para el alojamiento de agentes
- [Aspire](https://aspire.dev) para la orquestación de aplicaciones nativas en la nube

> [!NOTE]
> La versión .NET del SDK de Microsoft Agent Framework admitirá el patrón Magentic en una próxima versión.

## Requisitos previos

- [Suscripción de Azure (gratuita)](http://azure.microsoft.com/free)
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) o superior
- [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) o [VS Code](https://code.visualstudio.com/download) + [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
- [Docker Desktop](https://docs.docker.com/desktop/) o equivalente
- [GitHub CLI](https://cli.github.com)
- [Azure Developer CLI](https://learn.microsoft.com/azure/developer/azure-developer-cli/install-azd)
- [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli)
- [Aspire CLI](https://aspire.dev/get-started/install-cli/)

## Sesiones del taller

| Sesión | Documento | Ejemplo de código |
|---------------------------|-------------------------------------------------------------|----------------------------------------------------------|
| 00 Configuración | [00-setup.md](./docs/00-setup.md) | |
| 01 Patrón Secuencial | [01-sequential-pattern.md](./docs/01-sequential-pattern.md) | [01-sequential-pattern](./samples/01-sequential-pattern) |
| 02 Patrón Concurrente | [02-concurrent-pattern.md](./docs/02-concurrent-pattern.md) | [02-concurrent-pattern](./samples/02-concurrent-pattern) |
| 03 Patrón Handoff | [03-handoff-pattern.md](./docs/03-handoff-pattern.md) | [03-handoff-pattern](./samples/03-handoff-pattern) |
| 04 Patrón Group Chat | [04-group-chat-pattern.md](./docs/04-group-chat-pattern.md) | [04-group-chat-pattern](./samples/04-group-chat-pattern) |

## ¡Use su idioma preferido!

Este material de taller está disponible en los siguientes idiomas.

[English](../../README.md) | [Español](./README.md) | [日本語](../ja-jp/README.md) | [한국어](../ko-kr/README.md) | [Português](../pt-br/README.md) | [中文(简体)](../zh-cn/README.md)

## Recursos

- [Microsoft Agent Framework](https://aka.ms/agent-framework)
- [Microsoft Agent Framework - Workflow Orchestrations](https://learn.microsoft.com/agent-framework/workflows/orchestrations)
- [Microsoft Foundry](https://aka.ms/microsoft-foundry)
- [Microsoft Foundry Agent Service](https://aka.ms/microsoft-foundry/agent-service)
- [Model Context Protocol (MCP)](https://modelcontextprotocol.io)
- [Aspire](https://aspire.dev)
215 changes: 215 additions & 0 deletions localization/es-es/docs/00-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,215 @@
# 00 Configuración

En esta sesión, configuraremos un entorno de desarrollo ya sea en su máquina o en GitHub Codespaces.

## Requisitos previos

- Navegador web: [Microsoft Edge](https://microsoft.com/edge) o [Google Chrome](http://chrome.google.com)
- [Suscripción de Azure](https://azure.microsoft.com/free)

## Configuración en GitHub Codespaces

Para el taller, recomendamos encarecidamente usar GitHub Codespaces para ahorrar tiempo configurando su entorno de desarrollo. Si prefiere configurar el entorno de desarrollo en su máquina local, omita esta sección y vaya a la sección [Configuración en VS Code](#configuración-en-vs-code).

1. Haga clic en el botón de abajo para crear una nueva instancia de GitHub Codespaces.

[![Crear una nueva instancia de GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/Azure-Samples/multi-agent-orchestration-workshop)

1. Una vez creada, ejecute los siguientes comandos para verificar que las herramientas necesarias estén correctamente instaladas.

```bash
# .NET SDK
dotnet --list-sdks

# node.js
node --version
npm --version

# PowerShell
pwsh --version

# Docker
docker info

# GitHub CLI
gh --version

# azd CLI
azd version

# az CLI
az --version
az bicep version

# Aspire CLI
aspire --version
```

1. Verifique su estado de inicio de sesión en GitHub.

```bash
gh auth status
```

1. Obtenga los detalles del repositorio remoto.

```bash
git remote -v
```

Debería ver lo siguiente.

```text
origin https://github.com/Azure-Samples/multi-agent-orchestration-workshop.git (fetch)
origin https://github.com/Azure-Samples/multi-agent-orchestration-workshop.git (push)
```

Si no ve esas dos líneas, elimine la instancia actual de GitHub Codespaces y créela nuevamente.

1. Dado que la instancia de GitHub Codespaces NO está bajo su cuenta, haga un fork del repositorio para transferir la propiedad usando los siguientes comandos.

```bash
git remote -v > remote.txt
git add . && git commit -m "Add remote.txt for forking"
```

Podría ver un mensaje como el siguiente:

```text
You don't have write access to the Azure-Samples/multi-agent-orchestration-workshop repository, so you cannot push changes to it.
To obtain write access we will point this codespace at your fork of Azure-Samples/multi-agent-orchestration-workshop, creating that fork if it doesn't exist.

Would you like to proceed?
```

Ingrese `y` para continuar. Automáticamente se hará un fork del repositorio bajo su cuenta.

1. Verifique el estado del repositorio remoto.

```bash
git remote -v
```

Esta vez, debería ver las siguientes cuatro líneas.

```text
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (fetch)
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (push)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (fetch)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (push)
```

Si no ve esas cuatro líneas, elimine y vuelva a crear la instancia de GitHub Codespaces.

## Configuración en VS Code

Si ya tiene una instancia de GitHub Codespaces, omita esta sección y vaya directamente a la sección [Iniciar sesión en Azure](#iniciar-sesión-en-azure).

1. Instale las siguientes herramientas en su máquina.

- [VS Code](https://code.visualstudio.com/download) + [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
- [Docker Desktop](https://docs.docker.com/desktop/) o equivalente
- [GitHub CLI](https://cli.github.com)
- [Azure Developer CLI](https://learn.microsoft.com/azure/developer/azure-developer-cli/install-azd)
- [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli)
- [Aspire CLI](https://aspire.dev/get-started/install-cli/)

Luego, ejecute los siguientes comandos para verificar que estén correctamente instalados.

```bash
# .NET SDK
dotnet --list-sdks

# Docker
docker info

# GitHub CLI
gh --version

# azd CLI
azd version

# az CLI
az --version
az bicep version

# Aspire CLI
aspire --version
```

### Iniciar sesión en GitHub

1. Inicie sesión en GitHub.

```bash
gh auth login
```

Una vez que haya iniciado sesión, ejecute el siguiente comando para verificar el estado de inicio de sesión.

```bash
gh auth status
```

### Clonar el proyecto

1. Haga un fork de este repositorio en su máquina local.

```bash
gh repo fork Azure-Samples/multi-agent-orchestration-workshop --clone
```

1. Navegue al directorio clonado.

```bash
cd multi-agent-orchestration-workshop
```

1. Verifique el estado del repositorio remoto.

```bash
git remote -v
```

Debería ver las siguientes cuatro líneas.

```text
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (fetch)
origin https://github.com/{{YOUR_GITHUB_ID}}/multi-agent-orchestration-workshop.git (push)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (fetch)
upstream https://github.com/Azure-Samples/multi-agent-orchestration-workshop (push)
```

1. Abra el repositorio en VS Code.

```bash
code .
```

## Iniciar sesión en Azure

1. Inicie sesión en Azure.

```bash
# Azure Developer CLI
azd auth login

# Azure CLI
az login
```

Una vez que haya iniciado sesión, ejecute el siguiente comando para verificar el estado de inicio de sesión.

```bash
# Azure Develper CLI
azd auth login --check-status

# Azure Login
az account show
```

---

¡Felicitaciones! 🎉 Acaba de completar la configuración del entorno de desarrollo. ¡Continuemos!

👈 [README](../README.md) | [01: Patrón Secuencial](./01-sequential-pattern.md) 👉
Loading