Rutinas

Guarda una tarea una vez y Perch la ejecuta en la nube con una programación, o cuando tu propio código la llama, incluso con tu computadora apagada. Cada ejecución se abre como un chat que puedes leer y continuar. En beta para Pro.

Beta

Las rutinas están activadas en todas las cuentas Pro. Si ves Routines en la barra lateral de Perch Terminal, debajo de Artifacts, están activadas para ti.

Una rutina es una tarea guardada en la nube: un nombre, instrucciones, un modelo y lo que la inicia. Cuando llega su momento, Perch inicia un agente en la nube con tus instrucciones como primer mensaje. Se ejecuta en un espacio de trabajo privado en la nube, así que tu computadora puede estar apagada. Después abres el chat de la ejecución, lees lo que hizo y sigues conversando si quieres más.

Las rutinas sirven para el trabajo que de otro modo pedirías una y otra vez: una revisión de errores cada mañana en un repositorio, una pasada de lunes a viernes por una bandeja de entrada de soporte, un resumen semanal de métricas o una comprobación que tus propias herramientas inician después de cada despliegue.

Crea una rutina

Abre Routines

En Perch Terminal en la web o en Perch Desktop, selecciona Routines en la barra lateral y luego New routine.

Ponle un nombre y escribe las instrucciones

Escribe las instrucciones como si le explicaras el encargo a un colega: qué revisar, qué hacer y qué quieres recibir. Por ejemplo: "Lee el correo nuevo de la bandeja de entrada de soporte. Redacta una respuesta para cada pregunta sencilla y guárdala como borrador de Gmail. Etiqueta el resto. Nunca envíes nada."

El menú de modelos está en la esquina inferior derecha del cuadro de instrucciones y ofrece las mismas opciones que el cuadro de mensaje.

Elige un repositorio, si la tarea lo necesita

Para trabajo de código, elige un repositorio de GitHub y una rama. Cada ejecución lo clona y sube su trabajo a una rama nueva llamada perch/ seguida de un id corto. No se fusiona nada por ti. Déjalo en No repository para cualquier cosa que no toque un repositorio.

Elige un activador

Schedule la ejecuta en horarios fijos, o una sola vez en un momento futuro. API la inicia desde tu propio código. Ambos se describen más abajo.

Configura las conexiones, el comportamiento y las notificaciones

Tres pestañas debajo del activador deciden qué apps puede usar la rutina, si se detiene a preguntar antes de acciones riesgosas y cómo te avisa de una ejecución. Consulta Configuración.

Selecciona Create routine

La rutina queda activada desde el momento en que la guardas. El formulario muestra cuándo será su primera ejecución.

O pídeselo a Perch

En cualquier chat de Perch Terminal, en la web, en Perch Desktop o en la CLI, describe la rutina que quieres o escribe /schedule (/routines también funciona). Perch te pide lo que le falte y luego muestra una tarjeta con todo lo que va a guardar: el nombre, las instrucciones completas, la programación en tu zona horaria con la próxima ejecución, el modelo, las conexiones, el repositorio y la configuración.

Nada se guarda hasta que apruebas la tarjeta. Aparece en todos los modos de permisos, incluido Take the Wheel, y Auto Review nunca la aprueba por ti. A menos que indiques otros, la rutina usa el modelo que está usando el chat y la zona horaria de tu dispositivo.

Las propias ejecuciones de una rutina no pueden crear ni cambiar rutinas.

Activadores

Programación

Se repite	Se ejecuta
Every hour	En el minuto de cada hora que elijas.
Every day	A una hora del día.
Weekdays	De lunes a viernes a una hora del día.
Every week	Un día de la semana a una hora del día.
Custom	Con una programación cron de cinco campos: minuto, hora, día del mes, mes y día de la semana.
Once	En una fecha y hora. Después, la rutina muestra Done: it ran once.

Cada programación se ejecuta en la zona horaria que elijas, así que un cambio de horario de verano no la mueve. Una rutina se ejecuta como máximo una vez por hora, y se rechaza una programación personalizada que se ejecutaría con más frecuencia.

API

Usa el activador API para iniciar una rutina desde un script de despliegue, una alerta de monitoreo u otra app. Cuando guardas, Perch muestra un token secreto una sola vez. Cópialo en ese momento.

En la página de la rutina, Trigger from another app muestra la dirección y una solicitud de ejemplo:

curl -X POST https://chat.perchai.app/api/routines/fire \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "..."}'

text es opcional, de hasta 2,000 caracteres. Llega a la ejecución como datos, nunca como órdenes, así que Perch lo usa solo de la forma que indican tus instrucciones. Por ejemplo: "El texto de la alerta va adjunto. Encuentra su causa en el repositorio."
Perch responde con 202 y el runId y el chatUrl de la nueva ejecución.
Una rutina se puede iniciar de esta forma hasta 30 veces por hora.
Make a new token reemplaza el token, y el anterior deja de funcionar. Delete token desactiva el activador API.

Ejecutar ahora

