Automatiza tareas con Botize

Disparadores

El disparador es el evento que inicia la automatización.

• 

  Obtener la siguiente fórmula de Botize

  Recorre una a una cada fórmula de Botize extrayendo su contenido.

Acciones

La acción es lo que ocurre automáticamente, sin que tengas que hacer nada más.

• 

  Ejecutar una tarea de Botize del usuario (tarea-como-tool)

  Expone una tarea de Botize de la cuenta como tool del agente: el agente la lanza con sus valores de entrada y recibe el resultado final cuando termina — aunque tarde horas (p. ej. un paso de confirmación humana). Se binda con task_id FIJADO (la tarea va clavada, nunca la elige el modelo) y se exponen las variables de entrada declaradas por la tarea. La tarea debe estar ACTIVA y corre determinista: las garantías que el usuario cableó en ella no las puede saltar el agente.

• 

  Editar y guardar una tarea de Botize

  Reemplaza por completo la definición de una tarea con un array de microbots modificado (la MISMA forma que devuelve read_task en 'task'). Flujo: primero read_task, modifica el array, luego update_task con el array completo modificado. Se valida contra el nodo real; los errores vuelven como texto para corregir y reintentar. Conserva el estado activa/pausada de la tarea.

• 

  Leer la definición de una tarea de Botize

  Devuelve la definición completa (trigger + pasos + sus parámetros y {{vars}}) de una tarea de Botize de la cuenta, para que el agente la inspeccione, la explique o prepare una edición. Solo lectura. Pasa el task_id numérico.

• 

  Listar las tareas de Botize de la cuenta

  Devuelve las tareas de Botize de la cuenta como lista de {task_id, description, steps}, para que el agente muestre un menú o resuelva a qué tarea se refiere el usuario. Solo lectura, sin parámetros.

• 

  Inspeccionar las ejecuciones recientes de una tarea (y por qué falló)

  Lista las ejecuciones recientes de una tarea, con detalle opcional. Empieza con los valores por defecto (level=summary) para mirar barato; añade status=error para ir directo a los fallos; y solo entonces pide el detalle por pasos de UN run con run_id + level=step (+ mb_id para un paso concreto). Una lista 'executions' vacía significa que no hay ejecuciones en la ventana de ~24h, NO que la tarea esté sana. Para ver que recibieron VARIAS ejecuciones a la vez, usa level=step con UN solo campo en include (p. ej. include=input), max_field_len<=200 y limit<=25. 'outcome_counts' describe la ventana entera y separa las que completaron de las que se pararon a medias sin hacer nada ('stopped_at' dice donde). En los pasos, 'data_omitted' marca datos que el servidor no guardó; 'field_truncated' es solo el recorte que pediste y es inofensivo.

• 

  Activar una tarea pausada

  Activa una tarea pausada para que vuelva a atender su disparador/horario. Pasa task_id.

• 

  Pausar una tarea activa

  Pausa una tarea activa para que deje de atender su disparador/horario hasta reactivarla. Pasa task_id.

• 

  Reprogramar la próxima ejecución de una tarea

  Cambia la fecha/hora de la PRÓXIMA ejecución de una tarea ACTIVA programada. Pasa task_id y 'when' (fecha-hora absoluta o timestamp unix, al menos 60s por delante). Solo tareas activas con intervalo; una pausada devuelve error.

• 

  Obtener información relacionada

  Dada una consulta permite obtener información relacinada como vídeo tutoriales, automatizaciones, solución a errores y respuesta a consultas.