Documentación / El agente

Pedir una tarea

Cómo trabajar con el agente de principio a fin sin perder el control.

Escribe lo que necesitas como se lo dirías a un colega. El agente propone, el IDE controla y tú autorizas.

Antes de empezar

  • Abre el proyecto y espera a que termine el indexado (la barra superior del editor lo indica). Puedes escribir mientras tanto.
  • Conecta una IA: tu suscripción o una API key. Ver Conectar una IA.
  • Muestra el chat con Ctrl+Alt+I si está oculto. Desde el editor, Ctrl+L lleva el foco al chat.

1. Describe el resultado

Di qué quieres y cómo sabrás que está bien.

En lugar de… Escribe…
«Arregla el login» «El login falla con usuarios que tienen tilde en el correo. Corrígelo y agrega una prueba que lo cubra.»
«Haz un endpoint» «Agrega GET /api/orders/{id} que devuelva 404 si no existe. Sigue el estilo de ProductController.»

Puedes adjuntar archivos con el clip y mencionar código. El código pegado se reconoce con su lenguaje.

El agente siempre responde en el idioma en que le escribes.

2. Responde las preguntas

Si falta algo, el agente pregunta durante el análisis, todo junto, en tarjetas Preguntas de la IA:

  • Cada pregunta trae su opción Recomendada.
  • Otra respuesta… te deja escribir la tuya.
  • Que decida la IA delega esa pregunta; Decide tú todo elige la recomendada en todas.
  • Teclado: 1–9 elige, Enter sigue, ← vuelve.

3. Sigue el plan

Las tareas de varios archivos se convierten en una misión con un plan de pasos verificables y avance en vivo. La barra de la misión, arriba del chat, muestra la fase actual: Fase n de 8. Ver Misiones y fases.

Mientras trabaja, el workboard muestra qué hace en cada momento: Analizando, Investigando, Editando, Verificando…

Puedes seguir escribiendo: tus mensajes quedan en cola y puedes preguntar «¿cómo vas?».

4. Autoriza lo que tiene efectos

Cuando el agente necesita ejecutar un comando o hacer algo con consecuencias, aparece la tarjeta Autorización requerida:

  • Autorizar o Ejecutar lo aprueba; Rechazar lo descarta.
  • Siempre en este chat evita que vuelva a preguntar por esa misma acción en la conversación.
  • Ctrl+Alt+Enter autoriza todo lo pendiente.

5. Revisa los cambios

Ningún cambio llega al disco sin revisión. Cada propuesta llega como una tarjeta con su diff. Ábrelas todas en Cambios IA con Ctrl+Alt+R. Ver Revisar cambios.

6. Recibe la entrega

Al terminar, el agente:

  1. Mide el código que tocó contra la versión anterior y da una sola línea con el veredicto.
  2. Compila, prueba y arranca la aplicación.
  3. Resume lo hecho, lo verificado, las decisiones y lo pendiente.

Deshacer

  • Alt+Shift+Z deshace lo último que aplicó el agente.
  • Ctrl+Alt+Shift+Z deshace la última tarea completa, con todos sus archivos.
  • ↺ Deshacer tarea en el resumen del turno hace lo mismo con vista previa.

Lo que el agente nunca hace sin pedírselo

  • Commit, push, merge o crear ramas.
  • Escribir en una base de datos.
  • Leer .env, llaves o credenciales.

Ver Sandbox y permisos.

Más formas de trabajar

Si quieres… Usa
Que trabaje solo hasta terminar Modo desatendido
Repartir un trabajo grande entre varios agentes Equipo de agentes
Delegar algo largo sin tocar tu copia de trabajo Tareas en segundo plano (Alt+Shift+B)
Diseñar una pantalla Web Studio