You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Regenerate pt_BR and es translations from current English source
Previous translations had structural drift from the English source
(extra content, missing steps, wrong agent names). Regenerated all
workshop markdown and README translations to be faithful 1:1 translations
with identical structure, headings, code blocks, and URLs.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|[**04**](https://copilot-dev-days.github.io/agent-lab-python/docs/step.html?step=04-multi-agent)| Desarrollo Multi-Agente |
19
19
20
-
> 📝 Las guías del lab también están disponibles en la carpeta [`workshop/es/`](workshop/es/) para lectura offline.
20
+
> 📝 Las guías del laboratorio también están disponibles en la carpeta [`workshop/`](workshop/) para lectura sin conexión.
21
21
22
22
---
23
23
24
-
## Requisitos Previos
25
-
26
-
-[Python 3.13](https://www.python.org/downloads/) o superior
27
-
-[uv](https://docs.astral.sh/uv/) gestor de paquetes
28
-
29
-
## Configuración
30
-
31
-
```bash
32
-
uv sync
33
-
```
34
-
35
-
## Ejecutar
36
-
37
-
```bash
38
-
uv run uvicorn app.main:app --reload
39
-
```
40
-
41
-
Luego abre http://localhost:8000 en tu navegador.
42
-
43
-
## Pruebas
44
-
45
-
```bash
46
-
uv run pytest
47
-
```
48
-
49
-
## Lint
50
-
51
-
```bash
52
-
uv run ruff check .
53
-
uv run ruff format .
54
-
```
24
+
## 🚀 Primeros Pasos
55
25
56
-
Se despliega automáticamente a GitHub Pages con cada push a `main`.
26
+
Dirígete a **[Parte 00: Visión General](https://copilot-dev-days.github.io/agent-lab-python/step.html?step=00-overview)** para los requisitos previos e instrucciones de configuración.
|[**04**](https://copilot-dev-days.github.io/agent-lab-python/docs/step.html?step=04-multi-agent)| Desenvolvimento Multi-Agente |
19
19
20
-
> 📝 Os guias do lab também estão disponíveis na pasta [`workshop/pt_BR/`](workshop/pt_BR/) para leitura offline.
20
+
> 📝 Os guias do lab também estão disponíveis na pasta [`workshop/`](workshop/) para leitura offline.
21
21
22
22
---
23
23
24
-
## Pré-requisitos
25
-
26
-
-[Python 3.13](https://www.python.org/downloads/) ou superior
27
-
-[uv](https://docs.astral.sh/uv/) gerenciador de pacotes
28
-
29
-
## Configuração
30
-
31
-
```bash
32
-
uv sync
33
-
```
34
-
35
-
## Executar
36
-
37
-
```bash
38
-
uv run uvicorn app.main:app --reload
39
-
```
40
-
41
-
Depois abra http://localhost:8000 no seu navegador.
42
-
43
-
## Testes
44
-
45
-
```bash
46
-
uv run pytest
47
-
```
48
-
49
-
## Lint
50
-
51
-
```bash
52
-
uv run ruff check .
53
-
uv run ruff format .
54
-
```
24
+
## 🚀 Primeiros Passos
55
25
56
-
Deploys automáticos para GitHub Pages a cada push no `main`.
26
+
Acesse **[Parte 00: Visão Geral](https://copilot-dev-days.github.io/agent-lab-python/step.html?step=00-overview)** para pré-requisitos e instruções de configuração.
# 🎮 Laboratorio de Agentes de GitHub Copilot en VS Code
3
3
4
-
[🎮 Jugar](https://copilot-dev-days.github.io/agent-lab-python/) • [📚 Guía del Lab](https://copilot-dev-days.github.io/agent-lab-python/docs/) • [← README](../../README.es.md)
4
+
[📚 Guía del Laboratorio](https://copilot-dev-days.github.io/agent-lab-python/docs/) • [← README](../README.md)
5
5
6
6
---
7
7
8
8
> **Duración:**~1 hora
9
9
> **Nivel:** Intermedio
10
10
> **Stack:** Python / FastAPI / Jinja2 / HTMX
11
11
12
-
Bienvenido a Soc Ops — un workshop práctico donde transformarás una aplicación simple de Bingo Social en algo increíble usando el Agent Mode de VS Code con GitHub Copilot.
12
+
Bienvenido a Soc Ops — un taller práctico donde transformarás una aplicación simple de Bingo Social en algo increíble usando Agent Mode de VS Code con GitHub Copilot.
13
13
14
14
---
15
15
16
-
## 📋 Lista Rápida
16
+
## 📋 Lista de Verificación Rápida
17
17
18
18
Antes de comenzar, verifica:
19
19
20
20
-[ ] VS Code **v1.107+** (sin actualizaciones pendientes)
21
-
-[ ] Sesión iniciada con **GitHub Copilot** (Pro, Business o Enterprise)
21
+
-[ ] Sesión iniciada con **GitHub Copilot** (Free, Pro, Business o Enterprise)
22
+
23
+
> ⚠️ **Usuarios del plan gratuito:** Los Cloud Agents no están disponibles en los planes gratuitos de Copilot. El taller proporciona instrucciones alternativas en cada lugar donde se usan Cloud Agents.
22
24
-[ ] Git instalado
23
25
-[ ] Python 3.13 & uv instalados
24
-
-[ ] Panel de Chat abierto y Agente listo
26
+
-[ ] Panel de Chat abierto y Agent listo
25
27
26
28
> 💡 **Consejo:** ¡Usa el DevContainer para un entorno preconfigurado!
27
29
28
30
---
29
31
30
-
## 🎯 Lo que Aprenderás
32
+
## 🎯 Lo Que Aprenderás
31
33
32
34
| # | Habilidad | Descripción |
33
35
|---|-----------|-------------|
34
-
| 1 |**Ingeniería de Contexto**|Enséñale a la IA sobre tu código base con instrucciones |
35
-
| 2 |**Primitivas Agénticas**| Usa agentes en segundo plano, agentes en la nube y flujos personalizados |
36
-
| 3 |**Desarrollo Design-First**| Deja que la IA itere en la UI mientras tú guías la visión |
37
-
| 4 |**Desarrollo Guiado por Pruebas**| Usa agentes TDD para desarrollo confiable de funcionalidades |
36
+
| 1 |**Context Engineering**|Enseña a la IA sobre tu código base con instrucciones |
37
+
| 2 |**Primitivas Agénticas**| Usa sesiones de Copilot CLI, cloud agents y flujos de trabajo personalizados |
38
+
| 3 |**Desarrollo Orientado al Diseño**| Deja que la IA itere en la interfaz mientras tú guías la visión |
39
+
| 4 |**Desarrollo Guiado por Tests**| Usa agentes TDD para un desarrollo de funcionalidades confiable|
38
40
39
41
---
40
42
41
-
## 📚 Partes del Lab
43
+
## 📚 Partes del Laboratorio
42
44
43
45
| Parte | Título | Tiempo | Descripción |
44
46
|-------|--------|--------|-------------|
45
-
|[**01**](01-setup.md)| Configuración & Ingeniería de Contexto | 15 min | Clona, configura y enséñale a la IA sobre tu proyecto |
46
-
|[**02**](02-design.md)| Frontend Design-First | 15 min | Rediseña la UI con temas creativos |
47
+
|[**01**](01-setup.md)| Configuración y Context Engineering | 15 min | Clona, configura y enseña a la IA sobre tu proyecto |
48
+
|[**02**](02-design.md)|Desarrollo Frontend Orientado al Diseño | 15 min | Rediseña la interfaz con temas creativos |
47
49
|[**03**](03-quiz-master.md)| Quiz Master Personalizado | 10 min | Crea tus propios temas de quiz con agentes personalizados |
48
50
|[**04**](04-multi-agent.md)| Desarrollo Multi-Agente | 20 min | Construye nuevas funcionalidades con TDD y agentes de diseño |
49
51
50
52
---
51
53
52
-
## 💡 Consejos
54
+
## 💡 Consejos Pro
53
55
54
-
1.**Mantén el navegador abierto** — Observa las actualizaciones en tiempo real mientras programas
55
-
2.**Haz commits frecuentemente** — Guarda estados funcionales con frecuencia
56
-
3.**Usa checkpoints** — Revierte cambios inesperados con Checkpoints & Undo del chat
56
+
1.**Mantén el navegador abierto** — Observa las actualizaciones en vivo mientras programas
57
+
2.**Haz commit con frecuencia** — Guarda estados funcionales frecuentemente
58
+
3.**Usa checkpoints** — Revierte cambios inesperados con Checkpoints y Deshacer del chat
57
59
4.**📌 Fija esta guía** — Mantenla visible mientras trabajas
2. Haz clic en **Use this template** → **Create a new repository**
20
20
- Nombre: `my-soc-ops-python`
21
21
- Visibilidad: **Public**
22
22
3. ✅ ¡Tu propio repositorio de Soc Ops está listo!
23
23
24
-
### Paso 2: Activa GitHub Pages
24
+
### Paso 2: Elige Cómo Abrir Tu Repositorio
25
25
26
-
1. Ve a **Settings** → **Pages** de tu repositorio
27
-
2. En "Build and deployment", selecciona **GitHub Actions**
28
-
3. ✅ Cada commit ahora se publicará en: `https://{username}.github.io/{repo-name}`
26
+
Este repositorio incluye un devcontainer listo para usar (`.devcontainer/devcontainer.json`), así que puedes trabajar localmente o en Codespaces.
29
27
30
-
###Paso 3: Clona & Abre en VS Code
28
+
#### Opción A: Clonar y Abrir en VS Code Local
31
29
32
30
1. Abre VS Code
33
31
2. Ejecuta el comando: `Git: Clone` → `Clone from GitHub`
34
32
3. Selecciona tu nuevo repositorio
35
33
4. Cuando se te solicite, instala las **extensiones recomendadas**
36
34
37
-
### Paso 4: Ejecuta el Agente de Setup
35
+
#### Opción B: Abre Tu Nuevo Repositorio en GitHub Codespaces
36
+
37
+
1. Abre tu repositorio recién creado en GitHub
38
+
2. Haz clic en **Code** → **Codespaces** → **Create codespace on main**
39
+
3. Espera a que la configuración termine (el devcontainer ejecuta `uv sync` automáticamente)
40
+
4. ✅ Puedes comenzar el laboratorio directamente en la experiencia de VS Code en el navegador
41
+
42
+
### Paso 3: Ejecuta el Agente de Configuración (ambas opciones)
38
43
39
44
En el panel de Chat:
40
45
41
46
```
42
47
/setup
43
48
```
44
49
45
-
El agente va a:
46
-
-Detectar tu entorno
47
-
-Instalar las dependencias faltantes
48
-
-Iniciar el servidor de desarrollo
50
+
El agente:
51
+
-Detectará tu entorno
52
+
-Instalará las dependencias faltantes
53
+
-Iniciará el servidor de desarrollo
49
54
50
-
✅ **Éxito:** ¡La aplicación está corriendo en tu navegador!
55
+
> ⚠️ **Codespace en el navegador:** Si estás ejecutando la aplicación dentro de un GitHub Codespace a través del navegador (no VS Code Desktop), los estilos e interacciones (por ejemplo, el botón Start Game) podrían no funcionar correctamente debido a la autenticación de puertos privados. Para solucionarlo:
56
+
> 1. En el panel **Ports** (barra inferior), haz clic derecho en el puerto `8000` → **Port Visibility** → **Public**
57
+
> 2. O abre el Codespace en **VS Code Desktop** (haz clic en el menú hamburguesa `☰` → **Open in VS Code Desktop**)
58
+
59
+
✅ **Éxito:** ¡La aplicación está ejecutándose en tu navegador!
51
60
52
61
---
53
62
54
-
## 📚 Entendiendo la Ingeniería de Contexto
63
+
## 📚 Entendiendo Context Engineering
55
64
56
-
La ingeniería de contexto es cómo le enseñas a la IA sobre tu código base específico. Esto hace que las sugerencias de Copilot sean más precisas y relevantes.
65
+
Context engineering es cómo le enseñas a la IA sobre tu código base específico. Esto hace que las sugerencias de Copilot sean más precisas y relevantes.
57
66
58
-
### Tarea 1: Generar Instrucciones de Workspace
67
+
### Tarea 1: Generar Instrucciones del Workspace
59
68
60
69
Las instrucciones guían todas las interacciones agénticas, haciéndolas eficientes y confiables.
61
70
62
71
**Pasos:**
63
72
64
-
1.Ejecuta el comando: `Chat: Generate Workspace Instructions File`
73
+
1.Abre la Paleta de Comandos (`Ctrl+Shift+P` / `Cmd+Shift+P`) y ejecuta: `Chat: Generate Agent Instructions`
65
74
2. Espera a que el agente analice tu código base
66
75
3. Revisa las instrucciones generadas (¡probablemente demasiado detalladas!)
67
76
4. Continúa con:
@@ -71,62 +80,77 @@ Las instrucciones guían todas las interacciones agénticas, haciéndolas eficie
71
80
```
72
81
5.**Haz commit** del archivo de instrucciones
73
82
74
-
✅ **Resultado:** Todas las solicitudes futuras tendrán un mapa básico de tu workspace.
83
+
✅ **Resultado:** Todas las solicitudes futuras tienen un mapa básico de tu workspace.
75
84
76
85
---
77
86
78
-
### Tarea 2: Agentes en Segundo Plano para Trabajo Paralelo
87
+
### Tarea 2: Copilot CLI y Cloud Agents para Trabajo en Paralelo
79
88
80
-
Los agentes en segundo plano corren en worktrees git aisladas — perfectos para tareas que no necesitan supervisión.
89
+
Las sesiones de Copilot CLI se ejecutan en git worktrees aislados, lo cual es perfecto para tareas que no necesitan supervisión constante.
81
90
82
-
**Pasos:**
91
+
> 💡 **Tres controles de interfaz que debes conocer:**
92
+
> -**Nueva sesión (`+`)** (parte superior del panel de Chat) — crea un **New Chat**, **New Chat Editor**, **New Chat Window** o **New Copilot CLI Session**
93
+
> -**Menú desplegable de modo de chat** (parte inferior izquierda de la entrada del chat, muestra **Agent** por defecto) — elige un modo (**Agent**, **Ask**, **Plan**) o un agente personalizado
94
+
> -**Menú desplegable de tipo de sesión** (parte inferior izquierda de la entrada del chat, muestra **Local** por defecto) — delega o ejecuta en un entorno diferente: **Local**, **Copilot CLI** o **Cloud**
83
95
84
-
1. Haz clic en `+` en Chat → **New background agent**
85
-
2. Escribe:
96
+
**Inicia una sesión de Copilot CLI:**
97
+
98
+
1. En el **menú desplegable de tipo de sesión** (parte inferior izquierda, muestra **Local**), selecciona **Copilot CLI**
99
+
2. Ingresa:
86
100
```
87
101
Add linting rules with ruff for unused vars and type hints; fix any errors
88
102
```
89
-
3.Déjalo correr, luego **Revisa** y **Aplica** los cambios
103
+
3.Deja que se ejecute, luego **Revisa** y **Aplica** los cambios
90
104
4. Haz clic derecho en la sesión para eliminarla cuando termines
91
105
92
-
**Prueba también un Agente en la Nube:**
106
+
**Inicia un Cloud Agent o sesión de Copilot CLI:**
93
107
94
-
1. Haz clic en `+` → **New cloud agent**
95
-
2. Escribe:
96
-
```
97
-
Make the README more engaging as a landing page to the project
98
-
```
108
+
> **Si tienes Copilot Pro, Business o Enterprise:**
109
+
>
110
+
> 1. En el **menú desplegable de tipo de sesión** (parte inferior izquierda), selecciona **Cloud**
111
+
> 2. Ingresa:
112
+
> ```
113
+
> Make the README more engaging as a landing page to the project
114
+
> ```
115
+
116
+
> **Si estás en el plan gratuito (sin acceso a Cloud):**
117
+
>
118
+
> 1. En el **menú desplegable de tipo de sesión** (parte inferior izquierda), selecciona **Copilot CLI**
119
+
> 2. Ingresa:
120
+
> ```
121
+
> Make the README more engaging as a landing page to the project
122
+
> ```
99
123
100
-
✅ **Resultado:** Reglas de linting agregadas, errores corregidos, README mejorado — ¡todo fusionado de vuelta a main!
124
+
✅ **Resultado:** Reglas de linting agregadas, errores corregidos, README mejorado -- ¡todo sin interrumpir tu workspace principal!
101
125
102
126
---
103
127
104
-
### Tarea 3: Explora Instrucciones Existentes
128
+
### Tarea 3: Explorar Instrucciones Existentes
105
129
106
130
Tu repositorio viene con instrucciones preconfiguradas que ayudan a la IA a entender el proyecto.
0 commit comments