Toda rutina tiene Run now en su página, sea cual sea su activador. Selecciona primero Add a note para enviar texto adicional solo con esa ejecución.

Configuración

Conexiones

Una rutina solo puede usar las conexiones que agregues en esta pestaña. No se elige ninguna por ti. Puedes agregar cualquier app que hayas conectado en Settings › Connections, hasta 10 por rutina.

Las rutinas se ejecutan en la nube, así que los servidores MCP locales configurados en tu computadora no están disponibles para ellas, igual que para cualquier agente en la nube.

Comportamiento

Ask before risky actions es la opción predeterminada. Una ejecución espera tu aprobación antes de hacer algo riesgoso, y su estado dice Waiting for you. La página de rutinas muestra A run is waiting for your approval con un botón Review que abre el chat. Una aprobación sin respuesta durante 24 horas vence.
Run without asking deja que Perch haga lo que dicen las instrucciones sin detenerse, incluso hacer cambios a través de sus conexiones. Úsalo para tareas que ya hayas visto ejecutarse antes.
New chat each run es la opción predeterminada. Keep one chat hace que cada ejecución continúe la anterior, así puede decirte qué cambió desde entonces.

Notificaciones

Tell me decide cuándo te enteras de una ejecución:

After every run (la opción predeterminada)
Only when there's something to report. Cada ejecución indica si encontró algo. Una ejecución que no encontró nada muestra Nothing to report y no te avisa.
Only when a run fails
Never

Debajo, elige Phone notification, Email o ambas. Las notificaciones en el celular necesitan Perch en tu pantalla de inicio. El correo nombra la rutina y el resultado, empieza con el comienzo de la respuesta y enlaza al chat.

A menos que Tell me esté en Never, Perch siempre te envía un correo cuando una ejecución falla, espera tu aprobación o no puede iniciarse, incluso con Email desmarcado.

Sigue tus rutinas

La lista de rutinas muestra la programación de cada rutina, su próxima ejecución, cómo le fue a su última ejecución y un interruptor para activarla o desactivarla. Un contador marca los resultados que todavía no abriste.

Abre una rutina para ver sus ejecuciones: cuándo empezó cada una, qué la inició (Schedule, API o Run now), cómo le fue y cuánto tardó. Open chat abre el chat de una ejecución. Los chats de las rutinas no aparecen en tu lista de chats, así que una rutina que se ejecuta cada hora no entierra tu otro trabajo. Cada uno es un chat normal en la nube: haz una pregunta de seguimiento, responde una aprobación o revisa una rama en el panel Changes.

Estado	Significado
Running	La ejecución sigue en curso.
Waiting for you	La ejecución necesita tu aprobación para continuar.
Answered	La ejecución terminó.
Nothing to report	La ejecución terminó y no encontró nada que valga la pena contarte.
Failed	La ejecución se detuvo con un error. El motivo se muestra junto a ella.
Expired	La ejecución esperó más de 24 horas una aprobación.
Stopped	Detuviste la ejecución.
Skipped	La ejecución no empezó. El motivo se muestra junto a ella.

Una ejecución programada se omite, y la siguiente sigue adelante según lo previsto, cuando:

La última ejecución de la rutina sigue en curso. Dos ejecuciones de una misma rutina nunca empiezan al mismo tiempo.
La última ejecución espera tu aprobación y la rutina mantiene un solo chat.
Perch no pudo iniciarla en los 30 minutos posteriores a su hora.
Ya tenías tres ejecuciones en la nube en curso durante los 30 minutos posteriores a su hora.
Habías alcanzado el límite diario de ejecuciones en la nube o usado las horas de espacio de trabajo en la nube de este período.

Para cambiar una rutina, ábrela y selecciona Edit en el menú More actions. El interruptor la desactiva y la activa. Delete elimina la rutina pero conserva sus chats.

Si el modelo de una rutina ya no se ofrece, Perch desactiva la rutina y te lo indica en lugar de cambiar de modelo por su cuenta. Elige otro modelo y luego vuelve a activarla.

Uso y límites

Hasta 20 rutinas pueden estar activadas a la vez.
Una vez por hora como máximo para cada rutina.
Cada ejecución es una ejecución de agente en la nube. El uso de modelos cuenta para los límites normales de tu plan, y el tiempo del espacio de trabajo cuenta para las 30 horas de tiempo de espacio de trabajo en la nube por período de facturación. Las ejecuciones de rutinas comparten con tus otros chats en la nube el límite de tres ejecuciones en la nube a la vez.

Solución de problemas

No veo Routines. Las rutinas vienen con Pro. Comprueba que iniciaste sesión con tu cuenta Pro.

Se rechaza mi programación. Una rutina puede ejecutarse como máximo una vez por hora, y la hora de Once tiene que estar en el futuro.

Una ejecución dice Skipped. El motivo se muestra junto a ella. La lista de más arriba explica cada uno.

No recibí un correo. Comprueba que Tell me no esté en Never y revisa tu carpeta de spam. Si Perch no puede enviar correos en este momento, la página de la rutina lo indica.

En esta página