Capitulo 5: Agentes Built-in

< Volver al Indice del Tutorial

OpenCode incluye 7 agentes integrados: 4 visibles que puedes invocar directamente y 3 ocultos que corren automaticamente en segundo plano. Cada uno tiene un rol especifico y un conjunto de herramientas adaptado a su proposito.

Arquitectura de Agentes

OpenCode organiza sus agentes en dos categorias:

• Agentes primarios: Build y Plan. Son los que usas directamente en la conversacion principal.
• Subagentes: General y Explore. Se invocan desde un agente primario mediante @mention.
• Agentes ocultos: Compaction, Title y Summary. Corren de forma transparente sin intervencion del usuario.

Agentes Primarios

Build (Default)

Build es el agente principal y el que se activa por defecto al iniciar OpenCode. Tiene acceso completo a todas las herramientas: lectura, escritura, edicion, ejecucion de comandos, busqueda y mas.

Cuando usarlo:

• Desarrollo activo de funcionalidades
• Corregir bugs
• Refactorizar codigo
• Cualquier tarea que requiera modificar archivos

Build puede leer, escribir, ejecutar comandos shell, buscar en el codebase y hacer todo lo necesario para completar una tarea de desarrollo.

Plan

Plan es un agente restringido disenado para analisis y planificacion. No puede modificar archivos. Solo tiene acceso a herramientas de lectura y busqueda.

Cuando usarlo:

• Disenar una arquitectura antes de implementarla
• Analizar un codebase desconocido
• Evaluar opciones y tradeoffs
• Crear planes de trabajo sin riesgo de modificar nada

Plan es ideal cuando necesitas pensar antes de actuar. Al no poder modificar nada, puedes explorar ideas con total seguridad.

Cambiar entre Build y Plan

Presiona Tab para alternar entre los agentes Build y Plan. El indicador en la interfaz muestra cual esta activo.

Tab  →  Cambia entre Build y Plan

Este flujo es natural: planificas con Plan, cambias a Build para implementar, y vuelves a Plan si necesitas replantear algo.

Subagentes

Los subagentes se invocan desde un agente primario usando la sintaxis @mention. Se ejecutan como una conversacion hija con su propio contexto.

General

General es un subagente con acceso completo a todas las herramientas, similar a Build. Esta disenado para tareas complejas de multiples pasos que requieren investigacion y ejecucion.

Invocar:

@general investiga como funciona el sistema de autenticacion y crea un diagrama

Cuando usarlo:

• Investigacion profunda que requiere leer multiples archivos
• Tareas de multiples pasos donde quieres delegar trabajo
• Ejecucion paralela: puedes lanzar varios @general al mismo tiempo

Explore

Explore es un subagente de solo lectura optimizado para velocidad. No puede modificar archivos ni ejecutar comandos destructivos.

Invocar:

@explore encuentra todos los archivos que usan la funcion calculateTotal

Cuando usarlo:

• Busqueda rapida en el codebase
• Explorar la estructura de un proyecto
• Encontrar patrones, dependencias o usos de funciones
• Cuando no necesitas modificar nada y quieres respuestas rapidas

Navegacion entre Sesiones

Cuando invocas un subagente, se crea una sesion hija. Puedes navegar entre la sesion padre y las sesiones hijas:

Leader + Right  →  Ir a la sesion hija
Leader + Left   →  Volver a la sesion padre

Esto te permite revisar el trabajo del subagente sin perder el contexto de tu conversacion principal.

Agentes Ocultos (Hidden)

Estos agentes corren automaticamente en segundo plano. No los invocas directamente, pero son fundamentales para el funcionamiento de OpenCode.

Compaction

Se activa cuando la ventana de contexto se llena. Comprime el historial de la conversacion manteniendo la informacion esencial y descartando lo redundante. Esto permite conversaciones largas sin perder contexto critico.

Title

Genera automaticamente un titulo descriptivo para cada sesion de conversacion. Se ejecuta despues de los primeros intercambios para nombrar la sesion de forma significativa.

Summary

Crea resumenes de sesiones completadas. Util para revisar despues que se hizo en cada conversacion sin tener que releer todo el historial.

Tabla Resumen

Agente	Tipo	Herramientas	Caso de Uso
Build	Primario (default)	Todas	Desarrollo activo, escribir y modificar codigo
Plan	Primario	Solo lectura/busqueda	Analizar, disenar, planificar sin modificar
General	Subagente	Todas	Investigacion multi-step, tareas complejas delegadas
Explore	Subagente	Solo lectura	Busqueda rapida, explorar codebase
Compaction	Oculto	Interno	Comprimir contexto en conversaciones largas
Title	Oculto	Interno	Nombrar sesiones automaticamente
Summary	Oculto	Interno	Resumir sesiones completadas

Flujo de Trabajo Recomendado

1. Inicia en Plan para analizar el problema y disenar la solucion
2. Cambia a Build con Tab para implementar
3. Delega con @general tareas complejas de investigacion
4. Usa @explore para busquedas rapidas sin salir de tu flujo
5. Deja que Compaction maneje el contexto en sesiones largas

Este modelo de agentes permite separar claramente las fases de pensamiento y ejecucion, reduciendo errores y mejorando la calidad del codigo generado.

---

Siguiente: Capitulo 6: Agentes Custom —>