95e0f34d31
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese, French and German (18 pages each), mirroring the existing en/ru structure. - generate the 5 new locales in config.ts from a single strings table (nav, sidebar, search, footer, docFooter, outline, editLink) with locale-prefixed links - rework DocsCardGrid from the binary isRu check to a per-locale map so the home cards render translated copy and prefixed links for every locale
106 lines
5.4 KiB
Markdown
106 lines
5.4 KiB
Markdown
---
|
||
title: Crear un equipo – Documentación de Agent Teams
|
||
description: Define roles, asigna proveedores y modelos, redacta un briefing de equipo y configura el aislamiento por worktree y los niveles de autonomía.
|
||
lang: es-ES
|
||
---
|
||
|
||
# Crear un equipo
|
||
|
||
Un equipo es un grupo con nombre de agentes con roles, un lead, un proyecto objetivo y un prompt de coordinación.
|
||
|
||
## Primer equipo recomendado
|
||
|
||
Empieza con un equipo pequeño:
|
||
|
||
| Rol | Propósito |
|
||
| -------- | --------------------------------------------------------- |
|
||
| Lead | Divide el trabajo, crea tareas, coordina a los compañeros |
|
||
| Builder | Implementa tareas acotadas |
|
||
| Reviewer | Revisa el resultado, detecta regresiones, pide correcciones |
|
||
|
||
Esta estructura te da suficiente coordinación para ver el valor del producto sin hacer ruidoso el primer lanzamiento.
|
||
|
||
::: tip
|
||
Puedes añadir más miembros más adelante. Empieza con poco, valida el flujo de trabajo y luego escala.
|
||
:::
|
||
|
||
## Asignar proveedores y modelos
|
||
|
||
Cada miembro del equipo se ejecuta sobre un backend de proveedor. En el editor de equipos, elige un proveedor (Claude, Codex u OpenCode) y un modelo para cada miembro. La aplicación solo muestra los proveedores con los que ya te has autenticado.
|
||
|
||
Se admite mezclar proveedores en un mismo equipo — por ejemplo, un lead de Claude con builders de OpenCode.
|
||
|
||
::: info
|
||
Gemini está disponible como ruta de proveedor compatible. Consulta [Proveedores y runtimes](/es/reference/providers-runtimes) para conocer las opciones de autenticación y el estado actual de los proveedores.
|
||
:::
|
||
|
||
## Redactar un buen briefing de equipo
|
||
|
||
El briefing de equipo debería incluir:
|
||
|
||
- el resultado que quieres
|
||
- los archivos o áreas de funcionalidad que importan
|
||
- los límites de riesgo, como "no refactorizar módulos no relacionados"
|
||
- las expectativas de revisión
|
||
- los comandos de verificación cuando los conozcas
|
||
|
||
Ejemplo:
|
||
|
||
```text
|
||
Build a focused improvement to the download flow. Keep changes inside the landing app unless a shared helper is clearly needed. Create tasks before implementation, review each task diff, and run landing lint/build checks.
|
||
```
|
||
|
||
## Aislamiento por worktree
|
||
|
||
Los miembros de OpenCode pueden usar el **aislamiento por worktree** para trabajar en un worktree de Git independiente en lugar del directorio de trabajo principal. Esto evita conflictos de archivos cuando varios agentes editan el mismo proyecto.
|
||
|
||
::: warning
|
||
El aislamiento por worktree requiere un proyecto rastreado por Git y, actualmente, está limitado a los miembros de OpenCode.
|
||
:::
|
||
|
||
Para activarlo, activa la opción **Worktree isolation** al añadir o editar un miembro de equipo de OpenCode.
|
||
|
||
## Elegir la autonomía
|
||
|
||
Agent Teams admite distintos niveles de control. Usa más autonomía para cambios rutinarios y una revisión más estricta para áreas de riesgo como la autenticación de proveedores, el IPC, la persistencia, los flujos de trabajo de Git y las herramientas de publicación.
|
||
|
||
### Nivel de esfuerzo
|
||
|
||
Cada miembro del equipo tiene un ajuste de **esfuerzo** que controla cuánto razonamiento invierte el proveedor antes de responder. Un esfuerzo mayor produce un resultado más exhaustivo a costa de tiempo y tokens.
|
||
|
||
| Nivel | Cuándo usarlo |
|
||
| ------ | ------------------------------------------------------------- |
|
||
| Low | Consultas rápidas, pequeños cambios de formato, ediciones rutinarias |
|
||
| Medium | Predeterminado para la mayoría de tareas de implementación |
|
||
| High | Refactorizaciones complejas, cambios transversales, rutas de código de riesgo |
|
||
|
||
La aplicación ofrece niveles adicionales (minimal, xhigh, max) para los proveedores que los admiten. Si un modelo no admite un esfuerzo configurable, el selector se desactiva y se usa el valor predeterminado del proveedor.
|
||
|
||
### Modo rápido
|
||
|
||
Activa el **Modo rápido** por miembro para priorizar la velocidad sobre la profundidad. Esto se corresponde con el modo rápido/de velocidad nativo del proveedor cuando está disponible. Ponlo en **On** para tareas rutinarias, en **Off** para trabajo cuidadoso, o en **Inherit** para seguir el valor predeterminado a nivel de equipo.
|
||
|
||
### Limitar el contexto
|
||
|
||
Activa **Limit context** para reducir la ventana de contexto de un miembro. Esto es útil para los modelos de Claude que admiten contexto extendido (p. ej. 1M de tokens) — limitar el contexto evita un uso innecesario de tokens y puede mejorar la latencia en tareas que no necesitan un contexto amplio.
|
||
|
||
## Añadir contexto
|
||
|
||
Adjunta archivos, capturas de pantalla o notas concretas cuando cambien la tarea de forma sustancial. Los agentes pueden usar las descripciones de las tareas, los comentarios y los archivos adjuntos como contexto duradero.
|
||
|
||
## Vigilar la calidad de las tareas
|
||
|
||
Los buenos equipos crean tareas que son:
|
||
|
||
- lo bastante específicas para revisar
|
||
- lo bastante pequeñas para terminar
|
||
- vinculadas a un resultado visible
|
||
- respaldadas por una ruta de verificación
|
||
|
||
Si el lead crea tareas imprecisas, envía un mensaje directo pidiendo tareas más pequeñas y comprobables.
|
||
|
||
## Próximos pasos
|
||
|
||
- [Configuración del runtime](/es/guide/runtime-setup) — configura la autenticación de proveedores y los modelos
|
||
- [Revisión de código](/es/guide/code-review) — acepta, rechaza o comenta los cambios de los agentes
|
||
- [Solución de problemas](/es/guide/troubleshooting) — problemas habituales y soluciones
|