Automatiza tareas con Agentes de Botize

Acciones

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

• 

  Invocar agente

  Invoca un agente por su clave. El paso es solo un puntero: la identidad del agente (rol, cerebro, tools) vive en el config.json de su carpeta, junto a sus documentos y su memoria.

• 

  Componer turno (cerebro guiado por texto)

  Actividad interna: convierte un turno de cerebro en prompt + JSON Schema para cerebros guiados por texto (bridge claude-code). El bucle cede claude_code/run con el resultado.

• 

  Listar conexiones (creador)

  Tool interna del creador de agentes: lista las conexiones de la cuenta por app (solo nombres).

• 

  Buscar métodos (creador)

  Tool interna del creador de agentes: busca métodos en el catálogo de apps del nodo, con sus campos reales.

• 

  Crear agente (creador)

  Tool interna del creador de agentes: valida y escribe el config.json de un agente nuevo (su identidad y frontera de seguridad).

• 

  Ver agente (creador)

  Tool interna del creador de agentes: lista los agentes de la cuenta o lee el config.json de uno.

• 

  Crear una tarea de Botize (meta-tool)

  Crea una tarea de Botize desde una definición SIMPLE: {description, steps:[{app, method, connection, fields, rename}]}. El paso 0 debe ser un trigger (app 'type' each|request|instant, o un método webhook_*). Los campos pueden referenciar variables de pasos anteriores como {{var}}; 'rename' renombra las variables que publica un paso para evitar pisados. La validación es estricta contra el nodo real (métodos, conexiones, campos, variables) y los errores vuelven como texto para corregir y reintentar. La tarea se crea PAUSADA: el usuario la activa desde el panel de Botize.

• 

  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.

• 

  Obtener docs de conexión

  Actividad interna: obtiene la documentación oficial de conexión de una app de Botize (guía, errores, FAQs) en una llamada, desde api/botize-docs. Usada como tool por agentes asistentes de conexión.

• 

  Base de conocimiento

  Actividad interna: consulta la base de conocimiento de Botize (el mismo árbol de docs que lee el MCP de claude.ai) bajo api/botize-docs. mode 'search' busca por regex; mode 'read' devuelve un doc entero. Usada como tool por agentes operador/builder para conocer la forma real de las cosas en Botize (condiciones, campos de un paso, fórmulas).

• 

  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ó)

  Devuelve diagnóstico de las ejecuciones recientes de una tarea: si corrió, su estado y, si falla, el motivo. Introspección de solo lectura que el panel no expone conversacionalmente. Pasa el task_id numérico.

• 

  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.

• 

  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.

• 

  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.

• 

  Preguntar a otro agente (agente-como-tool)

  Expone otro agente de esta cuenta como herramienta: el llamante delega una pregunta y recibe la respuesta final del delegado. One-shot: pregunta limpia, respuesta, olvido (la memoria durable del delegado sigue aplicando). Se binda con agent_key FIJADO (el delegado va clavado, nunca lo elige el modelo) y question EXPUESTA (la redacta el modelo).

• 

  Pensar (turno de cerebro del agente)

  Actividad interna: un turno de cerebro para el bucle del agente. Dada la conversación y las tools disponibles, devuelve un texto final o una llamada a herramienta.

• 

  Ejecutar tool (llamada de herramienta del agente)

  Actividad interna: ejecuta una tool del agente (grep/sed/...) enjaulada a su carpeta y devuelve el resultado.

• 

  Cargar conversación (memoria de corto plazo del agente)

  Actividad interna: carga la conversación previa del agente para una sesión, para continuar el diálogo.

• 

  Guardar conversación (memoria de corto plazo del agente)

  Actividad interna: persiste la conversación del agente para una sesión, para que el siguiente episodio continúe el diálogo.

• 

  Medir consumo del cerebro (correa del agente)

  Actividad interna: imputa el consumo de tokens de un turno claude-code al presupuesto diario del agente.

• 

  Puerta de presupuesto (correa del agente)

  Actividad interna: admite o deniega educadamente un mensaje según el presupuesto diario de tokens del agente.