Saltar al contenido principal

Trabajo de largo alcance y Subagentes

Anda Bot está diseñado para gestionar objetivos complejos que requieren continuidad, no solo para dar una única respuesta. El trabajo de largo alcance conserva el objetivo original, verifica el progreso realizado, compacta el contexto cuando es necesario y continúa trabajando en la tarea según se requiera.

Usar /goal​

El comando /goal marca una solicitud como un objetivo de largo alcance:

/goal Finalizar esta preparación de lanzamiento: ejecutar pruebas, revisar el registro de cambios, verificar la documentación del script de instalación y resumir los riesgos.

Cuando el agente principal se encuentra inactivo, el verificador de objetivos evalúa si el resultado actual está completo. Si se requiere más trabajo, genera una tarea de seguimiento para el agente principal. Si el trabajo solo puede continuar con su intervención, como una decisión, credenciales o una aprobación, el objetivo se pausa e indica lo que necesita; su siguiente mensaje lo reanuda. Si el contexto de la conversación se vuelve demasiado extenso, Anda compacta el estado actual y abre una conversación vinculada para continuar con la misma sesión sin perder el hilo.

Usar /loop​

El comando /loop ejecuta un prompt o comando de barra diagonal de forma repetida. Puede describir el intervalo en la solicitud utilizando cualquier formato natural, como every 5 minutes (cada 5 minutos), 5m o unidades de tiempo localizadas. El modelo interpreta el intervalo y puede crear una tarea programada cron del agente en segundo plano cuando sea necesario:

/loop cada 5 minutos /side Verificar si la cola de despliegue está bloqueada y resumir el resultado.

Si no especifica un intervalo, Anda permite que el modelo determine su propio ritmo en el bucle y continúe cuando sea necesario realizar más trabajo:

/loop Continuar verificando la migración hasta que se demuestre que cada paso de validación se ha completado con éxito.

Tareas programadas​

Cron admite expresiones cron, intervalos every y tareas únicas at/once. El planificador comprueba las tareas cada cinco segundos y ejecuta como máximo ocho a la vez. Las tareas de agente esperan a que termine el trabajo enviado, incluidas las herramientas en segundo plano; las de shell esperan a que finalice el proceso. Los intervalos every se cuentan desde la finalización y las ejecuciones periódicas omitidas no se reproducen una por una. Las marcas de tiempo únicas se redondean hacia arriba al siguiente segundo, para no ejecutarse antes de lo solicitado. Las expresiones cron usan los cinco campos estándar, donde 0 o 7 es domingo; las formas de seis y siete campos añaden segundos y año y numeran los días desde 1 = domingo, así que en ellas usa nombres de día como MON-FRI.

Editar una tarea pausada mantiene la pausa; usa manage_cron_job con resume para reactivarla. Reenviar la programación actual junto con otros cambios mantiene la hora de la próxima ejecución. Una tarea única que ya se ejecutó se indica como completed, no como pausada, y no se puede reanudar; asígnale una nueva programación para volver a ejecutarla. origin=true en update_cron_job traslada las futuras ejecuciones al llamante y a la conversación actuales. Una ejecución ya iniciada conserva su ruta original. Las listas de tareas y de ejecuciones muestran vistas previas de texto limitadas; usa manage_cron_job con get para ver la tarea completa y su último resultado. Eliminar una tarea conserva su historial y no cancela una ejecución en curso.

Las herramientas cron están restringidas a usuarios de confianza. Las tareas creadas desde la CLI del propietario validan y guardan el directorio de trabajo registrado; la autorización sobrevive a reinicios y a la caducidad del registro temporal de la CLI. Para tareas antiguas sin autorización guardada, vuelve a conectar la CLI en el directorio deseado y actualiza la tarea una vez con origin=true. Los metadatos de la solicitud por sí solos no autorizan un directorio nuevo.

Usar /side​

Los comandos /side o /btw colocan una solicitud en una tarea secundaria independiente. Resulta muy útil para:

  • Investigar un riesgo específico.
  • Solicitar que otra perspectiva o rol revise la conclusión actual.
  • Recopilar información de contexto sin interrumpir la conversación principal.
/side Comprobar si esta actualización de dependencias afecta a los usuarios de macOS arm64.

Usar /skill​

Las habilidades (Skills) de runtime personales residen en ~/.anda/skills, mientras que las habilidades integradas en las versiones oficiales se cargan desde ~/.anda/bundled-skills. Cuando desee que un flujo de trabajo específico funcione con una solicitud, use:

/skill git-assistant Redactar un mensaje de commit de tipo Conventional Commit a partir del diff actual.

Qué hacen los subagentes​

Los subagentes pueden asumir roles especializados como investigación, implementación, revisión y supervisión. La sesión principal conserva el objetivo general y el juicio final, mientras que los subagentes se encargan de llevar a cabo el trabajo enfocado.

Esta estructura es ideal para:

  • Trabajos de investigación que requieran la lectura de múltiples archivos o referencias de documentación.
  • Tareas de código donde la implementación y la revisión deban estar claramente separadas.
  • Objetivos que requieran verificaciones repetidas de si el trabajo se ha completado realmente.
  • Trabajos que requieran el uso de herramientas externas sin perder el hilo de la conversación principal.

Herramientas y espacio de trabajo local​

Las herramientas básicas de Anda include memoria, comandos de shell, lectura/escritura de archivos, habilidades, tareas programadas (cron) y subagentes. Las herramientas de archivos y shell operan de forma predeterminada en ~/.anda/workspace.

Cuando una tarea involucre al repositorio actual o a herramientas externas, indique claramente el objetivo, los criterios de aceptación y los límites de la tarea.

/goal Corregir la compilación de la documentación en el repositorio actual. No edite código Rust. Completado significa que pnpm --dir docsite build pase con éxito.

Cuándo no usar /goal o /loop​

Las preguntas y respuestas simples, las explicaciones puntuales y las búsquedas rápidas de comandos no requieren el uso de /goal o /loop. Para estos casos, envíe un mensaje normal. Reserve /goal para trabajos que requieran auditoría de finalización y /loop para seguimientos recurrentes o tareas autodirigidas.