Saltar al contenido
Inicio
Docs/Workflows

Workflows

Un workflow es un disparador más un árbol de pasos que se ejecuta en tu dispositivo, sobre un contexto compartido. Esta página recorre cada pantalla del módulo, los 25 disparadores, las 15 acciones, los siete tipos de paso, las expresiones, la programación, los secretos, el compartir, y qué incluye Free y qué Pro.

Qué es y cómo se abre

Workflows es una ventana a pantalla completa que se abre sobre la app, no una de las cinco páginas del pager. Un workflow se guarda en tu dispositivo y se ejecuta ahí: un disparador principal (y hasta cinco más) y un árbol de pasos de siete tipos. Las ejecuciones programadas pasan por WorkManager de Android; mientras haya algún run vivo, PocketCode mantiene un aviso con un botón Parar.

Cómo se abre

Dónde estásQué tocasQué se abre
La hoja Tools de la barra de navegaciónWorkflows, en la segunda fila de celdasEl módulo, en su pantalla de bienvenida
El menú lateralWorkflows, en la categoría de herramientasEl módulo
HomeCualquier fila del widget Ejecuciones de workflows (el widget solo se dibuja si hay runs)El módulo
El aviso de un run, o el aviso de un workflow programado que no pudo arrancarTocarloEl detalle de ese run, o el editor de ese workflow
El panel de actividad del chat de IAUna fila de tipo run de workflowEl módulo
Fuera de la appUn enlace: pocketcode://workflows, pocketcode://workflows/run/<runId>, pocketcode://workflows/<workflowId> o pocketcode://workflows/import?url=<dirección https>El módulo, ese run, ese workflow o la hoja de importar. Un enlace solo abre una pantalla: nunca ejecuta, borra ni descarga nada por sí mismo

Cómo se comporta la ventana

  • El módulo es una ventana propia, así que no ves el resto de la app mientras está abierto. Atrás sube un nivel: del editor a la lista, del detalle de un run al historial o a las pestañas, de secretos a las pestañas, de las pestañas a la bienvenida, y la bienvenida cierra el módulo.
  • En una ventana ancha (840 dp de ancho y 480 dp de alto o más, como una tablet) la lista queda a la izquierda y el editor, el historial o el detalle de un run se abre a la derecha. El panel de ajustes de paso (360 dp de ancho) solo se usa si al editor le quedan al menos 400 dp al lado; si no, los ajustes de paso se abren como hoja.
  • Un workflow también puede arrancar sin abrir el módulo: desde un atajo de la pantalla de inicio, una baldosa de Ajustes rápidos o el menú Compartir del sistema (mira Ejecutar y vigilar).
Workflows welcome screen on a tablet in landscape: My Workflows, and under Explore the Templates and CI / CD cards
La pantalla de bienvenida en una tablet en horizontal: Mis Workflows y, bajo Explorar, las tarjetas Plantillas y CI / CD. En horizontal no hay tarjeta Generar desde prompt.

No puedes, y por qué

  • Abrirlo desde la paleta de comandos: la paleta no tiene ningún comando de Workflows, y Workflows tampoco es una página del pager.A propósito

Mapa de pantallas

Una fila por pantalla, hoja y diálogo del módulo, y de dónde se llega.

PantallaCómo llegasQué puedes hacer
Pantalla de bienvenidaAl abrir el módulo; Atrás desde las pestañasAbrir Mis Workflows, Generar desde prompt (solo en vertical), Plantillas o CI / CD (las dos abren la pestaña Plantillas).
Cabecera y pestañasSiempre arribaCambiar entre Mis Workflows, Plantillas y Actividad. Solo en la primera pestaña: Importar un workflow desde un fichero, Gestionar secretos y el botón + (Flujo nuevo). El aviso «Los workflows programados necesitan atención» sale sobre las pestañas cuando algo frenaría lo programado.
Pestaña Mis WorkflowsPrimera pestañaBuscar, ordenar y filtrar por etiqueta; activar o desactivar un workflow; ejecutar, parar, programar, abrir su historial, borrar; abrir el menú de pulsación larga.
Diálogo de EtiquetasEtiquetas en el menú de una tarjetaAñadir o quitar hasta 8 etiquetas de un workflow.
Pestaña PlantillasSegunda pestaña; las tarjetas Plantillas y CI / CD de la bienvenidaBuscar entre las 17 plantillas, filtrar por familia, abrir una vista previa, Activar o Añadir otra copia.
Vista previa de plantillaTocar una tarjeta de plantillaLeer Arranca cuando, los pasos, Qué necesita, y hacer una prueba en seco (Probar ahora) que no toca nada.
Pestaña ActividadTercera pestañaVer los últimos runs de todos los workflows; buscar en los errores; filtrar por estado, fecha y workflow; parar un run vivo; abrir un run; copiar como JSON los runs filtrados; Borrar historial.
EditorTocar una tarjeta, Editar en su menú, el botón +, un aviso de un workflow programado, Abrir en el editorPonerle nombre; declarar Entradas; fijar Ajustes del workflow y Permisos; elegir disparadores y filtros; construir el árbol de pasos; probar; guardar.
Ajustes de paso (siete hojas)El lápiz de un paso, o Añadir pasoConfigurar una acción, Si / Si no, Bucle, En paralelo, Intentar / si falla, Subflujo o Espera. En una acción, además Fiabilidad y Condicional.
Paleta de Añadir pasoEl botón + del editor, o el + de una ramaBuscar entre las 15 acciones y los seis bloques de control de flujo por nombre, descripción o salida; usar favoritos y recientes.
Selector de Insertar un datoEl botón del mismo nombre en un parámetroElegir una entrada, un campo del disparador, la salida o el estado de un paso anterior, o el elemento o el error del bloque en el que estás.
Panel de ProblemasDentro del editor, sobre los pasosLeer errores, avisos y sugerencias y saltar al paso con Ir al paso.
Diálogo de convertir en subflujoConvertir en subflujo en el menú de un pasoPoner nombre al workflow nuevo y mover a él el paso y su contenido.
Diálogo Ejecutar (entradas del run)Ejecutar ahora en un workflow con entradas obligatorias; Ejecutar con estas entradas en un runRellenar las entradas declaradas (con los valores por defecto ya puestos) y pulsar Ejecutar.
Historial de ejecucionesHistorial de ejecuciones en una tarjeta o en su menúVer los runs de un workflow; Parar esta ejecución; abrir un run.
Detalle de un runUn run del historial o de Actividad; un aviso; un enlace profundoLeer cada paso (resultado, duración, intentos, error, salida JSON), seguir el log de la shell en vivo, Volver a ejecutar, Repetir desde el paso fallido, Ejecutar con estas entradas, Analizar con IA, Copiar como JSON.
Diálogo Repetir este runVolver a ejecutar o Repetir desde el paso fallidoLeer qué ha cambiado desde ese run antes de confirmar.
Hoja de horarios (Horarios de …)Programar en una tarjeta o en su menúListar y quitar horarios; añadir preajustes o Cron personalizado; fijar Condiciones del dispositivo y Si se pierde una ejecución.
SecretosGestionar secretos (icono de llave)Añadir, cambiar el valor o borrar secretos cifrados; ver qué workflows usan uno antes de borrarlo.
Hoja Compartir este workflowCompartir como fichero en el menú de una tarjetaVer qué campos secretos se vacían y compartir el fichero .pcwf.json.
Hoja Importar workflowImportar un workflow desde un ficheroVer una vista previa del fichero (disparador, pasos, secretos que faltan, resultado del linter) y guardarlo apagado.
Un enlace quiere importar un workflowUn enlace pocketcode://workflows/import?url=…Ver la dirección de la que viene y elegir Descargar o No, gracias.
Generar workflow desde prompt y Cambiar … con IAGenerar desde prompt en la bienvenida; Cambiar con IA en el menú de una tarjetaDescribir una automatización o un cambio, revisar el resultado, Guardar y activar o Abrir en el editor.
Diálogos de pasos irreversiblesActivar un workflow con pasos irreversibles; guardar uno que esté Disponible para el agente de IALeer los pasos y decidir: Activar de todos modos o Permitir a la IA.
Atajo, baldosa y Mandar a un workflowLa pantalla de inicio, Ajustes rápidos y el menú Compartir de AndroidLanzar un workflow sin abrir el módulo.
Aviso de un runLa bandeja de notificaciones mientras hay un run vivoSeguir Paso n de m y pulsar Parar.

La lista, las etiquetas y las plantillas

El módulo tiene tres pestañas: Mis Workflows, Plantillas y Actividad (esta última se explica en Ejecutar y vigilar). Sobre las pestañas, solo en Mis Workflows, están Importar un workflow desde un fichero, Gestionar secretos y el botón + (Flujo nuevo), que abre el editor con un workflow vacío, apagado y con el disparador Manual o programado.

Pantalla de bienvenida

El módulo siempre se abre aquí. Atrás desde las pestañas vuelve aquí; Atrás desde aquí cierra el módulo.

Puedes

  • Toca Mis Workflows (Gestiona tus automatizaciones activas) para abrir la lista.
  • Toca Generar desde prompt para describir una automatización en una frase (mira IA: generar, cambiar y el chat). La tarjeta solo está en vertical.
  • Bajo Explorar, toca Plantillas o CI / CD. Las dos abren la misma pestaña Plantillas: CI / CD no filtra nada.

No puedes, y por qué

  • Crear un workflow en blanco desde aquí: usa el botón + de Mis Workflows.​A propósito
  • Ver Generar desde prompt en horizontal (un móvil de lado, una tablet en apaisado): la bienvenida horizontal solo tiene Mis Workflows, Plantillas y CI / CD. Cambiar con IA en el menú de una tarjeta sigue funcionando.Aún no

Pestaña Mis Workflows

Una tarjeta por workflow, con su estado, cuándo se ejecutó por última vez, puntos de salud y, si está programado, la próxima ejecución.

My Workflows on a tablet: tabs, the battery-optimisation banner and two workflow cards with their switches and icons
Mis Workflows en una tablet: el aviso de optimización de batería, un workflow que arranca con cada push y uno manual con sus iconos ▶, reloj, historial y papelera. Los dos iconos de arriba a la derecha son Importar un workflow desde un fichero y Gestionar secretos.

Puedes

  • Buscar en tus workflows: mira el nombre, la descripción y las etiquetas, sin distinguir acentos.
  • Ordenar por Editados hace poco, Por nombre, Última ejecución o Los que fallan primero.
  • Filtrar por etiqueta con los chips (Todos más tus etiquetas, las más usadas primero).
  • Activar o desactivar un workflow con el interruptor de su tarjeta. Activar uno que tiene pasos irreversibles pregunta una vez (mira Ejecutar y vigilar).
  • Tocar el icono ▶ para ejecutar un workflow cuyo disparador principal es Manual o programado; mientras corre, el icono pasa a ser un ■ Parar con un anillo de progreso, en cualquier workflow, lo haya arrancado lo que lo haya arrancado.
  • Usar el icono del reloj (Programar), el del historial (Historial de ejecuciones) y la papelera roja (borrar).
  • Borrar un workflow con la papelera roja o con Borrar en el menú de la tarjeta. Un diálogo pregunta ¿Eliminar «<nombre>»? («Se eliminan el workflow y sus programaciones. No se puede deshacer.») y solo lo borra cuando pulsas Borrar; Cancelar lo deja todo como estaba.
  • Mantener pulsada una tarjeta, o hacer clic secundario, para abrir su menú.

No puedes, y por qué

  • Tener un ▶ en la tarjeta de un workflow que arranca por un evento o un atajo: para esos, Ejecutar ahora está en el menú de la tarjeta.A propósito
  • Conservar la búsqueda, el orden o el filtro de etiqueta al salir de la pantalla: un filtro esconde cosas, así que se pide de nuevo cada vez.A propósito
