PerchAI
Cómo usar Perch

Tareas en segundo plano

Los comandos largos y los agentes delegados se ejecutan en segundo plano mientras tú sigues en el chat, y Perch puede retomar el trabajo por su cuenta cuando uno de ellos termina.

Hay trabajo que lleva minutos: una suite de pruebas, una compilación, una instalación larga, un proceso que preferirías no mirar. Perch puede iniciarlo, soltarlo y volver a él cuando esté listo, en lugar de quedarse dentro del comando mientras la conversación espera.

En segundo plano se ejecutan dos cosas distintas, y vale la pena distinguirlas.

Comandos en segundo plano

Un comando en segundo plano es un programa que Perch inicia en tu computadora y que no espera. El turno continúa, y el comando sigue ejecutándose después de que el turno termina.

Perch los maneja con cinco herramientas:

HerramientaQué hace
run_in_backgroundInicia el comando como un trabajo separado y vuelve de inmediato con un id de tarea.
list_background_tasksLista las tareas y su estado.
check_background_taskLee la salida más reciente sin bloquear.
wait_for_background_taskBloquea hasta que termine.
kill_background_taskLa detiene.

Lo que el harness garantiza:

  • El registro sobrevive a los reinicios. Las tareas se guardan en disco, así que salir de la CLI o cerrar la app no les pierde el rastro. Una tarea cuyo proceso ya no existe cuando Perch vuelve se informa como desconocida, no como si siguiera corriendo en silencio.
  • La salida se captura a un archivo. Perch guarda la salida combinada, con un tope, y conserva el principio y el final cuando una tarea escribe más que ese tope. Los resultados de las herramientas muestran una vista previa corta en lugar del registro entero.
  • Un número limitado a la vez. En una máquina solo se ejecutan juntas unas pocas tareas en segundo plano. Pasado ese límite, una nueva se rechaza hasta que otra termine o se detenga.
  • Una hora. Un vigilante detiene una tarea en segundo plano que lleva una hora corriendo.

Pídelo con palabras. "Ejecuta la suite de pruebas en segundo plano y sigue" alcanza.

Perch volviendo a una tarea terminada

Lo útil es lo que pasa cuando una tarea en segundo plano termina. Perch puede iniciar un turno propio para leer el resultado y retomar el trabajo, así que lo que hace avanzar la tarea es que la compilación termine, no que tú te des cuenta y digas "bueno, ¿y ahora qué?".

Eso solo ocurre dentro de ciertos límites:

  • Solo en Auto Review y Take the Wheel. En Default, Perch nunca inicia un turno propio, porque el sentido de Default es que estás ahí para aprobar cada paso.
  • No para comandos triviales y rápidos. Un comando que terminó en menos de un par de segundos no despierta nada. De lo contrario, un comando rápido se convertiría en un bucle caro.
  • Un techo fijo por chat. Los turnos que Perch inicia por su cuenta en un chat tienen un tope, así que una tarea que se reinicia sola no puede dar vueltas para siempre.

La transcripción etiqueta esos turnos, así que siempre ves que lo inició Perch y no tú.

Agentes en segundo plano

Un agente en segundo plano es una tarea completa entregada a un ayudante, no un solo comando. /delegate <task>, o /bg, entrega una tarea acotada a un agente que trabaja por su cuenta; el resultado llega al mismo chat cuando termina.

/delegate summarize every PDF in ./contracts and list the renewal dates

Úsalo cuando la tarea es autónoma y prefieres seguir trabajando en lugar de mirar. Si la tarea necesita tu intervención a mitad de camino, o quieres dirigirla, mejor déjala en la sesión principal.

En la CLI, /agents lista los agentes de este chat, /agents <id> imprime los pasos y el informe de un agente, y /agents stop <id> lo detiene.

Los agentes tienen límites igual que los comandos en segundo plano: un tope propio de pasos, 30 minutos de reloj, y 10 minutos sin salida cuentan como atascado. Cada resultado dice por qué se detuvo el agente, incluso cuando llegó a un límite. /delegate necesita una sesión que siga abierta, así que no está disponible en un perch run de una sola vez.

Para los ayudantes que Perch lanza dentro de un turno, y para las sub-sesiones, consulta Sub-agentes. Para un equipo entero de trabajadores sobre una misma tarea, consulta Flock.