Saturn Studio – Archivos

Archivos – Saturn Studio
Controla los archivos subidos al sistema por los usuarios

banner

📌 ¿Qué es este módulo?

Este módulo permite acceder y gestionar archivos subidos al sistema por los usuarios. Es útil para trabajar con documentación generada o cargada dinámicamente en los procesos de automatización.


⚙️ Comandos disponibles

icon Obtener archivos

Obtener archivos subidos al sistema

Parámetro Descripción Ejemplo
Filtrar por nombre Nombre del archivo a buscar informe_ventas.pdf
Asignar resultado a variable Variable donde se almacenara el resultado archivosEncontrados

🧪 Ejemplo de uso

  1. Obtener archivos
    Buscar archivos cuyo nombre contenga “reporte” y guardar el resultado en archivosEncontrados.

🧩 Requisitos

Este módulo no requiere configuraciones adicionales.




Saturn Studio – IA

Módulo de Inteligencia Artificial – Saturn Studio
Este módulo permite interactuar con modelos de inteligencia artificial mediante agentes inteligentes configurables dentro de Saturn Studio.

banner

📌 ¿Qué es este módulo?

El módulo IA ofrece una integración con modelos avanzados de lenguaje natural mediante un componente llamado “Agente IA”. Este agente permite enviar prompts personalizados, definir modelos específicos y utilizar herramientas externas para ejecutar tareas automatizadas.


⚙️ Comandos disponibles

icon Agente IA

Un sistema autónomo diseñado para percibir su entorno, tomar decisiones racionales y ejecutar acciones.

Parámetro Descripción
Credencial Credencial del proveedor de IA (por ejemplo, OpenAI, Azure, etc.)
Modelo Modelo de lenguaje que se desea utilizar
Prompt de entrada Texto de entrada que el agente utilizará para generar una respuesta
Herramientas APIs u otras funciones disponibles para el agente (opcional)
Asignar resultado a variable Variable donde se almacenará la respuesta

🧪 Ejemplo de uso

  1. Agente IA

    • Modelo: gpt-4
    • Prompt: "Resume este texto: {documento}"
    • Resultado asignado a: resumen


🧩 Requisitos

  • Tener configurada una credencial válida para el proveedor de IA.
  • Disponer del modelo compatible deseado.



Saturn Studio – Assets NOC

Assets NOC – Saturn Studio
Assets de NOC son variables globales o de entorno que facilitan el paso de valores desde el orquestador al robot, optimizando la gestión de datos en las automatizaciones.

banner

📌 ¿Qué es este módulo?

Este módulo permite gestionar variables (Assets) dentro del orquestador, ya sea de forma global o por instancia, para que puedan ser utilizadas y modificadas por los robots. Es útil para manejar configuraciones centralizadas y datos dinámicos.


⚙️ Comandos disponibles

icon Obtener Asset Específico

Obtiene un asset específico utilizando su nombre.

Parámetro Descripción
Credencial Credencial del orquestador
Nombre de Asset Nombre del asset a obtener
Token del proceso Token del proceso (opcional para assets globales)
Key de instancia Identificador único del proceso
Asignar resultado a Variable Nombre de variable donde se guardará el resultado

icon Obtener Todos los Assets

Devuelve todos los assets disponibles en la cuenta conectada.

Parámetro Descripción
Credencial Credencial del orquestador
Asignar resultado a Variable Variable donde se almacenará la lista de assets

icon Agregar un Asset

Permite agregar un nuevo asset con nombre y valor.

Parámetro Descripción
Credencial Credencial del orquestador
Nombre de Asset Nombre del asset a crear
Valor de Asset Valor que tendrá el asset
Asignar resultado a Variable Variable donde se almacena la confirmación

icon Actualizar un Asset

Modifica el valor de un asset existente.

Parámetro Descripción
Credencial Credencial del orquestador
Nombre de Asset Nombre del asset a modificar
Valor de Asset Nuevo valor
Asignar resultado a Variable Variable donde se almacena el resultado

🧪 Ejemplo de uso

  1. Obtener Asset Específico
    Buscar el token de autenticación guardado como asset global.
  2. Actualizar un Asset
    Reemplazar un valor con datos procesados por el robot.

🧩 Requisitos

Este módulo requiere una credencial válida del orquestador y permisos para acceder o modificar los Assets.




Saturn Studio – Logic

Logic Module – Saturn Studio

banner

📌 ¿Qué es este módulo?