My Workflows on a phone with the three tabs, the battery-optimisation banner and cards for verify-hello, Tests then Deploy if they pass and Prettier on Save with their health dots
La misma lista en un móvil: pestañas, el aviso, un workflow con sus puntos de salud y 100% de exito, uno que nunca se ha ejecutado y otro cuyos últimos runs fallaron (0% de exito).

Qué enseña una tarjeta

ParteQué te dice
EstadoEn reposo, En curso, Completado, Fallido o Cancelado, y Última ejecución: (o Nunca ejecutado).
SaludPuntos de los últimos 5 runs y el porcentaje de éxito (por ejemplo 100% de exito); Ningun run terminado todavia si no hay ninguno.
DisparadorLa etiqueta del disparador principal, como Al hacer push o Manual o programado.
Próx.:La próxima ejecución programada, si el workflow tiene horario.
Progreso en vivoPaso n de m mientras corre.

El menú de la tarjeta

OpciónQué hace
EditarAbre el editor.
Cambiar con IAAbre la hoja de cambio (mira IA: generar, cambiar y el chat).
Activar / DesactivarLo mismo que el interruptor.
Ejecutar ahora / PararLanza un run de cualquier workflow, sea cual sea su disparador; con entradas obligatorias las pide antes. Mientras hay un run en marcha la opción es Parar.
ProgramarAbre la hoja de horarios.
Historial de ejecucionesAbre los runs de ese workflow.
DuplicarHace una copia apagada, con ids de paso nuevos y copia tras su nombre.
Compartir como ficheroAbre la hoja que exporta un .pcwf.json.
EtiquetasAbre el diálogo de etiquetas.
BorrarPregunta ¿Eliminar «<nombre>»? y, cuando confirmas, borra el workflow y sus horarios.

Etiquetas

Las etiquetas agrupan la lista sin mover nada de sitio. Viven en los ajustes del workflow, así que viajan en el fichero exportado.

Puedes

  • Abre Etiquetas desde el menú de una tarjeta, escribe en Nueva etiqueta y añádela; quita una etiqueta desde el mismo diálogo.
  • Filtra Mis Workflows por etiqueta; los chips van ordenados por cuántos workflows los usan.

No puedes, y por qué

  • Poner más de 8 etiquetas a un workflow (El límite son 8 etiquetas.): veinte etiquetas no organizan nada.A propósito

Pestaña Plantillas

17 workflows ya hechos, agrupados por lo que los arranca. Cada tarjeta enseña su nombre, una descripción, su disparador, los tipos de acción que usa y Qué necesita: pasos irreversibles, comandos de terminal, un proveedor de deploy conectado, un proveedor de IA con clave, la red, escribir ficheros, un proyecto abierto.

Puedes

  • Buscar plantillas por nombre, descripción, disparador o acción; filtrar por familia con los chips (Todas y las seis familias de abajo).
  • Tocar Activar para obtener una copia editable con id nuevo, encendida, que aparece en Mis Workflows; toca Añadir otra copia si ya la tienes. La copia no comparte nada con la plantilla.
  • Abrir la vista previa, hacer una prueba en seco y editar la copia después en el editor.

No puedes, y por qué

  • Editar una plantilla en la galería: editas tu copia. El catálogo es fijo, de 17 plantillas.A propósito
  • Que te pregunten por los pasos irreversibles al pulsar Activar: la pregunta solo sale más tarde, cuando mueves el interruptor de un workflow. Lee Qué necesita antes de activar.Aún no
Template gallery with the When you edit and When you use git groups and an Activate button on each card
La galería de plantillas agrupada por cuándo las querrías, aquí Al editar y Al usar git. Cada tarjeta lleva su disparador y Activar.

Las seis familias

FamiliaQué contiene
Al editar3 plantillas, todas con Al guardar archivo como disparador. La familia recoge también todo lo que arranca al crear, borrar o renombrar un fichero, o cuando lo cambia la IA.
Al usar git5 plantillas: tres arrancan con Al hacer push y dos con Al hacer commit.
Alrededor de un despliegue1 plantilla, que arranca con Deploy completado. La familia recoge también Deploy fallido.
Cuando algo falla1 plantilla, que arranca con Se ha detectado un error. La familia recoge también el fin de una compilación o de una ejecución.
Desde el móvil1 plantilla, que arranca con Texto compartido a PocketCode. La familia recoge también el atajo de la pantalla de inicio, la baldosa de Ajustes rápidos y los ficheros compartidos.
Cuando tú quieras, o con horario6 plantillas que arrancan con Manual o programado: las ejecutas tú, o les añades un horario desde el botón del reloj.

Las 17 plantillas

PlantillaArranca cuandoQué hace y qué necesita
Prettier al guardarAl guardar archivo, de ficheros .jsEjecuta prettier --write sobre el fichero que acabas de guardar, no sobre todo el proyecto.
Commit automático al guardar KotlinAl guardar archivo, de ficheros .ktHace commit solo del fichero guardado, en la rama activa, y no hace push. Guardar sin un cambio real no es un fallo.
Lint del fichero que acabas de guardarAl guardar archivo, de ficheros .tsEspera dos segundos, ejecuta eslint sobre ese fichero y avisa solo si encuentra algo. Guardar otra vez mientras espera cancela la ejecución pendiente.
Tests y, si pasan, deployAl hacer pushEjecuta el comando de tests y pide un deploy solo si termina con 0; si no, avisa y no despliega nada. Necesita un proveedor de deploy conectado en el Backend Manager.
Deploy automático al push a mainAl hacer push, filtro mainDespliega tras un push a main y avisa con el estado y la URL.
Tests después del push a mainAl hacer push, filtro mainEjecuta los tests tras un push a main y avisa con su código de salida (no puede bloquear el push).
Tests en cada commitAl hacer commitEjecuta los tests tras un commit y avisa con el código de salida y el mensaje. Solo se dispara con commits hechos desde Projects.
Probar cada módulo que hayas tocadoAl hacer commitUn bucle sobre los directorios del commit (hasta 20) que ejecuta el comando de tests una vez por directorio; un módulo que falla no detiene al resto. Mismo límite que arriba: solo commits hechos desde Projects.
Copia de la base de datos tras el deployDeploy completadoEjecuta un pg_dump y dice qué fichero ha producido; edita el comando para tu propia base de datos.
Análisis con IA de un workflow fallidoSe ha detectado un errorManda el error a la IA y avisa con la respuesta. Necesita un proveedor de IA con clave. La tarjeta dice que solo ve fallos de workflows; hoy el disparador oye también errores de compilación y ejecución del editor y comandos de terminal fallidos que lanza la IA.
Copia de seguridad nocturnaManual o programadoVuelca tu base de datos en una carpeta del proyecto y te avisa solo si falla. Añade un horario (por ejemplo A diario a las 9:00) desde el botón del reloj: un horario no es un disparador.
Probar la rama que elijasManual o programadoPregunta una rama (por defecto main), hace checkout en el proyecto abierto y ejecuta los tests. Cambia tu árbol de trabajo: haz commit o stash antes.
Notas de versión de los últimos commitsManual o programadoLee los últimos 20 commits, pide a la IA las notas de versión y las escribe en RELEASE_NOTES.md, sobrescribiéndolo. Necesita un proveedor de IA.
Comprobar un endpointManual o programadoUna petición GET y un aviso con el código de estado y el tiempo. La URL trae un valor por defecto, así que puede correr sin supervisión cuando pongas la tuya.
Comprobar tres endpoints a la vezManual o programadoPide tres URLs y las llama en paralelo, esperando a las tres. Abre el run para ver cada código de estado.
Desplegar y avisarme aunque falleManual o programadoUn Intentar / si falla alrededor de un deploy que avisa en los dos casos. Necesita un proveedor de deploy conectado.
Guardar un enlace compartido en links.mdTexto compartido a PocketCodeAñade al final de links.md, en el proyecto abierto, una página compartida desde cualquier app, sin sobrescribirlo nunca.

Los ids de plantilla no cambian nunca, así que un workflow creado desde una conserva su vínculo con ella.

Vista previa de una plantilla

Toca una tarjeta de plantilla para ver qué haría antes de activarla.

Puedes

  • Leer Arranca cuando, el árbol de pasos con sus ramas (Si se cumple, Si no, Intenta esto, Si falla) y Qué necesita.
  • Hacer una prueba en seco con Probar ahora. Si la plantilla tiene entradas obligatorias se rellenan los valores por defecto. La vista previa dice qué pasos se saltan porque no se pueden simular, o qué falta, y termina con n pasos · n ms · no se guarda.

No puedes, y por qué

  • Hacer la prueba en seco de una plantilla que declara una entrada obligatoria sin valor por defecto: la vista previa dice No se puede probar sin: y nombra la entrada. Hoy ninguna de las 17 plantillas lo hace, y que falte un proveedor de deploy o una clave de IA no bloquea la prueba.A propósito

El editor

Abre el editor tocando una tarjeta, Editar en su menú, o el botón + para un workflow nuevo. De arriba abajo tiene el nombre y la descripción, Entradas, Ajustes del workflow (plegado), Permisos (una tarjeta propia, plegada), los interruptores Activado y Disponible para el agente de IA, Disparador, y Pasos con el árbol de pasos y el botón + (Añadir paso). La barra superior tiene cerrar, Deshacer, Rehacer, Probar ahora y Guardar. Deshacer guarda los últimos 100 estados y funde las ediciones seguidas del mismo tipo hechas con menos de 800 ms entre sí. Al cerrar (la x o Atrás) se guarda si el workflow se puede guardar; si tiene contenido que aún no se puede guardar pregunta ¿Descartar los cambios? (Seguir editando o Descartar); si no hay nada escrito, simplemente se cierra. Guardar se desactiva mientras haya un error: un nombre vacío, ningún paso, un parámetro obligatorio vacío o una entrada no válida.

Two panes on a tablet: the workflow list on the left and the Edit workflow screen on the right with Inputs, Workflow settings, Permissions, Enabled, Available to AI agent and Trigger
Dos paneles en una ventana ancha: la lista a la izquierda y el editor a la derecha, con Ajustes del workflow y Permisos como tarjetas propias plegadas, y debajo Activado, Disponible para el agente de IA y Disparador.

Nombre, interruptores y exposición a la IA

Nombre y Descripción están arriba. Activado (cuando está apagado, el workflow se guarda pero no se ejecuta) y Disponible para el agente de IA (cuando está encendido, el agente del chat puede invocarlo como herramienta) vienen después de los ajustes, con Descripción que ve la IA: si la dejas vacía se usa la descripción del workflow.

Puedes

  • Cambiar Activado: es el mismo interruptor que el de la tarjeta.
  • Cambiar Disponible para el agente de IA y escribir Descripción que ve la IA. Guardar con el interruptor encendido y pasos irreversibles en el workflow pregunta ¿Dejar que la IA ejecute este workflow? una vez (Permitir a la IA).
  • Leer la Advertencia de seguridad cuando un paso de shell lleva un dato {{…}} en un workflow expuesto a la IA: el agente del chat podría inyectar texto en el comando a través de las entradas.

No puedes, y por qué

  • Que el agente llame a un workflow apagado: un workflow solo se anuncia al chat si está Disponible para el agente de IA y además Activado.​A propósito
The workflow editor on a phone: name, description, Inputs, Workflow settings, Permissions, and the Enabled and Available to AI agent switches
El editor en un móvil: nombre, descripción, Entradas, Ajustes del workflow, Permisos con su frase de resumen y los interruptores Activado y Disponible para el agente de IA.

Entradas

Valores que el workflow pide cuando se ejecuta. Los lees en cualquier campo como {{var.<nombre>}}.

