Despacha tu primer agente

Qué vas a construir

Al terminar este tutorial tendrás:

• Un agente creado y configurado por ti mismo
• Un espacio donde hablas tú y ese agente
• Una ejecución completada, con trabajo confirmado en un worktree aislado y una fila en el registro de ejecuciones del agente

Requisitos previos: Tu primer espacio de trabajo completado, de modo que este espacio de trabajo tenga un repo registrado y al menos un proveedor de modelos conectado.

Paso 1: Crear un agente

1. Ve a Ajustes → Espacio de trabajo → Agentes
2. Haz clic en Nuevo agente. Se crea al instante un agente llamado «Agente sin nombre» y queda seleccionado en la lista de agentes —no hay ningún diálogo de creación ni nada que confirmar—. Lo configuras ahí mismo.
3. En la pestaña Ajustes, rellena:
   • Nombre: algo corto y fácil de recordar, como alice. Es lo que escribes después de @.
   • Título: qué hace, p. ej. «Ingeniero de backend»
   • Adaptador: Control Center (built-in). Elige este a propósito: solo el arnés integrado se puede dirigir a mitad de ejecución y pausar en el límite de un turno, y no necesita ninguna CLI instalada en el host del servidor.
   • Modelo: elige de la lista que sirve el proveedor conectado
   • Habilidades: adjunta las que encajen, p. ej. testing o architecture
4. Pulsa Guardar cambios

Un agente sin adaptador se ejecuta en el bucle integrado

Cuando el campo Adaptador está sin definir, el despacho recurre a Control Center (built-in) —el bucle de agente que vive dentro del servidor, así que no hay nada que instalar en el host—. Aun así necesita un modelo: si no hay ninguno definido, le pide a Anthropic el suyo predeterminado, lo que funciona si has conectado una cuenta de Anthropic y, si no, falla con No credential for provider "anthropic". Define ambos de forma explícita en cualquier caso, o acabarás ejecutando con un modelo que no elegiste.

Comprobación. La fila del agente en la lista muestra su nombre y un anillo de estado hueco.

Paso 2: Iniciar un espacio

1. En la barra lateral, busca la sección Espacios y haz clic en el botón +
2. Ponle un nombre al espacio
3. En Añadir agentes, selecciona el agente que acabas de crear
4. Si el espacio de trabajo tiene repos, elige sobre cuáles debe trabajar este espacio
5. Haz clic en Crear

El espacio se abre. En segundo plano, Control Center aprovisiona un worktree con copy-on-write de los repos seleccionados para esta conversación, en su propia rama. Tu checkout de origen no se modifica nunca.

Paso 3: Enviar una tarea

Escribe una tarea concreta y pequeña contra el repo que registraste. Lo que mejor funciona es algo con un resultado comprobable: añade un test, corrige un aviso del linter, renombra un símbolo.

Pulsa Intro. No hace falta que menciones a nadie con @: con un solo agente en el espacio, un mensaje normal lo despierta. En un espacio con varios agentes, @name elige a uno.

Control Center arma el prompt a partir de las instrucciones, la persona y las skills del agente y el contexto del espacio, y después despacha la ejecución.

Comprobación. El botón de enviar del compositor se convierte en un botón de detener —hay un agente trabajando en esta conversación— y el texto empieza a llegar.

Paso 4: Verlo trabajar

La conversación representa la ejecución a medida que ocurre:

• Razonamiento, mostrado en línea mientras el agente piensa
• Llamadas a herramientas: lecturas y escrituras de archivos, búsquedas, comandos de shell, cada una con su resultado
• Texto: resúmenes, explicaciones y preguntas para ti

Si el agente pregunta algo, respóndele en la conversación y se reanuda.

Para ver las métricas propias de una ejecución y sus controles de pausa, reanudación y detención, busca el agente en ejecución en la sección Agentes del panel General del espacio y elige Abrir actividad.

En el panel de actividad, la insignia de estado dice En ejecución y, cuando la ejecución termina, Completado. Una ejecución que se atasca o entra en bucle dice Bloqueado; una que da error, Fallido. En el registro de agentes, el anillo de la lista está hueco antes de la primera ejecución y relleno cuando el agente vuelve a estar inactivo.

Lo que limita la ejecución: su propio worktree con copy-on-write, las credenciales negociadas para ella al lanzarla y revocadas al desmontar, la sanitización del entorno, la superficie de herramientas que permite su modo y las barandillas de acción. Los efectos como subir una rama o abrir una pull request se someten a control por separado: consulta Barandillas.

Paso 5: Comprobar el resultado

1. Abre Ajustes → Espacio de trabajo → Agentes y selecciona tu agente
2. Abre la pestaña Registros

Comprobación. Una fila de ejecución, con su estado, su duración, sus horas de inicio y fin y el adaptador con el que se ejecutó.

Los cambios del agente quedan confirmados en la rama de la conversación, en su worktree. Los commits se atribuyen al agente, con tu crédito en un trailer Co-Authored-By:.

Conseguir una pull request

Nada abre una pull request por sí solo. Si quieres una, pídela en la misma conversación:

Sube esta rama y abre una pull request contra la rama predeterminada.

El push (gitPush) y la creación de PR (prCreate) piden tu aprobación de forma predeterminada, así que cuenta con una confirmación antes de cada uno. Si no hay ningún aprobador conectado cuando se lanza el aviso, la acción se deniega en lugar de permitirse: las barandillas fallan en cerrado.

La PR se abre con la identidad de GitHub cuyo token usó la ejecución —la tuya, si guardaste un token personal—, no con el nombre del agente. La autoría del agente se ve en los commits.

También puedes abrirla tú: el panel Control de código fuente del espacio tiene un botón Crear petición de extracción que lleva la rama de la conversación a la pantalla de redacción, y Pull requests → Nueva PR abre esa misma pantalla vacía. Ahí es donde continúa el siguiente tutorial.

Resumen

Creaste un agente, configuraste su adaptador y su modelo, le diste un espacio y una tarea y viste terminar una ejecución real en un worktree aislado sin tocar tu checkout.

Siguiente: Revisa tu primera pull request para aprender el flujo de revisión.

Para saber más sobre agentes: El modelo de agentes. Para detalles del despacho: Ciclo de vida del despacho de agentes.