El módulo Logic te brinda herramientas para controlar el flujo de tu automatización. Puedes usar condiciones, bucles, manejo de errores y agrupación de comandos.

Es ideal para crear lógica compleja que dependa de resultados, listas de datos o condiciones específicas.


⚙️ Comandos disponibles

icon IF

Evalúa una condición utilizando lógica en JavaScript.

Parámetro Descripción
Condición Condición a evaluar con JS (por ejemplo, a > 10)
Uso Controlar si ejecutar un bloque de comandos dependiendo de una condición.

icon Switch Case

Evalúa una variable o valor y permite ejecutar diferentes bloques de código según su coincidencia.

Parámetro Descripción
Valor Dato a comparar con diferentes “cases” definidos.
Uso Cuando tienes múltiples caminos posibles y quieres evitar muchos “IF”.

icon While

Ejecuta un evento cíclico mientras se cumpla una condición, utilizando lógica Python.

Parámetro Descripción
Condición Expresión lógica en Python que se evalúa en cada iteración.
Uso Para repeticiones donde no sabes cuántas veces se ejecutará.

icon Iterate over elements

Itera sobre cada elemento de una lista o colección.

Parámetro Descripción
Fuente de datos Lista o arreglo sobre el cual iterar.
Uso Para ejecutar comandos para cada elemento de una lista.

icon Break

Rompe un ciclo o estructura repetitiva.

Parámetro Descripción
Sin parámetros Se utiliza dentro de bucles para salir del mismo inmediatamente.

icon Try Catch

Permite intentar ejecutar un bloque de código y capturar el error si ocurre.

Parámetro Descripción
Bloque try/catch Define qué ejecutar e incluye manejo de errores.

icon Group

Agrupa varios comandos para ejecutarlos como una sola unidad.

Parámetro Descripción
Comandos agrupados Permite una mejor organización o ejecución conjunta.

🧪 Ejemplo de uso

Escenario: Procesar una lista de números

  1. Iterate over elements
    Fuente de datos: myList
    Dentro del bucle:
  2. IF
    Condición: item > 10
    Si se cumple:

  • Ejecuta acciones para números mayores a 10.

  1. Else (dentro del IF)

  • Ejecuta acciones para los menores o iguales.

🧩 Requisitos

Este módulo viene incluido en Saturn Studio y no requiere configuración adicional.




Saturn Studio – Webhooks

banner

📌 ¿Qué es este módulo?

El módulo Webhooks permite integrar servicios externos con tu flujo de automatización. Mediante este componente, puedes:

  • Escuchar Webhooks entrantes (desde otras aplicaciones).
  • Procesar la información recibida.
  • Enviar una respuesta inmediata o después de una ejecución.

Ideal para integraciones en tiempo real como formularios, notificaciones, bots, servicios de terceros, etc.


⚙️ Comandos disponibles

📨 Receive Webhook

Recibe un Webhook y lo procesa. Puedes seleccionar el método HTTP, definir el modo de respuesta y almacenar el resultado en una variable.

Parámetro Descripción Ejemplo
HTTP Method Método HTTP que se usará para recibir el Webhook GETPOSTPUTDELETE
Response mode Cómo se responderá al Webhook recibido ImmediatelyAfter robot executionUse 'Response Webhook' moon
Assign result to Variable Variable donde se guardará el contenido recibido (sin {}) webhookData

📤 Response Webhook

Responde a un Webhook previamente recibido. Se puede usar para enviar una respuesta personalizada después de procesar la información.

Parámetro Descripción Ejemplo
Task ID ID de tarea del Webhook recibido a la que se responderá 123456
Response Texto que se enviará como respuesta {"status":"ok"}
Assign result to Variable Variable donde se guardará el resultado responseStatus

🧪 Ejemplo de uso

Supongamos que quieres recibir datos de un formulario externo y luego responder con una confirmación. Puedes configurar el flujo así:

  1. Receive Webhook

    • HTTP Method: POST
    • Response Mode: Use 'Response Webhook' moon
    • Variable: formInput

  2. Procesas los datos con tu robot (por ejemplo, los guardas en una base de datos).
  3. Response Webhook

    • Task ID: el ID obtenido desde formInput.task_id
    • Response: {"message":"Formulario recibido con éxito"}
    • Variable: responseResult


🧩 Requisitos

Este módulo no tiene dependencias externas. Simplemente arrástralo a tu flujo y configúralo.