Puedes

  • Añadir entrada con un Nombre (letras, dígitos y _, sin empezar por un dígito y único), un Tipo (Texto, Texto largo, Numero, Si / no, Eleccion, JSON), Obligatoria, un Valor por defecto, Opciones (separadas por comas, para Eleccion), una Etiqueta y una Descripcion (se enseña al pedirla y también a la IA). Sube o baja las entradas, o quítalas.
  • Ejecutarlo con Ejecutar ahora: un workflow con entradas obligatorias abre el diálogo Ejecutar con los valores por defecto ya puestos, así que solo cambias lo que haga falta.

No puedes, y por qué

  • Guardar con una entrada no válida: un nombre vacío, no válido o repetido, una Eleccion sin opciones, o un valor por defecto que no está entre las opciones o no es un número bloquean Guardar.​A propósito
  • Arrancar solo un workflow con una entrada obligatoria sin valor por defecto: un run programado, un evento, un atajo o una baldosa no tienen a quién preguntar. El editor avisa con Obligatorias sin valor por defecto y el programador anota un run fallido.A propósito

Ajustes del workflow

Una tarjeta plegable (Mostrar / Ocultar) con ajustes de todo el run.

Puedes

  • Tope del run entero (segundos): vacío es sin tope. Cuando vence, el run se cancela como si lo hubieras parado tú.
  • Cuando un paso falla: Parar o Continuar. Es el valor por defecto que heredan todos los pasos. Un paso que dice Continuar conserva su decisión; pero con el workflow en Continuar, ningún paso puede volver a pedir Parar.
  • Cuando ya hay un run en marcha: Saltarse el nuevo (el valor por defecto), Encolarlo (hasta 10 esperando por workflow) o Cancelar el que hay en marcha. Vale para los disparadores por evento y para los runs programados; los runs manuales y los que arranca la IA no se limitan con esto.
  • Historial que se guarda: Runs que se guardan y Dias que se guardan. Vacío significa el valor por defecto (100 runs, 30 días); puedes poner de 1 a 1000 runs y de 1 a 365 días. Los runs antiguos se recortan con la siguiente ejecución del workflow, no al guardar.

No puedes, y por qué

  • Dejar constancia de los eventos que tira Saltarse el nuevo: con la política por defecto, un evento que llega mientras el workflow está corriendo se descarta sin dejar nada en el historial, a propósito: una ráfaga de guardados escribiría una fila por evento. (Un run rechazado por la cola o por el tope global de la app sí queda anotado como cancelado, con el motivo.)A propósito

Permisos

Una tarjeta plegable propia, bajo Ajustes del workflow, para que la única decisión que puede hacer que un paso deje de ejecutarse no quede escondida dentro de un desplegable. La frase de resumen se ve incluso con la tarjeta plegada. Todo está permitido por defecto.

Puedes

  • Cambiar Salir a la red (peticiones HTTP, pasos de IA, despliegues y git push o pull), Escribir ficheros (escribir, hacer checkout y copias; leer no se toca nunca) y Ejecutar comandos (también el comando de un paso de copia de base de datos).
  • Añadir Dominios a los que puede salir: vacío significa cualquiera, github.com cubre también api.github.com, y lo que pegas se limpia (se quitan el esquema, la ruta y el puerto).
  • Contar con una regla para los subflujos: un subflujo se ejecuta con la intersección de sus permisos y los de su padre, y si las listas de dominios no tienen nada en común la red queda cerrada.

No puedes, y por qué

  • Usar los permisos como frontera de seguridad: el resumen termina con «Esto no es un cajón de arena: quien pueda editar el workflow puede cambiar estos permisos.» Te protegen de un descuido, no de un autor hostil.A propósito
  • Hacer que la lista de dominios restrinja un paso de IA, de deploy o de git: la lista solo alcanza a los pasos de Petición HTTP, y el resumen lo dice.A propósito
  • Obtener protección contra SSRF con la lista de dominios: se compara el nombre del host, no la dirección a la que resuelve, y un paso HTTP puede llegar a 127.0.0.1 o 10.x.​A propósito
Permissions card with a summary sentence saying the workflow can go out to the network, write files and run terminal commands, and that it is not a sandbox, above the Enabled and Available to AI agent switches
La tarjeta Permisos: una frase dice qué puede hacer el workflow y que no es un cajón de arena. Debajo, Activado y Disponible para el agente de IA.

Disparadores

Un workflow tiene un disparador PRINCIPAL y hasta seis en total (Añadir disparador, Hacerlo principal). Cuando dos casan con el mismo evento, arranca un solo run y gana el principal. Elige el tipo en el desplegable: hay 25. Muchos traen datos que lees como {{trigger.<campo>}}; los campos están en las tablas.

Puedes

  • Elegir cualquiera de los 25 tipos, añadir hasta 6 disparadores y subir uno a principal.
  • Montar un filtro tipado (abajo) para que el workflow arranque solo con los eventos que te interesan.
  • Pulsar Capturar bajo Capturar el próximo evento: el editor escucha 60 segundos, enseña los datos reales del próximo evento de ese tipo y los guarda como datos de ejemplo para Insertar un dato.
  • Filtrar Al hacer push por rama (por ejemplo main): los cuatro sitios que emiten un push (Projects, dos veces, el panel Git del editor y el chat de IA) mandan la rama que estaba activa, así que Deploy automático al push a main y Tests después del push a main se disparan.

No puedes, y por qué

  • Usar Proyecto cerrado y La IA terminó su turno: están en el desplegable pero nada en la app los emite, así que un workflow que arranque con ellos no se dispara nunca. El linter avisa («Hoy nadie emite PROJECT_CLOSED en la app, así que este workflow no se va a disparar.») y Capturar dice «Nada en la app emite todavía este disparador, así que esperar más no va a servir.»Aún no
  • Arrancar con un commit hecho desde el panel Control de código del editor o por el chat de IA: Al hacer commit solo se dispara con un commit hecho desde Projects.​Aún no
  • Filtrar los cuatro disparadores del sistema (Atajo en la pantalla de inicio, Baldosa de ajustes rápidos, Texto compartido a PocketCode, Fichero compartido a PocketCode): los lanza Android y el lanzador solo elige workflows por tipo, así que un filtro se ignora.Aún no
  • Leer un código de salida real en Comando terminado cuando el comando se tecleó en la terminal interactiva: ese evento llega con exitCodeKnown en falso.Aún no
  • Añadir un séptimo disparador o una novena condición (6 disparadores es el máximo. y 8 condiciones es el máximo.).​A propósito
Trigger type dropdown listing On git push, On git commit, On file save, Deploy completed, Deploy failed, An error was detected, App opened and Command finished, over a saved text filter
El desplegable de tipos de disparador, y un workflow guardado con el filtro de texto antiguo (.js) con Convertirlo en condición.
Trigger section with On git push, the message No condition: this trigger fires with every event of its type, Add condition and Capture the next event
Un disparador sin condición lo dice con palabras, y Capturar el próximo evento (botón Capturar) espera uno real.

Los 25 disparadores

Git (2)

Al hacer pushTras un push desde Projects, el panel Git del editor o el chat de IA. Campos: projectId, projectName, branch (la rama que se empujó, por ejemplo main).
Al hacer commitTras un commit hecho desde Projects. Campos: projectId, projectName, message, branch.

Ficheros (4)

Al guardar archivoCampos: filePath, language, linesChanged.
Fichero creadoCampos: filePath, fileName.
Fichero borradoCampos: filePath, fileName.
Fichero renombradoCampos: filePath, previousPath.

Proyectos y compilaciones (5)

Proyecto abiertoCuando seleccionas un proyecto. Campos: projectId, projectName.
Proyecto cerradoEstá en la lista, pero nada lo emite: no se dispara nunca.
Compilación terminadaCampos: status, exitCode, durationMs, output.
Ejecución terminadaCampos: filePath, runtime, exitCode, output.
Comando terminadoCampos: command, exitCode, output, exitCodeKnown.

Despliegues, datos y herramientas (5)

Deploy completadoCampos: provider, projectName, status, url.
Deploy fallidoCampos: provider, projectName, error.
Query ejecutadoCampos: data, format, rowCount, columns.
Respuesta del probador de APICampos: url, method, status, durationMs.
Diseño exportadoCampos: designId, designName, format.

Errores y la IA (3)

Se ha detectado un errorOye el fallo de otro workflow, los errores de compilación y de ejecución del editor, y los comandos de terminal lanzados por la IA que terminan con un código distinto de 0. Un workflow nunca se dispara a sí mismo. Campos: source, message, filePath, exitCode, workflowId, workflowName, error.
La IA cambió un ficheroUn fichero escrito por el agente de IA. Va aparte de Al guardar archivo a propósito: una escritura automática no debe disparar las automatizaciones que montaste para tu propio trabajo. Campos: filePath, fileName.
La IA terminó su turnoEstá en la lista, pero nada lo emite: no se dispara nunca.

La app y manual (2)

App abiertaCuando la app pasa a primer plano. Campo: sessionId.
Manual o programadoSin datos. Es lo que arrancas con ▶ o Ejecutar ahora, lo que arranca un horario y lo que ejecuta el chat de IA.

Desde Android (4)

Atajo en la pantalla de inicioSin datos. Mira Ejecutar y vigilar.
Baldosa de ajustes rápidosSin datos.
Texto compartido a PocketCodeCampos: text, subject.
Fichero compartido a PocketCodeCampos: uri, fileName, mimeType.

El filtro tipado

Bajo un disparador, Añadir condición (hasta 8) da un Campo (los campos de ese disparador), una Comparación y un Valor. Únelas con Todas o Alguna, y pon No a cualquiera. Sin condiciones el editor dice «Sin condiciones: este disparador salta con cada evento de su tipo.» Al cambiar el tipo se quitan las condiciones cuyo campo no existe en el tipo nuevo y te lo dice. Un workflow guardado con el filtro de texto antiguo lo conserva como Filtro de texto, sigue funcionando, con Convertirlo en condición.

ComparaciónQué hace
es igual aEl campo es igual al valor.
contieneEl campo contiene el valor.
empieza por / acaba enEl campo empieza o acaba con el valor.
coincide con la rutaUn glob para campos de ruta: un asterisco no cruza carpetas, dos sí, y un punto delante casa con la extensión.
es uno deEl campo es uno de varios valores separados por comas.
está vacíoEl campo no tiene valor.
es mayor que / es menor queComparación numérica. Si algún lado no es un número, la condición no se cumple.

Pasos: el árbol, la tarjeta y la paleta

La lista de Pasos es un árbol: los bloques se anidan dentro de otros bloques. Los pasos se numeran 2, 2.1; una rama de else se lee 2.e1, una de catch 2.c1 y una rama paralela 2.<n>. Los bloques se pueden plegar (Plegar / Desplegar), y un paso muy anidado recibe un aviso como 5 niveles de anidamiento que dice que se ejecuta igual pero deja de caber en la pantalla de un móvil.

Puedes

  • Tocar el botón + (Añadir paso) para abrir la paleta: buscar por nombre, descripción o salida («Nombre, descripción o salida (stdout, url…)»), elegir un chip de categoría (Shell, Git, Despliegue, IA, Datos, HTTP, Ficheros, Control, Aviso, Otros) y usar favoritos y los últimos 5 recientes. Cada entrada enseña lo que da (Da: …) y marca irreversible, ejecuta comandos, usa la red, escribe archivos o No se puede simular. El paso nuevo cae al final del hueco que elegiste y se abren sus ajustes.
  • En cada tarjeta: el asa para reordenar, el número, el título y un resumen de una línea, un interruptor Activo / Desactivado (un paso Desactivado se salta y no cuenta como fallo), el chip Si este paso falla, Probar este paso, el lápiz (abre los ajustes y selecciona el paso) y el menú ⋮.
  • En el menú: Subir, Bajar, Copiar paso, Pegar debajo (solo activo si el portapapeles trae pasos de PocketCode, así que puedes pegar en otro workflow), Duplicar, Nota (solo se ve en el editor), Convertir en subflujo y Borrar.
  • Reconocer datos fijados: la tarjeta de un paso con una salida fijada muestra dato de ejemplo.

