PerchAI
Cómo usar Perch

Objetivos

Un objetivo es una meta que Perch persigue turno tras turno por su cuenta, con una comprobación independiente de si de verdad está cumplida, hasta que termina o se le agota el presupuesto.

Un turno normal hace lo que pediste y se detiene. Si el trabajo lleva doce pasos, acabas diciendo "continúa" una y otra vez. Un objetivo elimina eso: declaras la meta una sola vez, y Perch vuelve a llamarse a sí mismo turno tras turno hasta que una comprobación independiente coincide en que el trabajo está hecho.

The short version

/goal <objective> en Perch Terminal o en la CLI. Se ejecuta a lo largo de muchos turnos, sobrevive al cierre y se detiene solo a los 40 turnos o a las 4 horas. /goal a secas muestra cómo va.

Cómo fijar uno

/goal make the test suite pass
/goal reconcile every invoice in this folder against the ledger and write up the exceptions

Recurre a un objetivo cuando el trabajo tiene muchos pasos y una meta que podrías describir en voz alta. No lo uses para una sola pregunta: un objetivo que podría haber sido un turno solo agrega un paso de auditoría.

Volver a iniciar /goal con exactamente el mismo texto de objetivo continúa el que ya tienes y conserva su conteo de turnos. Un texto distinto empieza uno nuevo.

Cómo seguirlo y dirigirlo

ComandoQué hace
/goalMuestra el objetivo: su estado, los turnos usados, por qué se detuvo la última vez y qué dijo la última comprobación de cumplimiento.
/goal pauseLo pausa sin perderlo.
/goal resumeLo retoma donde se detuvo.
/goal clearLo descarta. stop, off, cancel y reset también funcionan.

/goal status es lo mismo que /goal a secas, y /goal continue es lo mismo que /goal resume.

Mientras un objetivo se ejecuta, ves cada turno a medida que ocurre, con sus llamadas a herramientas. Esc en la app de escritorio, o Esc con el cuadro vacío o Ctrl-C en la CLI, detiene la ejecución actual.

La comprobación de cumplimiento

Perch no se cree a sí mismo cuando dice que un objetivo está listo. Cuando una ejecución declara cumplida la meta, una comprobación aparte revisa esa afirmación, y puede volver de tres maneras:

  • Cumplida. La ejecución termina como completa.
  • No cumplida. Perch sigue trabajando con lo que encontró la comprobación. Si la ejecución termina ahí, te dice qué faltaba y puedes retomarla.
  • Imposible. La comprobación determinó que la meta no se puede cumplir en absoluto. La ejecución se detiene y explica por qué, así puedes cambiar el objetivo en lugar de quemar turnos en él.

Lo último que dijo la comprobación forma parte del estado de /goal, así que siempre puedes ver qué es lo que le falta.

Dónde se detiene una ejecución

Un objetivo nunca se ejecuta para siempre. Todos los estados finales salvo Complete se pueden retomar con /goal resume.

ParadaQué significa
CompleteLa comprobación de cumplimiento pasó.
BudgetLlegó a 40 turnos o a 4 horas de reloj. Lo que tienes es un avance parcial.
IncompleteUn turno no hizo llamadas a herramientas y no pasó la comprobación, así que se detuvo en lugar de dar vueltas.
BlockedUna acción necesita tu aprobación, o la ejecución se topó con algo que no puede hacer sin supervisión.
PausedLo pausaste tú, o lo pausó un límite de uso.
FailedUn turno dio error.
CancelledLo detuviste.
InterruptedEl proceso de la ejecución murió, por ejemplo porque la app se cerró a mitad de un turno.

Un paso que deja de responder también termina la ejecución, en lugar de dejarla colgada.

Aquí importan los modos de permisos

Un objetivo está pensado para ejecutarse sin ti, y el modo de permisos Default se detiene en la primera escritura o comando para preguntar. Por eso un objetivo iniciado en Default se ejecuta en Auto Review durante esa ejecución, y Perch lo dice al empezar: el trabajo reversible se ejecuta solo, y las acciones de mayor riesgo siguen pasando por una comprobación de seguridad. Take the Wheel y Plan se quedan como los dejaste.

Auto Review te sigue consultando para las acciones de mayor riesgo. Cuando eso pasa, el objetivo informa Blocked y espera. Consulta los modos de permisos.

Sobrevive al cierre

Un objetivo se guarda junto con su hilo, así que sobrevive a la sesión. Sal de la CLI, cierra la app de escritorio o recarga la página, luego vuelve a la misma carpeta o al mismo hilo y ejecuta /goal resume. El objetivo y el conteo de turnos siguen ahí.

De que los objetivos sean por hilo se derivan dos cosas. Un objetivo fijado en el hilo de una carpeta no se ve desde otra, porque la CLI asocia el hilo predeterminado a tu directorio de trabajo. Y un límite de uso que pausó un objetivo puede dejar que se reanude solo hasta que tú inicies un turno propio; un objetivo que pausaste tú nunca se reanuda por su cuenta.