Tutorial
Tu primera tarea con un agente
Pásale un cambio a un agente de programación, sigue cada paso que da, responde lo que pregunte y luego revisa y confirma el resultado. Unos quince minutos.
Antes de empezar
Una tarea corre en un agente de programación que ya usas, como Claude Code o Codex, instalado y con sesión iniciada en esta computadora. Deska no ejecuta un modelo propio para las tareas: el agente trabaja con tu cuenta y tu plan.
Abre Ajustes → Agentes (Cmd/Ctrl,) para revisarlo. Cada agente en Agentes conectados muestra su cuenta cuando tiene la sesión iniciada, y Las tareas nuevas usan elige el agente con el que arranca una tarea nueva. Despliega un agente para instalarlo, iniciar sesión o hacer una comprobación.
Abre primero un proyecto (consulta Tu primer proyecto): el agente trabaja en esa carpeta.
1. Describe la tarea
Haz clic en Nueva tarea al final de la ruta, o pulsa Cmd/CtrlI. Escribe lo que quieres como se lo pedirías a un colega: qué está mal o qué falta, y cómo sabrás que quedó bien.
- La ficha del modelo (aquí Sonnet 5.5) elige el agente y el modelo de esta tarea.
- Construir deja que el agente edite archivos. Cámbialo a Plan (o pulsa ShiftTab) y el agente investiga y propone un plan primero, sin tocar nada.
- La ficha de ajustes (aquí Acceso total, el valor por defecto) define qué puede hacer el agente sin preguntar: Supervisado pregunta antes de actuar, Aceptar ediciones y Auto preguntan menos, y Acceso total nunca pregunta.
- La ficha de rama (main) indica dónde corre la tarea: el checkout en el que estás o un worktree nuevo solo para ella. Consulta Tareas en paralelo.
- El micrófono dicta el pedido en lugar de escribirlo.
Pulsa Empezar o Enter.
2. Sigue el trabajo
La tarea se abre como un hilo. Tu pedido queda arriba y, en orden, todo lo que hace el agente: lo que lee, lo que edita, los comandos que ejecuta y lo que te va diciendo. La cabecera muestra el agente, en qué estado va la tarea (aquí Listo), la rama y cuántos archivos cambiaron.
¿Quieres algo distinto? Escribe en Escríbele a este agente…, abajo, y envía un seguimiento; el agente conserva toda la conversación. Puedes cerrar el panel cuando quieras: la tarea sigue corriendo y se queda en la Bandeja.
3. Responde cuando pregunte
Según su modo, un agente se detiene a preguntar antes de ejecutar un comando o cambiar algo. El hilo muestra exactamente qué quiere hacer y espera por ti.
- Aprobar una vez deja correr esta acción.
- Permitir siempre en esta sesión hace que no vuelva a preguntar por el mismo tipo de acción en esta sesión.
- Rechazar rechaza esta acción; Cancelar turno detiene el turno por completo.
A veces el agente necesita que decidas algo. Una pregunta llega con sus opciones; elige una o escribe tu propia respuesta.
4. Revisa y confirma
Cuando el agente termina, abre Control de código desde la columna Herramientas, a la derecha. Cambios lista cada archivo que cambió, con las líneas agregadas y quitadas; haz clic en un archivo para leer su diff.
- Prepara lo que quieres conservar: + en un archivo, o Preparar todo.
- Escribe el mensaje del commit, o pulsa Generar mensaje para que tu agente redacte uno a partir del diff.
- Pulsa Commit. Después, Publicar rama manda una rama nueva a tu servicio de git; cuando ya está ahí, el botón dice Push. La flecha junto a Commit hace las dos cosas en un solo paso (Commit y push).
¿No te convence un cambio? Descartar en un archivo descarta sus cambios después de que confirmas, o mándale un seguimiento al agente desde el hilo.
5. Sigue todo desde la Bandeja
Cada tarea que empiezas llega a la Bandeja. La ficha de abajo a la derecha dice cuántas tareas te necesitan; haz clic para ver la lista corta, con pestañas para Te necesita, Trabajando y Listo.
Abrir la bandeja muestra el tablero completo, agrupado por lo que cada tarea necesita de ti: Te necesita, Trabajando, Listo e Inactivo. Los botones de alcance lo limitan a este worktree, a este proyecto o a todo, y Filtrar elige estados y agentes.
Pulsa Cmd/CtrlShiftJ para saltar directo a la siguiente tarea que te necesita. Más en Hilos de agente.