No puedes, y por qué

  • Arrastrar un paso a otro bloque: el asa mueve un paso una posición por cada 48 dp de arrastre dentro de su propia lista; usa Subir y Bajar del menú.A propósito
  • Dibujar el flujo como un grafo, o usar un switch de N ramas o una unión libre: el flujo es un árbol anidado, Si / Si no tiene exactamente dos ramas y En paralelo une sus ramas con una de tres políticas.A propósito
  • Editar un paso que la app no conoce (Paso desconocido, escrito por una versión más nueva): se conserva tal cual y solo se puede mover o borrar.A propósito
Add step sheet with a search box, category chips and the Run terminal command and Git operation entries showing what they give back
Añadir paso: búsqueda por nombre, descripción o salida, chips de categoría y lo que da cada acción. La pista bajo Operación git es anterior a la acción: maneja siete operaciones, no tres.
Step tree with an If step, steps 2.1 and 2.2 under If it matches and 2.e1 under Otherwise
Una rama de la plantilla Tests y, si pasan, deploy: 2.1 y 2.2 bajo Si se cumple, 2.e1 bajo Si no. El paso de deploy ofrece Ejecutar este paso de verdad porque no se puede simular.

Los siete tipos de paso

TipoQué haceQué fijas
AcciónEjecuta una de las 15 acciones.Los parámetros de la acción. Solo en una acción: Fiabilidad (reintento, tiempo límite) y Condicional (Cuándo).
Si / Si noEjecuta Si se cumple cuando la condición es verdadera y Si no cuando no lo es.Un árbol de condiciones con Y, O y NO.
BucleRepite sus pasos Por cada elemento de una lista.Lista por la que iterar, Nombre de cada elemento (se lee como {{item.<nombre>}}), Vueltas como maximo (100 por defecto, nunca más de 10 000) y Vueltas a la vez (con 1 van una detrás de otra, hasta 16).
En paraleloEjecuta varias ramas a la vez.Ramas (añade una, o quita una que esté vacía) y Cuando se sigue adelante: Cuando acaben todas, Con la primera que termine o Con la primera que salga bien. Las dos últimas cancelan las ramas que pierden, a medias y con sus efectos a medias.
Intentar / si fallaEjecuta Intenta esto; si algo de ahí falla, ejecuta Si falla.Nombre del error (error por defecto, se lee como {{var.error}}, hasta 4 096 caracteres).
SubflujoEjecuta otro workflow con los valores que le des y usa su último resultado.Workflow a ejecutar y Valores para el subflujo. Hasta 5 niveles de profundidad, sin recursión, y los permisos son la intersección con los del padre.
EsperaPausa el workflow un tiempo, o hasta que ocurra algo.Un tiempo en milisegundos, o Esperar a que ocurra algo con Evento que se espera, un filtro opcional (la misma regla que en un disparador) y Tope en milisegundos (5 minutos si no pones ninguno).

Acciones

Quince acciones, en ocho categorías de la paleta. Cada una lista las salidas que puedes leer como {{step.<id>.output.<clave>}}; los nombres de abajo son las claves. Las etiquetas son las que enseña la paleta en español.

Shell (1)

Comando de terminalEjecuta un comando en la shell de la terminal. Parámetros: command, cwd, env, failOnNonZero (activado por defecto), timeoutMs. Salidas: command, exitCode (-1 si lo mató el tope), stdout, stderr (cada una limitada a 64 KB, cabeza y cola), durationMs, timedOut.

Git (1)

Operación gitSiete operaciones: status, commit, push, pull, checkout, log, diff. Parámetros: operation, message, branch (letras, dígitos, ., _, /, -), n (20 por defecto), path, projectPath. Salidas: sha, branch, changedFiles, ahead, behind, text. Solo push (o una operación que viene de un dato) cuenta como irreversible; commit, pull y checkout escriben ficheros; status, log y diff no tocan nada. diff es por fichero.

Despliegue (1)

Lanzar deployDispara un deploy en render, netlify, digitalocean o railway y espera el veredicto del proveedor (15 minutos por defecto, de 1 a 60). Parámetros: provider, project, timeoutMs; branch y env se registran pero no se respetan. Salidas: status, url, provider, projectName, logsTail, durationMs, timedOut. No se puede simular: Probar ahora lo salta y la prueba de paso ofrece Ejecutar este paso de verdad. En Free falla con «Se requiere upgrade para lanzar otro deploy activo» cuando ya hay un deploy de ese proyecto en vuelo (en cola, construyendo o desplegando), y ves un aviso de que la acción necesita PocketCode Pro.

IA (2)

Pedir análisis a la IAManda un prompt, con contexto opcional, a tu proveedor de IA activo. Parámetros: prompt, context, outputFormat (TEXT o JSON), schema. Salidas: text, json (solo en modo JSON) y tokensEst, una estimación local de los tokens, no el recuento del proveedor.
Pedir generación a la IALo mismo, enfocado a generar código. Parámetros: prompt, context, language. Salidas: text, tokensEst. No escribe ficheros; usa Escribir archivo con su text.

Datos (4)

Consultar base de datosEjecuta SQL contra una conexión con nombre: neon, supabase, turso, upstash o cloudflare (D1), o contra una de tus conexiones PostgreSQL guardadas (por nombre o id). Parámetros: connection, sql, maxRows (200 por defecto, 5 000 como máximo), allowWrites. Salidas: rows, rowCount, columns, truncated, durationMs, message, writes. Una consulta con verbos de escritura (DROP, DELETE, TRUNCATE, UPDATE, INSERT, ALTER, CREATE, GRANT), o con SQL que viene de un dato, cuenta como irreversible y falla si allowWrites está apagado. La pista de la paleta dice que es de solo lectura; no lo es.
Backup de base de datosEjecuta tu propio comando de copia (por ejemplo pg_dump); sin comando solo sabe copiar la base de datos interna de PocketCode. Parámetros: connection, command, outputDir, timeoutMs (10 minutos). Salidas: filePath, sizeBytes, tables, exitCode, stdout, stderr, timedOut, durationMs.
Definir variableParámetros: name, value. Salidas: name, value. Escribe {{var.<nombre>}} para los pasos siguientes (el valor también se puede leer como {{step.<id>.output.value}}). Una prueba en seco (Probar ahora) no escribe la variable.
Transformar valorEvalúa una expression con los filtros y devuelve value. Sin efectos, y una prueba en seco hace lo mismo que un run real.

HTTP (1)

Petición HTTPParámetros: method, url, headers (JSON), authorization (un secreto), body, contentType, timeoutMs (de 1 000 a 120 000, 30 000 por defecto), followRedirects. Salidas: status, headers, body (hasta 128 KiB), json, durationMs, bodyTruncated, finalUrl, redirects. Solo http y https; hasta 5 redirecciones, y las credenciales nunca pasan a otro origen.

Ficheros (4)

Leer archivoParámetro: path. Salidas: content (hasta 128 KiB), sizeBytes, exists, contentTruncated, filePath.
Escribir archivoParámetros: path, content, append. Salidas: filePath, sizeBytes, bytesWritten, overwritten. Nunca se cuenta como irreversible, ni siquiera cuando sobrescribe.
Comprobar si existeParámetro: path. Salidas: exists, isDirectory, sizeBytes, filePath.
Abrir archivo en el editorParámetros: file, line. Salidas: opened (verdadero solo si el editor lo confirma en 1,5 segundos, así que es falso con la app en segundo plano), file, line.

Aviso (1)

