Este módulo permite enviar correos mediante SMTP y leer correos desde un servidor IMAP. Para utilizar los comandos, es necesario configurar una credencial con los datos correctos del servidor de correo.
Cómo configurar las credenciales de correo
A continuación se detallan los pasos para crear una credencial válida dentro de Saturn Studio.
Abrir la ventana de credenciales
Al utilizar un comando del módulo (por ejemplo Send email), se abrirá la ventana:
Configure SMTP and IMAP server
En esta ventana se completan los parámetros necesarios para enviar y recibir correo.
Completar los campos de la credencial
Credential name
Nombre identificador para reconocer la credencial dentro del sistema.
SMTP server
Servidor SMTP utilizado para enviar correos. Depende del proveedor del correo.
SMTP port
Puerto SMTP del servidor. Valores más utilizados:
465
587
Use SSL in SMTP
Marcar si el servidor requiere conexión segura (SSL) para el envío.
IMAP server
Servidor IMAP utilizado para la lectura de correos.
IMAP port
Puerto IMAP del servidor. Valores más utilizados:
993 (IMAP con SSL)
143 (IMAP sin SSL)
Use SSL in IMAP
Marcar si el servidor IMAP utiliza conexión segura.
User
Dirección de correo utilizada para autenticarse en SMTP e IMAP.
Password
Contraseña de la cuenta o contraseña de aplicación, según lo requiera el proveedor del correo.
Configuraciones recomendadas por proveedor
Los siguientes valores se basan en las configuraciones estándar utilizadas para SMTP e IMAP:
Proveedor
SMTP server
SMTP port
SSL SMTP
IMAP server
IMAP port
SSL IMAP
Gmail (Google)
smtp.gmail.com
465
Sí
imap.gmail.com
993
Sí
Outlook / Hotmail / Office 365
smtp-mail.outlook.com
587
No
imap-mail.outlook.com
993
Sí
Yahoo Mail
smtp.mail.yahoo.com
465
Sí
imap.mail.yahoo.com
993
Sí
Notas importantes:
Algunos proveedores requieren “contraseñas de aplicación” para el acceso IMAP/SMTP.
En Gmail puede ser necesario generar una clave especial para permitir el acceso desde aplicaciones externas.
Si ocurre un error de autenticación, revisar el usuario, contraseña y configuración de seguridad del proveedor.
Guardar la credencial
Una vez completados los datos:
Revisar que la información sea correcta.
Seleccionar Save credentials.
La credencial quedará registrada y disponible para todos los comandos del módulo.
Credencial lista para usar
Con la credencial configurada, se pueden utilizar los comandos:
Send email
Read all email
El módulo se encargará automáticamente de la autenticación SMTP e IMAP.
Saturn Studio – Credencial Bitbucket
Este módulo permite conectar Saturn Studio con Bitbucket para listar repositorios, obtener commits, consultar pull requests y automatizar flujos de trabajo. Para utilizarlo, es necesario crear una credencial OAuth dentro del Workspace de Bitbucket.
Cómo obtener la credencial de Bitbucket
Sigue los pasos detallados para generar el Client ID y Client Secret, y luego configurarlos dentro de Saturn Studio.
Los OAuth Consumers se gestionan a nivel de Workspace, no de usuario.
En la esquina superior izquierda de Bitbucket, selecciona el Workspace que utilizarás.
En el menú lateral del Workspace, haz clic en: Workspace settings luego en Apps and features y por último en OAuth Consumers
Crear un OAuth Consumer
Este paso genera el Client ID y el Client Secret que Saturn Studio requiere.
Dentro de Workspace settings, selecciona: OAuth consumers
Haz clic en Add consumer.
Completa los campos obligatorios: Name: Nombre identificador para la integración Description: Descripción breve del uso Callback URL: Ingresar una URL de retorno válida
En permisos (Scopes), habilita como mínimo:
Account : Email ; Read ; Write
Repositories: Read
Pull requests: Read
Webhooks: Read
Pipelines: Read
Guarda los cambios.
Después de guardarlo, Bitbucket mostrará dos valores:
Key → Este valor debe usarse como Client ID
Secret → Este valor debe usarse como Client Secret
Configurar la credencial en Saturn Studio
Al utilizar cualquier comando del módulo Bitbucket, Saturn Studio mostrará la ventana de configuración de credenciales:
Bitbucket Credentials
Los campos son:
Credential name
Client ID
Client Secret
Botón: Connect to Bitbucket
Botón: Save credentials
Completar la credencial
Credential name: Escribe un nombre descriptivo para identificar la credencial.
Client ID: Ingresa el valor obtenido como Key del OAuth Consumer.
Client Secret: Ingresa el valor Secret generado por Bitbucket.
Haz clic en Connect to Bitbucket para verificar la conexión.
Si la validación es correcta, haz clic en Save credentials.
Proceso finalizado
Una vez guardada la credencial, podrás utilizar todos los comandos del módulo Bitbucket:
List Repositories
Get Repository
List Commits
Trigger New Commits
Trigger New Pull Requests
Get Pull Request
La autenticación se gestionará automáticamente mediante los valores configurados.
Saturn Studio – Bitbucket
¿Qué es este módulo?
Bitbucket es una plataforma web de desarrollo colaborativo que permite a los equipos gestionar repositorios Git, revisar código y automatizar flujos de trabajo mediante pipelines. Es ampliamente utilizada en entornos empresariales y por equipos que integran herramientas de Atlassian como Jira y Trello.
Dispara cuando se realizan nuevos commits en un repositorio de Bitbucket.
Parámetro
Descripción
ejemplo
Credential
Credencial de Bitbucket necesaria para monitorear commits
credential
Workspace
Workspace donde se encuentra el repositorio
workspace-name
Repository
Selecciona el repositorio a monitorear
repository-name
Branch
Selecciona la rama a monitorear para nuevos commits
branch-name
Limit
Número máximo de commits a revisar por ejecución
10
Assign result to variable
Variable donde los nuevos commits serán almacenados. Example {“commits”[{“id””abc123def456″,”type””commit”,”hash””abc123def456″,”message””Add new feature for automated deployment”,”date””2025-07-10T143000+0000″,”author”{“display_name””Alice Developer”,”username””alice.dev”},”parents”[{“hash””def456abc123”}],”links”{“html””https//bitbucket.org/ai_team/automator_ai_engine/commits/abc123def456″,”diff””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/diff/abc123def456″}}],”new_commits_count”1,”repository””ai_team/automator_ai_engine”,”branch””main”}
{var}
Trigger New Pull Requests
Dispara cuando se crean nuevos pull requests en un repositorio de Bitbucket.
Parámetro
Descripción
ejemplo
Credential
Credencial de Bitbucket necesaria para monitorear pull requests
credential
Workspace
Workspace donde se encuentra el repositorio
workspace-name
Repository
Selecciona el repositorio a monitorear
repository-name
State
Estado de los pull requests a monitorear
OPEN
Limit
Máximo de pull requests a revisar por ejecución
10
Assign result to variable
Variable donde los nuevos pull requests serán almacenados. Example {“pull_requests”[{“id”123,”type””pullrequest”,”title””Add new authentication module”,”description””This PR adds OAuth2 authentication support”,”state””OPEN”,”created_on””2025-07-10T143000+0000″,”updated_on””2025-07-10T154500+0000″,”author”{“display_name””Bob Developer”,”username””bob.dev”},”source”{“branch””feature/oauth2″,”commit””xyz789abc123”},”destination”{“branch””main”,”commit””abc123def456″},”reviewers”[],”links”{“html””https//bitbucket.org/ai_team/automator_ai_engine/pull-requests/123″}}],”new_pull_requests_count”1,”repository””ai_team/automator_ai_engine”,”state””OPEN”}
{var}
List Repositories
Lista los repositorios de Bitbucket.
Parámetro
Descripción
ejemplo
Credential
Credencial de Bitbucket necesaria para listar repositorios
credential
Workspace
Workspace donde se encuentran los repositorios
workspace-name
Query
Filtro o nombre del repositorio
language=”nodejs”
Sort
Orden por created_on o updated_on
created_on
Limit
Máximo de repositorios a obtener
10
Assign result to variable
Variable donde se almacenará el resultado. Example {“repositories”[{“uuid””{a1b2c3d4-5678-90ab-cdef-1234567890ab}”,”name””automator_ai_engine”,”full_name””ai_team/automator_ai_engine”,”description””Core engine for AI-driven task automation platform.”,”is_private”true,”language””python”,”created_on””2023-05-12T102543.123456+0000″,”updated_on””2025-07-05T134829.789654+0000″,”size_mb”112.8,”mainbranch””main”,”fork_policy””no_public_forks”,”project”{“key””AUTO”,”name””Automator”,”uuid””{ffeeddcc-bbaa-9988-7766-554433221100}”},”owner”{“display_name””ai_team”,”username””ai_team”,”uuid””{123e4567-e89b-12d3-a456-426614174000}”,”type””team”},”workspace”{“name””ai_team”,”slug””ai_team”,”uuid””{123e4567-e89b-12d3-a456-426614174000}”},”links”{“html””https//bitbucket.org/ai_team/automator_ai_engine”,”avatar””https//bytebucket.org/ravatar/%7Ba1b2c3d4-5678-90ab-cdef-1234567890ab%7D?ts=python”,”clone”[{“name””https”,”href””https//johnsmith@bitbucket.org/ai_team/automator_ai_engine.git”},{“name””ssh”,”href””git@bitbucket.orgai_team/automator_ai_engine.git”}],”commits””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/commits”,”branches””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/refs/branches”,”pullrequests””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/pullrequests”,”downloads””https//api.bitbucket.org/2.0/repositories/ai_team/automator_ai_engine/downloads”}}],”page”1,”size”1,”next””https//api.bitbucket.org/2.0/repositories/ai_team?pagelen=1&page=2″,”pagelen”1}
{var}
Get a Repository
Obtiene un repositorio de Bitbucket.
Parámetro
Descripción
ejemplo
Credential
Credencial de Bitbucket necesaria para obtener un repositorio
credential
Workspace
Workspace donde se encuentra el repositorio
workspace-name
Repository
Selecciona el repositorio a obtener
repository-name
Assign result to variable
Variable donde se almacenará la información del repositorio. Example {“repository”{“name””demo_repo”,”full_name””example_team/demo_repo”,”description””Demo repository for frontend preview”,”is_private”false,”language””javascript”,”mainbranch””main”,”workspace””example_team”,”project”{“key””EX”,”name””Example Project”},”updated_on””2025-07-08T153000.000Z”,”size_mb”42.7,”links”{“html””https//bitbucket.org/example_team/demo_repo”,”avatar””https//bytebucket.org/ravatar/%7Bexample-avatar%7D?ts=nodejs”,”commits””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commits”,”branches””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/refs/branches”,”pullrequests””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests”}}}
{var}
List Commits
Lista commits de un repositorio de Bitbucket.
Parámetro
Descripción
ejemplo
Credential
Credencial necesaria para listar commits
credential
Workspace
Workspace donde se encuentra el repositorio
workspace-name
Repository
Selecciona el repositorio a consultar
repository-name
Branch
Rama desde donde listar commits
branch-name
Limit
Máximo de commits a obtener
10
Assign result to variable
Variable donde se almacenará el resultado. Example {“commits”[{“hash””a1b2c3d4e5f6g7h8i9j0k”,”message””Initial commit with demo files\n”,”date””2025-07-08T144500+0000″,”author”{“display_name””Alice Devbot”,”avatar””https//secure.gravatar.com/avatar/demo1234567890?d=https%3A%2F%2Fexample.com%2Favatars%2FAD.png”},”parents”[{“hash””z9y8x7w6v5u4t3s2r1q0”}],”links”{“html””https//bitbucket.org/example_team/demo_repo/commits/a1b2c3d4e5f6g7h8i9j0k”,”diff””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/diff/a1b2c3d4e5f6g7h8i9j0k”,”approve””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commit/a1b2c3d4e5f6g7h8i9j0k/approve”}}],”page”1,”size”1,”next””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commits?pagelen=1&page=2″}
{var}
Get Pull Request
Obtiene un Pull Request específico.
Parámetro
Descripción
ejemplo
Credential
Credencial de Bitbucket necesaria para obtener un pull request
credential
Workspace
Workspace donde se encuentra el repositorio
workspace-name
Repository
Selecciona el repositorio a consultar
repository-name
Pull Request ID
ID del pull request
150
Includes
Información adicional a incluir
Commits, Activity, Diff
Assign result to variable
Variable donde se almacenará la información del pull request. Example {“pull_request”{“id”42,”title””Add AI module integration”,”description””* ✨ (ai-module) add OpenAI integration for chat interface with retry logic\n* 📝 (ai-module) update README with usage examples and error codes\n\n”,”state””MERGED”,”created_on””2025-06-01T120000.000000+0000″,”updated_on””2025-06-02T093000.000000+0000″,”merge_commit”{“hash””abc123def456”,”links”{“self”{“href””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/commit/abc123def456”},”html”{“href””https//bitbucket.org/example_team/demo_repo/commits/abc123def456″}},”type””commit”},”close_source_branch”true,”author”{“display_name””Alice Devbot”,”avatar””https//secure.gravatar.com/avatar/abc123xyz456?d=https%3A%2F%2Fexample.com%2Favatar%2FAD.png”},”source”{“branch””feature-ai-module”,”commit””fed456cba321″,”repository””example_team/demo_repo”},”destination”{“branch””main”,”commit””123abc456def”,”repository””example_team/demo_repo”},”reviewers”[],”participants”[],”links”{“html””https//bitbucket.org/example_team/demo_repo/pull-requests/42″,”diff””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/diff/example_team/demo_repofed456cba321\r123abc456def?from_pullrequest_id=42&topic=true”,”commits””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests/42/commits”,”comments””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests/42/comments”,”activity””https//api.bitbucket.org/2.0/repositories/example_team/demo_repo/pullrequests/42/activity”}}}
{var}
Saturn Studio – Credencial monday.com
monday.com ofrece una API que permite interactuar con tableros, ítems, columnas y archivos a través de peticiones autenticadas mediante un API Token personal. Esta credencial permite conectar Saturn Studio con tu cuenta de monday para ejecutar acciones del módulo.
Cómo obtener la credencial de monday.com
Ingresar a la API de monday
Inicia sesión en tu cuenta de monday.com.
Ve a tu foto de perfil (arriba a la izquierda en el menú).
monday.com utiliza un sistema de autenticación simple basado en API Token, no OAuth.
Saturn Studio – monday.com
¿Qué es este módulo?
monday es una plataforma de gestión del trabajo que ayuda a los equipos a planificar, organizar y colaborar en proyectos de forma visual. Ofrece tableros personalizables, automatizaciones e integraciones con diversas herramientas.
Dispara cuando un board en monday presenta cambios.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday para monitorear
credential
Check every N minutes
Intervalo de verificación en minutos
1
Boards
Selecciona el board a monitorear
Select a board
Assign result to variable
Variable donde se guardarán los cambios Example {“board”{“id””9784563210″,”name””Orion”,”updated_at””2025-07-21T151243Z”,”columns”[{“id””name”,”title””Name”,”type””name”},{“id””project_owner”,”title””Owner”,”type””people”},{“id””project_status”,”title””Status”,”type””status”},{“id””date”,”title””Due Date”,”type””date”},{“id””priority_1″,”title””Priority”,”type””status”},{“id””numbers”,”title””Budget”,”type””numbers”},{“id””files_1″,”title””Files”,”type””file”},{“id””project_timeline”,”title””Timeline”,”type””timeline”},{“id””last_updated”,”title””Last Updated”,”type””last_updated”},{“id””location_mksz30va”,”title””Location”,”type””location”}]},”change_type””board_changed”,”changes”[{“type””board_renamed”,”old_name””Orion Dev”,”new_name””Orion”},{“type””board_updated”,”old_updated_at””2025-07-21T151101Z”,”new_updated_at””2025-07-21T151243Z”}]}
{var}
Trigger Item Column Value
Dispara cuando el valor de una columna en un ítem cambia.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
credential
Check every N minutes
Intervalo de verificación
1
Boards
Board donde se monitorean los ítems
Select a board
Columns
Columna a monitorear
Select a column
Limit
Número máximo de cambios (default 10)
10
Assign result to variable
Variable donde se guardarán los cambios Example [{“id””9785623145″,”name””Orion Alpha”,”change_type””new_item”,”updated_at””2025-07-21T151722Z”},{“id””9785623156″,”name””Beta Test”,”change_type””new_item”,”updated_at””2025-07-21T151908Z”},{“id””9785623168″,”name””Delta Phase”,”change_type””new_item”,”updated_at””2025-07-19T104411Z”}]
{var}
List Boards
Lista todos los boards disponibles en monday.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Assign result to variable
Variable donde se guardarán los boards Example {“boards”[{“id””1234567890″,”name””SaturnStudio”}]}
{var}
List Board Items
Lista los ítems de un board específico.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Boards
Board del cual obtener los ítems
Select a board
Assign result to variable
Variable donde se guardarán los ítems Example {“items”[{“id””100001″,”name””Task Alpha”},{“id””100002″,”name””Development”},{“id””100003″,”name””Project Orion”}]}
{var}
Create Board
Crea un nuevo board en monday.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Name
Nombre del nuevo board
My New Board
Board Kind
Tipo de board (Private o Public)
Private
Assign result to variable
Variable donde se guardará el board creado Example {“board”{“id””9686092193″,”name””LocalBoard”}}
{var}
Get an Item’s Column Value
Obtiene el valor de una columna específica de un ítem.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Boards
Board
Select a board
Items
Ítem del que se obtiene el valor
Select an item
Columns
Columna a consultar
Select a column
Assign result to variable
Variable donde se guardará el resultado Example {“item”{“data”{“items”[{“id””9611019969″,”name””Saturn”,”column_values”[]}]},”extensions”{“request_id””78db737a-fe6e-9381-88a7-9cab1f4c224f”}}}
{var}
Update an Item’s Column Value
Actualiza el valor de una columna en un ítem.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Boards
Selecciona el board
Select a board
Items
Ítem a actualizar
Select an item
Columns
Columna a modificar
Select a column
Assign result to variable
Variable donde se guardará la actualización Example {“item”{“id””9611019969″,”name””Saturn”,”column_values”[{“id””project_owner”,”value””{“changed_at””2025-07-16T101243.123Z”,”personsAndTeams”[{“id”78546111,”kind””person”}]}”,”text””Luciana Gomez”},{“id””project_status”,”value””{“index”2,”changed_at””2025-07-17T142350.417Z”}”,”text””In progress”},{“id””date”,”value””{“date””2025-08-10″,”changed_at””2025-07-17T142530.226Z”}”,”text””2025-08-10″},{“id””priority_1”,”value””{“index”90,”changed_at””2025-07-17T142712.891Z”}”,”text””Medium”},{“id””text9″,”value”””Meeting scheduled with external provider for adjustments””,”text””Meeting scheduled with external provider for adjustments”},{“id””numbers”,”value”””12″”,”text””12″},{“id””files_1”,”value””{“files”[{“name””business_proposal.pdf”,”assetId”3895232341,”isImage””false”,”fileType””ASSET”,”createdAt”1707398934000,”createdBy””40202275″}]}”,”text””https//rocketbot-global.monday.com/protected_static/30438402/resources/3895232341/business_proposal.pdf”},{“id””project_timeline”,”value””{“to””2025-08-20″,”from””2025-08-05″,”changed_at””2025-07-17T142946.713Z”}”,”text””2025-08-05 – 2025-08-20″},{“id””last_updated”,”value””{“updated_at””2025-07-17T143111Z”,”updater_id””78546111″}”,”text””2025-07-17 143111 UTC”},{“id””location_mksz30va”,”value””{“lat”-34.6037,”lng”-58.3816,”address””Buenos Aires, Argentina”,”changed_at””2025-07-17T143111.298Z”}”,”text””Buenos Aires, Argentina”}]}}
{var}
Upload File to an Item’s Column
Sube un archivo a una columna tipo archivo.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Boards
Board
Select a board
Items
Ítem
Select an item
Columns
Columna donde subir el archivo
Select a column
File path
Ruta del archivo a subir
image.jpg
Assign result to variable
Variable donde se guardará la información del archivo Example {“item”{“id””9876543210”},”file”{“name””Resume – John Smith.pdf”,”uploaded”true}}
{var}
Add Column to Board
Agrega una nueva columna a un board.
Parámetro
Descripción
Ejemplo
Credential
Credencial de monday
My monday credentials
Boards
Selecciona el board
Select a board
Column Type
Tipo de columna a crear
Select a column type
Column Title
Título de la nueva columna
New Column
Assign result to variable
Variable donde se guardará la columna creada Example {“column”{“id””text_mkyzqty5″,”title””New Column”,”type””text”}}
{var}
Saturn Studio – Credenciales Salesforce
¿Qué es este módulo?
Este módulo permite integrar Saturn Studio con Salesforce, una plataforma CRM basada en la nube que ayuda a las empresas a gestionar relaciones con clientes, ventas, marketing, servicio al cliente y más. A través de esta integración, puedes buscar, obtener, crear y gestionar registros de manera automatizada.
Cómo obtener las credenciales de Salesforce
En Salesforce, ve a Setup → App Manager.
Haz clic en New Connected App.
Completa los campos básicos:
Nombre de la App
Correo de contacto
En la sección API (Enable OAuth Settings):
Marca “Enable OAuth Settings”.
Introduce el Callback URL (por ejemplo: https://studio.rocketbot.com).
Selecciona los OAuth Scopes necesarios.
Guarda la App. Una vez creada, Salesforce generará:
Consumer Key
Consumer Secret
Luego, en Setup → Auth. Providers, crea un proveedor de autenticación si lo requiere el flujo OAuth.
Finalmente, en Setup → Named Credentials, crea una nueva Named Credential que utilice el Auth Provider, el Consumer Key/Secret y el URL de negocio.
Parámetros clave
Parámetro
Descripción
Ejemplo
Domain URL
URL de tu instancia Salesforce (por ejemplo My Domain)
El Tool Agent es un componente del módulo IA que permite crear agentes inteligentes capaces de razonar, generar respuestas y ejecutar acciones conectadas con otros módulos de Saturn Studio.
Este agente utiliza modelos de lenguaje avanzados y puede combinar la generación de texto con la ejecución de comandos o consultas hacia herramientas externas (por ejemplo, Gmail, Google Calendar, Notion, Supabase, etc.), actuando como un agente operativo y contextual.
📌 ¿Qué es este módulo?
El Tool Agent es un sistema autónomo de inteligencia artificial diseñado para percibir su entorno, procesar información y tomar decisiones racionales para alcanzar objetivos específicos.
A diferencia de un agente de solo conversación, este módulo puede utilizar herramientas conectadas (módulos de Saturn Studio) para realizar acciones o recuperar información antes de generar su respuesta final con IA.
⚙️ Comandos disponibles
🧠 Tools AI
Parámetro
Descripción
Ejemplo
Credential
Credencial del proveedor de IA (por ejemplo, OpenAI). Debe haberse creado previamente en el módulo correspondiente.
OPENAI – test
Model
Modelo de lenguaje a utilizar para procesar las instrucciones y generar respuestas.
gpt-4o
Input Prompt
Instrucción o texto de entrada que el agente recibirá. Puede incluir variables dinámicas como {var_name}.
“Genera un correo de agradecimiento a partir del evento {evento_nombre}”
Tools (Fuentes y Acciones)
Define los módulos o herramientas conectadas que el agente puede usar para recuperar información o ejecutar acciones. Estos módulos funcionan como extensiones que amplían la capacidad del agente (por ejemplo: leer emails, buscar eventos o escribir registros).
Gmail, Google Calendar, Notion
Assign result to variable
Variable donde se almacenará la respuesta o acción generada por el agente.
resultado_tools
🧩 Ejemplo de uso
Crea o selecciona una Credencial de IA (por ejemplo, OpenAI) desde su módulo correspondiente.
En el flujo de Saturn Studio, arrastra el comando Tools AI.
Completa los campos:
Credential: OPENAI – test
Model: gpt-4o
Input Prompt: “¿Cuáles son mis eventos del día y envía un correo con el resumen?”
Tools: Google Calendar, Gmail
Assign result to variable: respuesta_final
Al ejecutar el flujo, el agente consultará las herramientas seleccionadas (en este caso Calendar y Gmail), procesará la información con IA y devolverá una respuesta automática con acción ejecutada.
🧩 Requisitos
Tener configurada una credencial válida del proveedor de IA (OpenAI, Hugging Face, etc.).
Contar con módulos conectados que el agente pueda usar como fuentes o acciones (por ejemplo, Gmail, Calendar, Supabase, etc.).
Asignar una variable de salida para almacenar el resultado final.
Saturn Studio – Credenciales Jira
¿Qué es este módulo?
El módulo Jira permite integrar Saturn Studio con la plataforma de gestión de proyectos Atlassian Jira, facilitando la automatización de tareas como creación, actualización, consulta o eliminación de incidencias.
Para poder utilizar los comandos del módulo, primero deberás configurar una credencial de Jira, la cual se compone de tres elementos esenciales: Dominio, Usuario y API Token.
Este enlace te llevará directamente al panel de API Tokens de tu cuenta Atlassian, desde donde podrás crear y administrar tus claves personales.
2) Crear un nuevo token de API
En la sección API Tokens, haz clic en el botón:
🔹 Create API token
Aparecerá una ventana emergente solicitando un nombre descriptivo para el token, por ejemplo:
Saturn Studio Integration
Luego, presiona Create para generar el nuevo token.
3) Copiar el token generado
Una vez creado, Atlassian mostrará el nuevo API Token. Haz clic en Copy to clipboard para copiarlo y guárdalo en un lugar seguro. ⚠️ Importante: Por razones de seguridad, no podrás volver a visualizarlo más adelante.
4) Obtener tu dominio y usuario
Antes de configurar la credencial en Saturn Studio, deberás identificar los siguientes datos:
Dato
Descripción
Ejemplo
Dominio
Dirección de tu espacio de Jira Cloud (sin https:// ni www).
tuequipo.atlassian.net
Usuario
Correo electrónico asociado a tu cuenta de Atlassian.
Luego, presiona Check para verificar la conexión. Si la validación es exitosa, haz clic en Save credentials.
✅ ¡Listo! Tu credencial de Jira queda registrada y podrás usarla en todos los comandos del módulo.
Requisitos
Tener una cuenta activa en Atlassian Jira Cloud.
Permisos para crear y gestionar API Tokens.
Acceso al dominio de tu organización (por ejemplo: miempresa.atlassian.net).
Saturn Studio – Jira
¿Qué es este módulo?
Jira es una herramienta de gestión de proyectos diseñada para equipos de desarrollo. Permite planificar, rastrear y gestionar tareas utilizando metodologías ágiles como Scrum y Kanban.
Disparador que se activa cuando se crea una nueva incidencia en Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para monitorear incidencias.
Mis credenciales de Jira
Comprobar cada N minutos
Intervalo de verificación en minutos.
1
Proyecto
Proyecto que se desea monitorear para detectar nuevas incidencias.
PROJ
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“id”:”34567″,”key”:”PROJ-123″,”summary”:”Nueva funcionalidad”,”issueType”:”Bug”,”assignee”:”Alice Johnson”,”reporter”:”Bob Smith”}
variable
Activar al actualizar una incidencia
Disparador que se activa cuando una incidencia es actualizada en Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para monitorear actualizaciones.
Mis credenciales de Jira
Comprobar cada N minutos
Intervalo de verificación en minutos.
1
Proyecto
Proyecto que se desea monitorear para detectar cambios.
PROJ
Incidencia
Incidencia específica a monitorear.
MAC-1234
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“id”:”34567″,”key”:”PRJ-210″,”summary”:”Corrección de autenticación API”,”status”:”In Progress”,”assignee”:”John Smith”,”issueType”:”Bug”}
variable
Listar proyectos
Lista todos los proyectos disponibles en Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para listar proyectos.
Mis credenciales de Jira
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“projects”:[{“id”:”10100″,”key”:”ALPHA”,”name”:”Alpha Initiative”},{“id”:”10101″,”key”:”BETA”,”name”:”Beta Test Framework”}]}
{var}
Listar incidencias
Lista todas las incidencias de un proyecto en Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para listar incidencias.
Mis credenciales de Jira
Proyecto
Proyecto del cual se listarán las incidencias.
MAC
Consulta JQL
Consulta JQL para filtrar incidencias.
project = MAC AND status = Open ORDER BY priority DESC
Máx. resultados
Número máximo de incidencias a devolver (por defecto 50).
20
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“issues”:[{“key”:”ODR-140″,”summary”:”Corregir error de inicio de sesión”,”status”:”To Do”,”priority”:”High”}]}
{var}
Listar columnas
Lista todas las columnas o estados disponibles en un proyecto de Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para listar columnas.
Mis credenciales de Jira
Proyecto
Proyecto del cual se listarán las columnas o estados.
MAC
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“columns”:[{“id”:”20500″,”name”:”QA-START”,”statusCategory”:{“name”:”In Progress”}}]}
{var}
Listar usuarios
Lista todos los usuarios asignables a un proyecto en Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para listar usuarios.
Mis credenciales de Jira
Proyecto
Proyecto del cual se listarán los usuarios asignables.
MAC
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“users”:[{“displayName”:”John Doe”,”emailAddress”:”john@example.com“,”active”:true}]}
{var}
Obtener una incidencia
Obtiene los detalles de una incidencia específica de un proyecto Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para obtener los detalles.
Mis credenciales de Jira
Proyecto
Proyecto que contiene la incidencia.
MAC
Incidencia
Identificador de la incidencia a consultar.
MAC-1234
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“issue”:{“key”:”PRJ-456″,”summary”:”Jira Module”,”status”:”In progress”,”priority”:”Medium”}}
{var}
Crear una incidencia
Crea una nueva incidencia o subtarea en un proyecto de Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para crear la incidencia.
Mis credenciales de Jira
Proyecto
Proyecto donde se creará la incidencia.
MAC
Resumen
Título o resumen de la incidencia.
Nueva tarea
Descripción
Detalle de la incidencia.
Descripción del problema
Tipo de incidencia
Tipo de incidencia (tarea, error, subtarea, etc.).
Task
Incidencia
Incidencia padre (solo para subtareas).
MAC-1234
Asignado a
Usuario al que se asignará la incidencia.
John Doe
Ruta del archivo
Ruta local de archivo a adjuntar.
image.jpg
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“issue”:{“key”:”ABC-456″,”attachments”:[{“filename”:”error_screenshot.png”}]}}
{var}
Actualizar una incidencia
Actualiza una incidencia existente en Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para actualizar la incidencia.
Mis credenciales de Jira
Proyecto
Proyecto donde se encuentra la incidencia.
MAC
Incidencia
Incidencia a actualizar.
MAC-1234
Resumen
Nuevo resumen de la incidencia (opcional).
Resumen actualizado
Descripción
Nueva descripción (opcional).
Descripción actualizada
Asignado a
Nuevo usuario asignado (opcional).
John Doe
Mover a columna
Estado o columna a la que se moverá la incidencia (opcional).
In Progress
Ruta del archivo
Ruta de archivos a adjuntar (opcional).
image.jpg
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“issue”:{“key”:”XYZ-789″,”updated”:true}}
{var}
Eliminar una incidencia
Elimina una incidencia existente de un proyecto de Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para eliminar la incidencia.
Mis credenciales de Jira
Proyecto
Proyecto del cual se eliminará la incidencia.
MAC
Incidencia
Identificador de la incidencia a eliminar.
MAC-1234
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“message”:”Issue MAC-1234 deleted successfully”}
{var}
Descargar archivos de una incidencia
Descarga todos los archivos adjuntos de una incidencia de Jira.
Parámetro
Descripción
Ejemplo
Credencial
Credencial de Jira necesaria para descargar archivos.
Mis credenciales de Jira
Proyecto
Proyecto que contiene la incidencia.
MAC
Incidencia
Incidencia de la cual se descargarán los archivos adjuntos.
MAC-1234
Asignar resultado a variable
Variable donde se almacenará el resultado. Ejemplo: {“files”:[{“filename”:”mock-img.png”,”size”:74567,”mimeType”:”image/png”}],”totalAttachments”:2}