Mostrar notificaciónParámetros: title, message, deepLink (solo pocketcode://workflows/…), importance (LOW, DEFAULT, HIGH). Solo HIGH usa el canal Workflows · avisos; el resto va al canal silencioso Workflows. Salidas: notificationId, delivered (significa que el evento salió hacia el sistema de notificaciones, no que lo hayas visto; es falso en una prueba en seco), deepLink, importance.
  • Las tres acciones de fichero que leen o escriben (Leer archivo, Escribir archivo, Comprobar si existe) quedan acotadas a la raíz del proyecto; Comando de terminal y Operación git no.
  • En la paleta, irreversible marca el peor caso del tipo; el diálogo de confirmación, la prueba de paso y el panel Problemas miran los valores que de verdad escribiste.

No puedes, y por qué

  • Desplegar en cualquier proveedor: solo render, netlify, digitalocean y railway tienen una llamada que dispara un deploy, y la rama y el entorno no se respetan.Terceros
  • Consultar una conexión guardada que no sea un PostgreSQL remoto (la base local embebida, MySQL y el resto): desde un workflow solo se llega a neon, supabase, turso, upstash, cloudflare (D1) y a tus conexiones PostgreSQL guardadas.Terceros
  • Hacer copia de cualquier base de datos sin un comando: sin command el paso solo sabe copiar la base de datos interna de PocketCode.Aún no

Condiciones: Si / Si no y Cuándo

Un paso Si / Si no lleva un árbol de condiciones y dos ramas. Un paso de tipo Acción también puede llevar Cuándo (expresión), bajo Condicional: el paso se salta si la expresión resuelve a vacío, false, 0 o null. Cuándo existe solo en los pasos de acción.

Puedes

  • Montar la condición con Añadir condicion y Añadir grupo, combinar con Y, O y NO, y usar Agrupar y Quitar. Un grupo vacío se cumple siempre.
  • Ver Se cumple o No se cumple, evaluado con tus datos de ejemplo fijados, no con el próximo run.

No puedes, y por qué

  • Poner Cuándo en un bucle, un paralelo, un intentar, un subflujo, una espera o un Si / Si no: solo lo tiene un paso de acción.A propósito
OperadorVerdadero cuando
es igual a / no es igual aLos dos valores son iguales, o no.
mayor que / menor queComparación numérica.
mayor o igual / menor o igualComparación numérica, inclusiva.
contiene / empieza por / acaba enComparación de texto.
casa conUna expresión regular (que sea corta).
es uno deEl valor es uno de varios separados por comas.
es nulo / esta vacio / es verdaderoComprueba el propio valor.
siempreSiempre verdadero.

Variables y expresiones

Cualquier parámetro admite un literal o una expresión entre llaves dobles: {{ raíz.campo[0] | filtro:"arg" | filtro }}. Insertar un dato abre un selector (Entradas, Disparador, Pasos anteriores, Estado del paso, y el elemento o el error del bloque en el que estás), así que nunca escribes un id de paso a mano; avisa «Dentro de una rama: puede no haberse ejecutado.» y «Dentro de un bucle: queda la ultima iteracion.» Una referencia que no resuelve da una cadena vacía. \{{ escribe un {{ literal. Los argumentos de un filtro van siempre entre comillas dobles: replace:a:b es un error de sintaxis, replace:"a":"b" funciona.

Puedes

  • Encadenar filtros con | tras cualquier referencia.
  • Fijar una salida como dato de ejemplo, para que Insertar un dato y Si / Si no puedan previsualizar con ella.

No puedes, y por qué

  • Añadir tus propias funciones o ejecutar código en una expresión: la lista de 13 filtros es cerrada, sin funciones de usuario ni eval; las rutas, cadenas de filtros o textos entre llaves demasiado largos se rechazan al analizarlos.A propósito
ExpresiónResuelve a
{{var.<nombre>}}Una entrada declarada (incluidos los valores de Ejecutar con estas entradas y los valores por defecto de un horario o un atajo), el nombre del error de un Intentar / si falla, los valores que un Subflujo pasa a su hijo, y el valor que escribe un paso Definir variable (una prueba en seco no lo escribe).
{{step.<id>.status}}SUCCESS, FAILURE, SKIPPED, TIMED_OUT, o RUNNING para un paso que aún corre.
{{step.<id>.output}}El mapa de salida del paso, o un campo suyo: {{step.<id>.output.json.items[0].name}} entra en el JSON con [n].
{{step.<id>.error}}El mensaje de error de un paso que falló.
{{item.<alias>}}El elemento actual de un Bucle (el alias a secas también vale).
{{trigger.<campo>}}Los datos del evento que arrancó el run; {{trigger.type}} dice cuál de los disparadores del workflow fue (MANUAL si no hubo evento).
{{secret.<NOMBRE>}}Un secreto guardado. Es terminal: no se puede navegar dentro.

Los 13 filtros

FiltroQué hace
linesParte el texto en líneas; se descarta un salto final.
first / lastEl primer o el último elemento de una lista, o el primer o el último carácter de un texto. Falla con vacío.
trim / upper / lowerQuita espacios, pasa a mayúsculas, pasa a minúsculas.
lengthEl número de elementos de una lista o de caracteres de un texto.
jsonMuestra el valor como JSON.
default:"x"Un valor de respaldo cuando el valor falta o está vacío.
split:","Parte un texto por un separador y lo convierte en lista.
join:","Une una lista con un separador.
date:"HH:mm"Da formato a una fecha en milisegundos epoch o ISO, en la zona horaria del dispositivo.
replace:"a":"b"Sustituye texto; el texto a sustituir no puede estar vacío.

Ejemplos

{{step.<id>.output.stdout | lines | first | trim}}La primera línea de la salida de un comando, sin espacios.
{{step.<id>.output.json.items[0].name | default:"none"}}Un campo dentro de una respuesta JSON, con valor de respaldo.
{{trigger.filePath | replace:"src/":""}}La ruta del fichero guardado sin un prefijo.

Bucles, paralelo, intentar / si falla y subflujos

Los bloques del árbol, con los límites que importan en la práctica.

Puedes

  • Bucle: hasta 10 000 vueltas (100 por defecto) y hasta 16 a la vez; con Vueltas a la vez por encima de 1 van por lotes.
  • En paralelo: Cuando acaben todas espera a todas las ramas y falla si una falla; Con la primera que termine y Con la primera que salga bien cancelan las demás.
  • Intentar / si falla: la rama de fallo lee el mensaje en {{var.<nombre>}}; el fallo sigue apareciendo en el historial.
  • Subflujo: monta una parte una vez y llámala desde varios workflows; Convertir en subflujo extrae un paso y todo lo que lleva dentro a un workflow nuevo, apagado, y deja en su sitio un paso de subflujo, avisando de las referencias que se van a romper (Van a resolver a nada, en silencio.).

No puedes, y por qué

  • Anidar subflujos más de 5 niveles o dejar que un workflow se llame a sí mismo: un subflujo recursivo se salta y el linter avisa.A propósito
  • Repetir un bucle más de 10 000 veces o ejecutar más de 16 vueltas a la vez, diga lo que diga el campo.A propósito

Reintento, tiempo límite y fallo

Abre los ajustes de un paso de acción y despliega Fiabilidad. Estos campos existen solo en los pasos de acción.

Puedes

  • Fijar Intentos máximos (1 significa sin reintento), Espera progresiva (un campo de texto: EXPONENTIAL, LINEAR o FIXED), Retardo inicial (ms), Retardo máximo (ms) y Tiempo límite (ms) (vacío significa sin tope).
  • Contar con que un tiempo límite se reintenta: un paso que agota su tiempo se marca TIMED_OUT y, si quedan intentos, se repite como cualquier otro fallo.
  • Elegir Si este paso falla: Parar (el run acaba aquí), Continuar (sigue y el fallo queda en el historial) o Usar el ajuste del workflow. Con Continuar el paso queda rojo y el run aun así puede acabar verde.
  • Leer el resultado en el detalle del run: acerto al intento n, o n intentos si nunca acertó.

No puedes, y por qué

  • Poner un reintento o un tiempo límite a un bucle, un paralelo o cualquier otro bloque de control: los campos existen solo en pasos de acción. El tope de todo el workflow está en Ajustes del workflow.​A propósito

Probar un paso, fijar datos, probar el workflow

Puedes probar cosas sin ejecutar el workflow entero.

Puedes

  • Tocar Probar este paso: simula el paso con tus datos fijados como contexto y dice Simulado en n ms: no se ha tocado nada. Avisa Sin salida fijada de: … cuando una referencia apunta a un paso sin nada fijado.
  • Cuando la acción no se puede simular (hoy solo Lanzar deploy), o los valores que escribiste serían irreversibles, el botón es Ejecutar este paso de verdad. Pregunta antes: solo se ejecuta ese paso, el resto del workflow no se toca y el run no se guarda en el historial.
  • Fijar la salida de un paso (y Soltar para quitarla) como dato de ejemplo para el selector y las vistas previas. Las salidas fijadas viven en el dispositivo, hasta 50 pasos por workflow, y se descartan a los 14 días.
  • Tocar Probar ahora (o pulsar Ctrl+Enter) para hacer una prueba en seco de todo el workflow tal como está en pantalla, no como se guardó por última vez. Muestra Prueba superada o Prueba fallida y n pasos · n ms · no se guarda. Una prueba en seco no guarda ningún run ni dispara eventos.

No puedes, y por qué

  • Probar un bloque de control de flujo por sí solo: «Solo se pueden probar los pasos de acción: probar una rama o un bucle es ejecutar lo que llevan dentro.»A propósito
  • Usar secretos en una prueba en seco: no se resuelven, y el paso se salta diciendo cuáles usa.A propósito
  • Exportar o sincronizar las salidas fijadas: se quedan en el dispositivo.A propósito

Problemas

El linter corre mientras editas y lista Errores, Avisos y Sugerencias con un contador de cada uno. Cada fila nombra la regla, el paso (Paso: … o Todo el workflow) y tiene Ir al paso. Si no hay nada dice Nada que arreglar. El mismo linter revisa lo que genera la IA y lo que importas.

Puedes

  • Arreglar lo que señala un aviso, o dejarlo: solo las tres reglas que son errores bloquean Guardar.
  • Saltar directamente al paso con Ir al paso.

No puedes, y por qué

  • Guardar con un error (un nombre vacío, ningún paso, un parámetro obligatorio vacío): las tres reglas de error son las que dejarían el workflow ilegible o imposible de guardar. Todo lo demás, reglas de permisos incluidas, avisa y no bloquea, porque quien cierra la red suele hacerlo antes de quitar el paso que la usaba.A propósito
Problems panel with one warning about an unquoted binding and Go to step, above a step card with On, default: Stop and Test this step
El panel Problemas sobre un paso: un aviso de un dato que entra sin comillas en el comando, con Ir al paso. La tarjeta muestra Activo, por defecto: Parar y Probar este paso.

Las 34 reglas

GrupoReglas
Estructura (6)Error: el workflow no tiene nombre; no tiene pasos. Aviso: una rama vacía; un paso que no se puede ejecutar nunca. Sugerencia: un paralelo con una sola rama; demasiado anidamiento.
Parámetros (3)Error: un parámetro obligatorio está vacío. Aviso: un parámetro que la acción no tiene; un tipo de acción que ningún host instalado sirve.
Referencias (7)Todos avisos: una referencia que no va a resolver nunca; una que lee un paso que se ejecuta después; una salida que el paso no devuelve; un campo del disparador que el disparador no trae; una variable sin declarar; una referencia a un paso desactivado; una referencia que entra sin comillas en un comando de shell.
Disparadores (3)Aviso: un disparador que nadie emite; un filtro sobre un campo que el disparador no trae. Sugerencia: el mismo disparador dos veces con el mismo filtro.
Bucles (3)Todos avisos: sin lista por la que iterar; un alias ya cogido; sin alias.
Fiabilidad (2)Avisos: un tiempo límite absurdo; un reintento absurdo.
Seguridad (2)Avisos: un secreto escrito en claro; un paso irreversible en un workflow que solo se ejecuta solo.
Permisos (4)Avisos: un paso que sale a la red, escribe ficheros o ejecuta un comando con ese permiso cerrado; un paso que va a un dominio que no está en la lista.
Coherencia (4)Avisos: expuesto a la IA sin descripción; una entrada obligatoria sin valor por defecto en un disparador por evento; un subflujo recursivo; un subflujo que no apunta a nada.

Ejecutar y vigilar

Cada run se anota en el historial cuando termina: el resultado de cada paso, cuánto tardó, cuántos intentos necesitó y su error. Cuánto se conserva se fija por workflow en Ajustes del workflow: de 1 a 1 000 runs y de 1 a 365 días (por defecto, 100 runs y 30 días). Lo que puede arrancar un run también puede pararlo.

Arrancar y parar un run

Un run arranca desde un disparador, desde ▶ o Ejecutar ahora, desde un horario, desde el chat de IA, o desde un atajo, la baldosa o el menú Compartir. Entre todos los workflows la app ejecuta hasta 8 runs a la vez y deja hasta 16 esperando hasta 120 segundos; más allá, el run se anota como cancelado con el motivo «la app ya estaba ejecutando demasiados workflows a la vez».

Puedes

  • Tocar ▶ en la tarjeta de un workflow cuyo disparador principal es Manual o programado, o Ejecutar ahora en el menú de cualquier workflow. Si declara entradas obligatorias, antes se abre el diálogo Ejecutar («Este workflow necesita estos valores antes de arrancar.») con los valores por defecto puestos.
  • Pararlo desde la tarjeta, el menú, el historial, Actividad, el detalle del run o el aviso. El run acaba como Cancelado.
  • Activar un workflow que tiene pasos irreversibles: un diálogo titulado «Este workflow hace algo que no se puede deshacer» los lista (Paso n · …) y eliges Activar de todos modos. Se pregunta una vez por workflow y se recuerda en el dispositivo, sin sincronizarse ni exportarse.
  • Guardar un workflow con Disponible para el agente de IA encendido y pasos irreversibles: ¿Dejar que la IA ejecute este workflow? (Permitir a la IA), también una vez. Sin ese permiso, la herramienta del agente se niega a ejecutarlo y le dice al modelo a quién pedírselo.

No puedes, y por qué

  • Que te pregunten por los pasos irreversibles al pulsar Activar en una plantilla, al usar Guardar y activar en el generador o al importar un fichero (un fichero importado llega apagado, y la pregunta sale cuando lo enciendes).Aún no
  • Que te avisen de que vas a sobrescribir un fichero: Escribir archivo nunca se cuenta como irreversible, ni siquiera cuando sobrescribe; su salida overwritten te lo dice después. Solo cuentan un push de Git (o una operación de Git que viene de un dato) y el SQL con verbos de escritura (o SQL que viene de un dato).A propósito

Pestaña Actividad

Los últimos runs de todos los workflows, los vivos primero, de 50 en 50.

Puedes

  • Buscar en los errores: mira el mensaje del run y el de cada paso.
  • Filtrar por estado (Completado, Fallido, Cancelado), por fecha (Cualquier fecha, Hoy, Ultimos 7 dias, Ultimos 30 dias) y por workflow (Todos los workflows, incluidos los que ya borraste); Quitar limpia los filtros.
  • Cargar mas añade otros 50, parar un run vivo y tocar un run para abrir su detalle.
  • Copiar los runs filtrados como JSON con Exportar como JSON: pone el texto en el portapapeles.
  • Borrar historial tras una confirmación («Los runs desaparecen. Los workflows se quedan como estan.»), de todos los workflows o solo del filtrado.

No puedes, y por qué

  • Ir más atrás de los 500 runs más recientes: «Hasta aqui llega esta pantalla. Afina el filtro para encontrar algo mas antiguo.»A propósito
  • Exportar el historial a un fichero: Exportar como JSON solo copia el texto.Aún no

Historial de un workflow

Historial de ejecuciones en una tarjeta lista los runs de ese workflow, el más reciente primero.

Puedes

  • Ver el estado y la hora de cada run, su número de pasos, Disparado por … y, en uno cancelado, Cancelado por …; un run que sigue en marcha lleva En marcha.
  • Parar esta ejecución, o abrir un run para ver su detalle.
  • Si aún no hay ninguno dice «Sin ejecuciones todavía: lanza este workflow para crear historial.»

No puedes, y por qué

  • Leer con palabras todos los motivos de cancelación: la app traduce el run anterior seguia en marcha, la cola estaba llena y «la app ya estaba ejecutando demasiados workflows a la vez»; los demás motivos (user, timeout, superseded, scope) se enseñan como la palabra tal cual.Aún no

Detalle de un run

Abre un run desde el historial, Actividad, un aviso de run o un enlace profundo.

Puedes

  • Leer la cabecera (estado, duración, disparador, quién lo cortó) y cada paso: resultado, duración, acerto al intento n o n intentos, el error y la salida como un árbol JSON que puedes expandir y copiar. Un paso que seguía corriendo cuando acabó el run dice Interrumpido; uno que ya no está en el workflow dice Este paso ya no esta en el workflow.
  • Seguir la Salida en vivo de la shell mientras el run corre, buscar en ella (Buscar en el log) y copiarla (Copiar el log). De cada paso solo se conservan las últimas 500 líneas, y la pantalla avisa cuando se han tirado líneas antiguas.
  • Analizar el run con IA, o Analizar con IA en un paso: abre el chat con un prompt ya escrito.
  • Copiar como JSON copia el run.

No puedes, y por qué

  • Leer el log de shell de un run que ya terminó: «El log de shell no se guarda en el historial: solo se ve mientras el run corre.»A propósito
  • Encontrar un run que estaba en vuelo cuando el sistema mató la app: un run se escribe una sola vez, cuando acaba, y al arrancar no se recupera nada, así que un run interrumpido no deja ninguna fila.A propósito
  • Ver un secreto guardado: los valores se tapan como ••• cuando se escribe el run, así que tampoco están en la base de datos. Un valor de menos de 4 caracteres no se puede tapar.A propósito

Volver a ejecutar, repetir desde el paso fallido, ejecutar con entradas

Tres botones al pie del detalle, y los tres terminan en el diálogo Repetir este run.

Puedes

  • Volver a ejecutar ejecuta el workflow desde el principio.
  • Repetir desde el paso fallido ejecuta otra vez desde el primer paso que falló, reutilizando los resultados de los pasos anteriores (Se reutilizan n resultados anteriores.). Solo sale si el run terminó y tiene un paso fallido.
  • Ejecutar con estas entradas vuelve a pedir las entradas antes de ejecutar.
  • Leer el diálogo antes de confirmar: dice «Se ejecuta el workflow tal como esta ahora, no como estaba cuando paso este run.», si el workflow se editó después, qué pasos ya no existen, cuáles se añadieron y dónde se reanuda.

No puedes, y por qué

  • Reutilizar las entradas del run antiguo: «Las entradas de aquel run no se guardan, asi que se usan los valores por defecto declarados.» Podrían ser tokens.A propósito
  • Reanudar desde un paso anidado dentro de un bloque: solo un paso de primer nivel puede ser el punto de reanudación.A propósito
  • Repetir un run cuyo workflow borraste: «El workflow ya no existe: este run no se puede repetir.»A propósito

Avisos de ejecución

Un run que está vivo muestra un aviso persistente con Paso n de m y un botón Parar. Mientras hay runs en marcha PocketCode mantiene un servicio en primer plano del tipo uso especial, para que Android no pare la app a medias.

Puedes

  • Seguir un run desde la bandeja de notificaciones y pararlo desde ahí; el botón de parar solo alcanza a runs vivos de esta app.
  • Mandar tu propio aviso con un paso Mostrar notificación. Su importancia decide el canal: HIGH va a Workflows · avisos, lo demás al canal silencioso Workflows. Los dos siguen los ajustes de notificaciones de la app: el interruptor global, los interruptores de alertas y de avisos, el permiso de notificaciones de Android y las horas de silencio.
  • Tocar un aviso: un enlace a pocketcode://workflows/… abre el run o el workflow; cualquier otro enlace se descarta y el aviso solo abre la app.

No puedes, y por qué

  • Recibir un aviso automático cuando un run falla: PocketCode no manda ninguno. Si quieres uno, añade un paso Mostrar notificación en una rama Intentar / si falla, o monta un workflow que arranque con Se ha detectado un error. (El chat de IA puede mostrar un aviso Workflow '…' failed con un botón Probar, pero solo dentro del chat.)Aún no
  • Tener un aviso de progreso para todos los runs: solo los 5 primeros runs simultáneos lo tienen; el resto corre sin él.Dispositivo
  • Contar con el servicio en primer plano cuando la app está en segundo plano: desde Android 12 el sistema puede negarlo (por ejemplo en un run programado con el móvil en el bolsillo). El run sigue, sin esa protección, y PocketCode lo vuelve a pedir cada 30 segundos.Google Play

Atajo, baldosa de Ajustes rápidos y Compartir

Tres formas de lanzar un workflow sin abrir el módulo. Cada una necesita el disparador correspondiente en el workflow (Atajo en la pantalla de inicio, Baldosa de ajustes rápidos, Texto compartido a PocketCode o Fichero compartido a PocketCode), y el workflow encendido.

Puedes

  • Atajo: cada workflow encendido con el disparador de atajo aparece como atajo dinámico del icono de la app (la etiqueta se corta a 30 caracteres). Al tocarlo ejecuta el workflow sin abrir nada y muestra Workflow lanzado. Un atajo fijado de un workflow borrado o apagado lo avisa.
  • Baldosa: arrastra Lanzar un workflow a Ajustes rápidos. Si ningún workflow la usa, dice Ningun workflow usa esta baldosa; con uno, lo ejecuta; con varios, enseña un selector.
  • Compartir: comparte texto, una imagen, JSON, XML, un zip, un PDF o un fichero binario genérico a Lanzar un workflow desde otra app. Una hoja titulada Mandar a un workflow siempre enseña lo recibido (Lo compartido es un dato, no una orden.) y qué workflow lo recibe; si hay varios, eliges uno. Los datos llegan como {{trigger.text}}, {{trigger.subject}}, {{trigger.uri}}, {{trigger.fileName}}, {{trigger.mimeType}}, y una entrada declarada con el mismo nombre manda.
  • Si nada escucha, lees «Ningun workflow activo escucha esto. Añade el disparador en el editor de workflows.»

No puedes, y por qué

  • Lanzar con estos tres un workflow cuya entrada obligatoria no tiene valor por defecto: dice … necesita antes un valor en vez de ejecutarse a ciegas.A propósito
  • Compartir varios elementos a la vez, texto de más de 32 768 caracteres (se corta y te lo dicen) o un fichero de más de 25 MB. Un fichero compartido se copia dentro de PocketCode y se borra a las 24 horas; la lista de tipos aceptados es fija, no vale cualquiera.A propósito
  • Contar con el número de atajos: Android decide cuántos enseña un lanzador (al menos 5, normalmente 4 o 5), y la baldosa es opcional, tienes que arrastrarla tú.Dispositivo
  • Abrir un .pcwf.json desde otra app directamente: el menú Compartir manda el fichero al disparador Fichero compartido a PocketCode, no al importador. Importa con Importar un workflow desde un fichero.​A propósito

Programar

Cualquier workflow puede llevar varios horarios, desde el icono del reloj o Programar en su menú (Horarios de …). Se ejecutan con WorkManager de Android, con la holgura que eso implica, y se vuelven a armar al arrancar la app.

Puedes

  • Leer los horarios que hay (Cada n min o Cron: …, Próx.: …, sus condiciones, un aviso si el intervalo se sube, Recupera una ejecución perdida) y Quitar cualquiera.
  • Añadir uno con un preajuste o con Cron personalizado: cinco campos, min hora día mes semana, por ejemplo 0 9 * * 1. La hoja muestra Próxima ejecución: … o Expresión cron no válida, y Añadir cron lo guarda. El cron admite *, números, listas, rangos, */n, nombres (SUN–SAT, JAN–DEC) y rangos que dan la vuelta solo en mes y día de la semana; el día de la semana va de 0 a 6, y 7 significa domingo.
  • Elegir Condiciones del dispositivo antes de crearlo: Sin requisito, Cualquier conexión o Solo Wi-Fi, y además Solo mientras carga, No con la batería baja y Solo con el dispositivo inactivo. Una condición retrasa la ejecución, no la cancela: cuando la condición por fin se cumple, la ejecución pendiente sale igual, aunque sea horas más tarde.
  • Activar Ejecutarla una vez al volver bajo Si se pierde una ejecución: una ejecución que cayó con el dispositivo apagado se ejecuta una vez en el siguiente arranque de la app (con una tolerancia de 15 minutos), se hayan perdido las que se hayan perdido. Viene apagado por defecto, así que la ejecución perdida se salta.
  • Contar con el cambio de hora: la hora que no existe en primavera dispara en el salto, y la que ocurre dos veces en otoño dispara una sola vez (un cron de grano fino pierde la segunda pasada de esa hora).
  • Contar con los reintentos: un run programado que falla se intenta hasta 4 veces en total (la primera más 3 reintentos) con el retroceso exponencial de WorkManager. Si un run sigue en marcha cuando toca el siguiente, decide la política de concurrencia; con Saltarse el nuevo el run se anota como cancelado, el run anterior seguia en marcha.
  • Leer el aviso «Los workflows programados necesitan atención» sobre las pestañas: sale cuando las notificaciones de PocketCode están apagadas, cuando el canal Workflows · avisos está bloqueado o cuando la app está sujeta a la optimización de batería («Android puede retrasar las ejecuciones programadas. No las cancela, salen más tarde.»). Tiene Abrir ajustes y no tiene botón de descartar; desaparece cuando desaparece la causa.

No puedes, y por qué

  • Tener una garantía por debajo de 15 minutos: Android no ejecuta trabajo programado más a menudo que cada 15 minutos. Un intervalo menor se sube a 15 y la hoja lo dice («Pide cada n min, pero se ejecuta cada 15 min: es el suelo que permite Android.»); a un cron por debajo de eso le sale «Android no garantiza ese ritmo en segundo plano». PocketCode no pide ni el permiso de alarmas exactas ni la exención de la optimización de batería.Google Play
  • Escribir un intervalo propio: solo se ofrecen tres intervalos como preajustes (cada 15 minutos, cada hora, cada 6 horas); cualquier otro ritmo es una expresión cron. Un intervalo no puede pasar de unos 30 días.A propósito
  • Elegir una zona horaria: no hay selector, y un horario nuevo lee su cron en la zona del dispositivo (cada horario guarda una zona, pero la pantalla no la expone).Aún no
  • Editar un horario o sus condiciones: quítalo y añade otro.A propósito
  • Usar ?, L, #, un paso sobre un rango (1-9/2) o un campo de año en un cron. Un cron que no dispara nunca (por ejemplo el 31 de febrero) apaga el horario.A propósito
  • Que el aviso te hable de los matadores de batería de cada fabricante: solo dice lo que Android contesta (notificaciones apagadas, canal bloqueado, optimización de batería).Dispositivo

Los preajustes

PreajusteQué añade
Cada 15 minutosUn intervalo de 15 minutos, el suelo de Android.
Cada horaUn intervalo de 60 minutos.
Cada 6 horasUn intervalo de 6 horas.
A diario a las 9:00El cron 0 9 * * *.
Los lunes a las 9:00El cron 0 9 * * 1.

Secretos

Gestionar secretos (el icono de la llave de la lista) es una lista de nombres sin valores. Un secreto se referencia como {{secret.NOMBRE}} en cualquier parámetro, así que nunca hace falta escribir un token dentro de un workflow, donde se guardaría tal cual, viajaría al exportarlo y saldría en el historial de ejecuciones.

Puedes

  • Añadir un secreto: un Nombre en mayúsculas, dígitos y guion bajo (si el nombre no se puede usar en una expresión, la pantalla sugiere uno, Usar …) y un Valor. Es el nombre que usan los pasos, así que cambiarlo después los rompe.
  • Cambiar el valor: los workflows que lo usan cogen el valor nuevo en su próxima ejecución.
  • Borrar: un diálogo lista los workflows que lo referencian y avisa de que el valor no se puede recuperar y de que un workflow que pierde su secreto no falla al guardarse, falla en su próxima ejecución mandando un valor vacío.
  • Leer «Se guardan cifrados en este dispositivo, uno por cuenta. Los valores no se vuelven a enseñar, tampoco aquí.»

No puedes, y por qué

  • Volver a ver un valor después de guardarlo, o guardar uno vacío («Un valor vacío no se guarda. Para quitar un secreto, bórralo.»).A propósito
  • Que un valor se tape en el historial de ejecuciones si tiene menos de 4 caracteres: se guarda, pero la pantalla avisa «Cuidado: este valor tiene menos de 4 caracteres, así que NO se tapará» y un paso que lo imprima lo deja legible ahí.A propósito
  • Abrir el almacén tras restaurar el teléfono o cambiar el bloqueo de pantalla: «No se ha podido abrir el almacén cifrado en este dispositivo… No se ha borrado nada. Suele pasar tras restaurar el teléfono o cambiar el bloqueo de pantalla.»Dispositivo
  • Sincronizar secretos entre dispositivos: se quitan de lo que se sube, y tampoco viajan en un fichero exportado.A propósito

Exportar, importar y enlaces

Un workflow viaja como un fichero .pcwf.json. Exportar e importar son gratis a propósito, y el código dice por qué: son la única forma de sacar tu trabajo de la app, y una vía de salida de tus datos detrás de una suscripción convertiría un plan en una cerradura.

Puedes

  • Compartir como fichero (en el menú de una tarjeta) abre Compartir este workflow: el nombre del fichero, qué campos secretos se vacían («Tus secretos se quedan en este dispositivo»), y el recordatorio de que el historial, las salidas fijadas y el interruptor no viajan. Compartir abre el selector de apps de Android.
  • Importar un workflow desde un fichero (el botón de arriba de la lista) abre el selector de ficheros del sistema. La hoja Importar workflow enseña el nombre, Se dispara cuando, hasta 40 pasos, Tendrás que rellenar esto para los secretos y el resultado del linter; Guardar se bloquea si hay un error. «Se guardará apagado. Léelo antes de encenderlo: un workflow puede ejecutar comandos en tu dispositivo.»
  • Abrir un enlace pocketcode://workflows/import?url=https://… desde otra app: Un enlace quiere importar un workflow muestra la dirección (De: …) y un aviso, y no se descarga nada hasta que pulsas Descargar (o No, gracias).

No puedes, y por qué

  • Abrir un .pcwf.json directamente desde un gestor de ficheros u otra app: la app no tiene filtro de ficheros para eso. Usa Importar un workflow desde un fichero o el enlace.A propósito
  • Importar un fichero de más de 512 KB, un fichero que no es un workflow de PocketCode, uno dañado o uno escrito por una versión más nueva de PocketCode: cada caso tiene su propio mensaje.A propósito
  • Usar un enlace que no sea https, de más de 2 048 caracteres, con credenciales en la dirección o que apunte al propio dispositivo; una redirección se enseña y no se sigue.A propósito
  • Compartir un fichero sin revisarlo: solo se vacían los parámetros declarados como secretos; las cabeceras HTTP y los comandos viajan tal como los escribiste, así que revisa el fichero antes de compartirlo si algún campo lleva una clave o un token.A propósito

Qué lleva el fichero

SaleEl nombre, la descripción, los disparadores, los pasos, las entradas y los ajustes del run (permisos y etiquetas incluidos).
No saleEl id, las fechas, el estado del último run, la plantilla de origen, el interruptor de activado, Disponible para el agente de IA, las salidas fijadas, el historial y los horarios.
SecretosLos parámetros declarados como secretos se vacían y se listan. Una referencia {{secret.NOMBRE}} sí viaja: es un nombre, no el secreto.
LlegaApagado y con id nuevo, después de pasar el linter. Una acción nueva de una versión más reciente se descarta sola; un fichero con un formato más nuevo se rechaza entero.

IA: generar, cambiar y el chat

La IA toca los workflows en tres sitios: el generador y la hoja de cambio de este módulo (gratis), el agente del chat, que puede leerlos, ejecutarlos y, con Pro, escribirlos, y los botones Analizar con IA de un run.

Generar desde prompt y Cambiar con IA

Los dos viven en el módulo y ninguno tiene comprobación de plan. El modelo es el proveedor de IA que configuraste en Ajustes, con tu propia clave.

Puedes

  • Tocar Generar desde prompt en la bienvenida (en vertical) para abrir Generar workflow desde prompt: escribe el Prompt, mencionando el disparador (push, guardar, commit, error, deploy) y las acciones (deploy, notificar, backup, test, formatear), y pulsa Generar.
  • Tocar Cambiar con IA en el menú de una tarjeta para abrir Cambiar «…» con IA: di qué quieres cambiar; el resto del workflow se queda como está y antes de guardar ves qué ha cambiado.
  • Revisar el resultado: la vista previa, Revisión (problemas del linter), La prueba en seco pasó en n ms., La prueba en seco falló: … o «Sin probar: … Puedes probarlo tú desde el editor.», Corregido automáticamente para lo que la app reparó y, al cambiar, el diff (se añade, se quita, cambia, n pasos sin cambios).
  • Elegir Guardar y activar (solo al crear), Abrir en el editor (la salida cuando la revisión bloquea guardar) o Descartar. Un workflow creado así se guarda encendido; un cambio conserva el id, el estado de activado y la fecha de creación del workflow.

No puedes, y por qué

  • Contar con una prueba en seco para todo lo que hace la IA: solo corre cuando la app la considera segura, porque una prueba en seco ejecuta pasos. Cuando un paso no se puede simular, las esperas suman más de 10 segundos, una espera es por un evento o un subflujo no se puede inspeccionar, dice Sin probar y da el motivo.A propósito
  • Conseguir un workflow escrito por un modelo sin un proveedor de IA: sin clave la app recurre a palabras clave y dice «Hecho sin modelo: no hay clave de IA configurada, así que esto sale de palabras clave.»Requiere red
  • Guardar un workflow generado que el linter rechaza: «Arregla esto antes de guardar: este workflow no está listo.»A propósito

El agente del chat y los workflows

Dos cosas distintas. Un workflow que marcas Disponible para el agente de IA y mantienes encendido se anuncia al chat como herramienta propia, workflow__<nombre>__<últimos 6 caracteres del id>, con una descripción construida a partir de sus pasos (avisa de los irreversibles) y un esquema de entrada construido a partir de sus entradas declaradas. Y seis herramientas de gestión están siempre, haya o no workflows expuestos.

HerramientaQué hacePlan
workflow__listLista tus workflows (hasta 25) con sus disparadores, si están activados y cómo fue el último run; puede filtrar.Free
workflow__getDevuelve un workflow entero. Los parámetros secretos aparecen como [secret, not shown]. Un workflow de más de 20 000 caracteres se rechaza, no se recorta.Free
workflow__runsEl historial de un workflow, el más reciente primero (5 por defecto, hasta 20), con el último error y hasta 5 pasos fallidos.Free
workflow__runEjecuta un workflow ahora. Rechaza uno que esté apagado, valida las entradas y respeta el permiso de pasos irreversibles.Free
workflow__createCrea un workflow a partir de un documento. Se valida antes, y nace apagado aunque el modelo lo pida encendido.Pro
workflow__updateCambia campos de un workflow que ya existe.Pro

Puedes

  • Preguntar al agente qué workflows se ejecutan al hacer push, o por qué falló la copia de anoche: lee con workflow__list, workflow__get y workflow__runs, que son gratis.
  • Pedirle que ejecute uno con workflow__run: valida las entradas contra las que declara el workflow y respeta el permiso de pasos irreversibles que diste (Permitir a la IA).
  • Con Pro, pedirle que cree o cambie uno: workflow__create y workflow__update. Las tres herramientas que escriben pasan por la hoja de confirmación del agente.

No puedes, y por qué

  • Crear o cambiar workflows desde el chat en Free: el modelo recibe un rechazo que le dice que te avise, y ves un aviso («… necesita PocketCode Pro, así que esa acción no se ha ejecutado.») con un botón Mejorar. La función del plan se llama Workflows desde el chat.​Pro
  • Dejar que el agente cambie el reintento, los tiempos límite, la condición Cuándo o la retención de un workflow: la IA no puede fijarlos, y una actualización conserva los ids de los pasos, los permisos, las etiquetas y la retención.A propósito
  • Usar Disponible para el agente de IA como control de acceso: solo decide si un workflow se anuncia como herramienta propia. workflow__run puede ejecutar por nombre cualquier workflow que esté encendido.A propósito

Marketplace

El Marketplace tiene un tipo de recurso Workflows, pero hoy un workflow no se puede instalar desde él, y la app no tiene forma de publicar uno. Para compartir un workflow, usa un fichero o un enlace (mira Exportar, importar y enlaces).

Puedes

  • Filtrar el Marketplace por el tipo Workflows y leer la página de un recurso de ese tipo.
  • Compartir los tuyos con Compartir como fichero, o alojar un .pcwf.json en una dirección https y mandar un enlace pocketcode://workflows/import?url=….

No puedes, y por qué

  • Instalar un workflow desde el Marketplace: en la página de un recurso de workflow el botón de instalar está desactivado (Requiere runtime WASM), igual que en un plugin, aunque el motor ya sabe cómo revisar e instalar uno.Aún no
  • Publicar un workflow en el Marketplace: no hay botón y la app no puede subir nada. El catálogo lo publica el equipo mediante una pull request que valida y firma la integración continua.A propósito

Free y Pro

El motor es gratis. Lo que cuesta dinero es poco, y cada punto es un límite al que llegas desde fuera de este módulo. Los precios están en Planes y precios.

FunciónFreePro
25 disparadores, 15 acciones, siete tipos de paso, plantillas, el editor, el linter y las pruebas de pasoSíSí
Programar (WorkManager, cron, condiciones del dispositivo, recuperación de ejecuciones perdidas)SíSí
Secretos cifrados, permisos por workflow, historial y Actividad, exportar e importar .pcwf.jsonSíSí
Disponible para el agente de IA, y que el chat ejecute tus workflows (workflow__run, workflow__list, workflow__get, workflow__runs)SíSí
Generar desde prompt y Cambiar con IA en este móduloSí, con tu propio proveedor de IASí, con tu propio proveedor de IA
Que el chat de IA cree o cambie workflows (workflow__create, workflow__update)No: el modelo recibe un rechazo y ves un aviso con MejorarSí (Workflows desde el chat)
El paso Lanzar deploy mientras hay un deploy del mismo proyecto en vuelo (en cola, construyendo o desplegando)No: 1 en vuelo por proyecto («Se requiere upgrade para lanzar otro deploy activo»)Sí, sin tope
Sincronizar las definiciones de workflows entre tus dispositivos (Cloud Sync, el grupo Workflows)NoSí
Lo que no se vende, y por qué, con las palabras del propio código: los webhooks no existen (no hay servidor, ni endpoint, ni disparador), las alarmas exactas se descartaron a favor de WorkManager con su holgura, y publicar en el Marketplace no puede subir nada. El historial y la exportación son gratis a propósito: cobrarlos sería quitar algo que hoy es gratis, y exportar es la única forma de sacar tu trabajo de la app. Cloud Sync mueve solo definiciones; los runs, los horarios, las salidas fijadas, los permisos de pasos irreversibles y los secretos nunca salen del dispositivo.

Atajos de teclado

Funcionan solo mientras el editor está abierto y con teclado físico. Se pueden cambiar en Ajustes.

TeclaQué hace
Ctrl+SGuardar.
Ctrl+Z / Ctrl+Shift+ZDeshacer / Rehacer.
Ctrl+EnterProbar ahora: prueba en seco del workflow.
Ctrl+DDuplicar el paso seleccionado (Ctrl+Shift+D en el preset de IntelliJ).
DeleteBorrar el paso seleccionado.
Ctrl+↑ / Ctrl+↓Subir o bajar el paso seleccionado (Ctrl+Alt+↑ / Ctrl+Alt+↓ en el preset de Atom).

Las cuatro últimas actúan sobre el paso seleccionado: toca el lápiz de una tarjeta para seleccionarlo.

Privacidad y seguridad

Los workflows se ejecutan en tu dispositivo; lo que sale de él es aquello a lo que apuntas un paso.

  • Dónde se guarda. Las definiciones viven en una base de datos local del dispositivo, un fichero por cuenta. Con Pro, Cloud Sync puede copiar las definiciones entre tus dispositivos (el grupo Workflows); los runs, los horarios, las salidas fijadas y los secretos no se sincronizan nunca.
  • Secretos. Se guardan cifrados en el dispositivo, un conjunto por cuenta (clave del Keystore de Android, AES-256-GCM), no se vuelven a enseñar, no se resuelven en una prueba en seco, no viajan en un fichero exportado y se tapan como ••• cuando un run se escribe en el historial (un valor de menos de 4 caracteres no se puede tapar).
  • Permiso de pasos irreversibles. La respuesta a Activar de todos modos y a Permitir a la IA se recuerda solo en el dispositivo, una vez por workflow.
  • Qué puede hacer un workflow. Un workflow puede ejecutar comandos y escribir ficheros con los permisos que dejaste abiertos; los permisos no son un cajón de arena, y la lista de dominios no frena a un paso de IA, de deploy o de git.
  • Qué sale del dispositivo. Petición HTTP, Lanzar deploy, Operación git (push y pull) y los pasos de IA van a los servicios que configuraste o a las direcciones que escribiste. Un paso de IA manda su prompt y su contexto a tu proveedor con tu propia clave.
  • Importaciones. Un fichero o un enlace siempre llega apagado, con una vista previa y el resultado del linter; un enlace debe ser https, no puede llevar credenciales ni apuntar al dispositivo, no sigue redirecciones y no descarga nada hasta que pulsas Descargar.
  • Lo que te mandan otras apps. El texto y los ficheros compartidos llegan como datos, nunca como órdenes, y la app siempre te enseña lo recibido y qué workflow lo recibe.
  • Exportaciones. Solo se vacían los parámetros declarados como secretos; las cabeceras HTTP y los comandos viajan como los escribiste. Revisa el fichero antes de compartirlo.

Limitaciones

Los límites más importantes, cada uno con su motivo. Los límites propios de una pantalla están en la sección de esa pantalla.

  • El chat no puede crear ni cambiar workflows en Free, y el paso Lanzar deploy falla en Free mientras haya ya un deploy de ese proyecto en vuelo.Pro
  • Las definiciones solo se sincronizan entre dispositivos con Pro (Cloud Sync).Pro
  • Las ejecuciones programadas pasan por WorkManager: no más a menudo que cada 15 minutos, sin alarmas exactas, y Doze o el ahorro de batería pueden retrasarlas (nunca cancelarlas).Google Play
  • Los runs en segundo plano dependen de un servicio en primer plano; desde Android 12 el sistema puede negarlo cuando la app está en segundo plano, y el run sigue entonces sin esa protección.Google Play
  • Solo los 5 primeros runs simultáneos tienen aviso de progreso; la baldosa es opcional y Android decide cuántos atajos enseña un lanzador.Dispositivo
  • El almacén de secretos puede no abrirse tras restaurar el teléfono o cambiar el bloqueo de pantalla; no se borra nada.Dispositivo
  • Proyecto cerrado y La IA terminó su turno no se disparan nunca: nada en la app los emite.Aún no
  • Al hacer commit solo se dispara con commits hechos desde Projects, no con los del panel Control de código del editor ni con los del chat de IA.Aún no
  • Los horarios no tienen selector de zona horaria, y no hay un aviso automático cuando un run falla.Aún no
  • Los workflows no se pueden instalar desde el Marketplace, y la app no puede publicar uno.Aún no
  • Un run que estaba en vuelo cuando el sistema mató la app no deja fila en el historial, y el log de shell de un run terminado no se guarda.A propósito
  • Sin lienzo de grafo, switch de N ramas ni unión libre, sin editar un horario, sin ?, L, # en el cron, y solo tres intervalos como preajustes.A propósito
  • Hasta 6 disparadores por workflow, 8 condiciones por filtro, 8 etiquetas por workflow, 40 pasos listados en la vista previa de una importación y un fichero de 512 KB.A propósito
  • Límites del motor: 8 runs a la vez en toda la app, 16 esperando hasta 120 segundos, 10 runs por evento en cola por workflow, bucles de hasta 10 000 vueltas y 16 a la vez, subflujos de 5 niveles, una Espera por un evento de 5 minutos por defecto, y el mensaje de error de un Intentar / si falla limitado a 4 096 caracteres.A propósito
  • Salidas de los pasos: un cuerpo de respuesta HTTP de hasta 128 KiB, la salida de la shell hasta 64 KB, un fichero leído hasta 128 KiB, y cada paso guarda como mucho 32 KiB de salida en el historial.A propósito
  • La pantalla de actividad enseña hasta los 500 runs más recientes; el historial que guardas por workflow es de 1 a 1 000 runs y de 1 a 365 días.A propósito
  • Los deploys van solo a render, netlify, digitalocean y railway, y Consultar base de datos llega a neon, supabase, turso, upstash, cloudflare (D1) y a tus conexiones PostgreSQL remotas guardadas.Terceros
  • Generar desde prompt y Cambiar con IA necesitan un proveedor de IA con clave; sin él recurren a palabras clave.Requiere red

Resolución de problemas

Mensajes reales de la app, con lo que significan.

Hoy nadie emite PROJECT_CLOSED en la app, así que este workflow no se va a disparar.

El disparador está en el desplegable pero nada lo emite. Elige otro disparador: Proyecto cerrado y La IA terminó su turno no se disparan nunca.

Sin condiciones: este disparador salta con cada evento de su tipo.

No es un error: el disparador no tiene filtro. Añade una condición si quieres solo algunos eventos.

Un workflow que activé nunca se ejecuta

Comprueba que Activado está encendido, que su disparador tiene de verdad un emisor y un filtro que case, que no lo salta Saltarse el nuevo mientras hay otro run en marcha, y que las entradas obligatorias tienen valor por defecto (un evento, un horario o un atajo no tienen a quién preguntar).

Ningun workflow activo escucha esto. Añade el disparador en el editor de workflows.

Compartiste algo a PocketCode y ningún workflow encendido tiene Texto compartido a PocketCode o Fichero compartido a PocketCode. Añade el disparador y enciende el workflow.

… necesita antes un valor

Un atajo, una baldosa o un compartir intentó lanzar un workflow con una entrada obligatoria sin valor por defecto. Dale un valor por defecto a la entrada, o ejecútalo desde el módulo.

Obligatorias sin valor por defecto: … Un run programado no puede arrancar: el programador no tiene a quien preguntar.

Un horario no puede pedirte entradas. Dale un valor por defecto a cada entrada obligatoria.

Expresión cron no válida

Un cron tiene cinco campos: min hora día mes semana. No se admiten ?, L, #, un paso sobre un rango ni un campo de año.

Pide cada 5 min, pero se ejecuta cada 15 min: es el suelo que permite Android.

Un intervalo por debajo de 15 minutos se sube a 15. A un cron por debajo de ese ritmo le sale «Android no garantiza ese ritmo en segundo plano».

Los workflows programados necesitan atención

El aviso dice lo que Android contestó: «Las notificaciones de PocketCode están desactivadas», «El canal ‹Workflows · avisos› está bloqueado», o «PocketCode está sujeta a la optimización de batería». Toca Abrir ajustes. El aviso no se puede descartar; desaparece cuando desaparece la causa.

permiso denegado (…): … Se cambia en «Permisos», dentro de los ajustes del workflow.

Los permisos del workflow rechazaron un paso (el mensaje sale en español en todos los idiomas). Abre Ajustes del workflow y Permisos y abre la red, la escritura o los comandos, o añade el dominio.

Se requiere upgrade para lanzar otro deploy activo

En Free un paso Lanzar deploy falla mientras haya un deploy del mismo proyecto todavía en vuelo (en cola, construyendo o desplegando); el límite es 1. Espera a que acabe, o pasa a Pro.

la consulta modifica datos (…) y el paso no tiene «allowWrites» activado

Un paso Consultar base de datos lleva verbos de escritura y allowWrites está apagado (el mensaje sale en español en todos los idiomas). Activa allowWrites solo si es lo que quieres.

Eso no es un fichero de workflow de PocketCode. Elige un fichero .pcwf.json.

El fichero no es un workflow. Los otros dos mensajes son «Es un fichero de workflow, pero está dañado y no se puede leer.» y «Este fichero lo escribió una versión más nueva de PocketCode (formato …). Actualiza la aplicación para abrirlo.»

Esa dirección te manda a otro sitio: … No se ha seguido; confirma la nueva dirección solo si te fías.

Un enlace de importación redirigió a otra dirección. Confirma la dirección nueva solo si confías en ella.

No se ha podido abrir el almacén cifrado en este dispositivo

El almacén de secretos no se puede abrir tras restaurar el teléfono o cambiar el bloqueo de pantalla. No se ha borrado nada.

Cuidado: este valor tiene menos de 4 caracteres, así que NO se tapará con ••• en el historial de ejecuciones. Si un paso lo imprime, ahí se queda legible.

El secreto se guarda, pero si un paso lo imprime, se queda legible en el historial de ejecuciones. Usa un valor más largo.

El workflow ya no existe: este run no se puede repetir.

El workflow se borró. Los runs de un workflow borrado se pueden seguir leyendo en Actividad, pero no repetir.

El log de shell no se guarda en el historial: solo se ve mientras el run corre.

Sigue el log desde Salida en vivo mientras el run corre, o escribe en un fichero lo que necesites con un paso.

Arregla esto antes de guardar: este workflow no está listo.

La revisión del generador encontró un error. Abre el workflow en el editor con Abrir en el editor y arregla lo que lista Problemas.

Sin probar: … Puedes probarlo tú desde el editor.

El generador no hizo la prueba en seco porque una prueba en seco ejecuta pasos y no podía estar seguro de alguno: un paso que no se puede simular (un deploy), esperas que suman más de 10 segundos, una espera por un evento o un subflujo en el que no puede mirar. Pruébalo desde el editor.