Praxsuite

Nodos de Utilidades, Vault y Docs

Camila Escobar · 17 de junio de 2026

Los nodos restantes: secretos, tiempos, documentos, y uno que a propósito no hace nada.

Secretos

Read Secret

Resuelve un secreto del Vault del workspace y lo deja disponible para los nodos siguientes como {{vault.alias}}.

La garantía es lo que importa: el valor nunca aparece en los logs, ni en el contexto de la corrida, ni en una respuesta de la API. Una corrida que usó un secreto muestra que usó uno, no cuál era.

Esa es la diferencia con escribir una clave en el campo de configuración de un nodo. Una clave en un campo de configuración la ve cualquiera que pueda abrir la automatización, viaja en las exportaciones, y aparece en las capturas de pantalla. Read Secret no tiene ninguna de esas exposiciones.

Todo lo que autentica contra otra cosa va acá: API keys, tokens, contraseñas de un FTP, un secreto de firma.

Vault: Write Secret

Rota un secreto escribiendo una versión nueva, y conserva la anterior en el historial de versiones.

Esto es lo que hace posible la rotación automática de credenciales. La forma es: una automatización agendada renueva un token con el proveedor, y después escribe el valor nuevo con este nodo — así la credencial se renueva sola y ningún humano tiene que acordarse. El token de 60 días de Instagram es el caso de manual.

Tiempos

Delay

Pausa el flujo por una duración fija antes de continuar.

Recurrí a él cuando algo fuera de tu control necesita un momento — un proveedor que reporta un recurso como listo antes de que lo esté, un trabajo externo que necesita un respiro antes de consultarlo.

No es la solución a los límites de tasa en envíos masivos; para eso están mejor los controles de espaciado del nodo de correo masivo. Y una espera larga es tiempo que la corrida pasa viva, así que preferí un agendado antes que una espera muy larga.

Note

Una anotación visual. No se ejecuta, y no se conecta a nada.

Existe para que un flujo se explique a sí mismo en el lienzo. Una rama cuya condición no es obvia, un nodo que quedó por una razón que no se ve, el motivo por el que hay un delay — escribilo al lado de la cosa. Quien abra esta automatización dentro de ocho meses probablemente seas vos, y el historial de corridas no le va a decir por qué.

Documentos

La categoría Docs tiene doce nodos: generar desde plantillas, publicar, exportar, firmas y más. Están todos en Automatizaciones, IA y la API, en el Módulo Docs. Los dos que más vas a usar:

Docs Query

Búsqueda semántica sobre los documentos del workspace. Devuelve los pasajes más cercanos en significado a tu consulta, no los que contienen tus palabras.

Esa distinción es toda la función. Una consulta de "cómo pido un reembolso" encuentra un pasaje sobre devolver un pedido aunque no compartan vocabulario. Su uso principal es darle a un modelo de IA el contexto correcto desde tu propia documentación, para que la respuesta salga de tu material y no de las suposiciones del modelo.

Solo busca en documentos indexados para IA, y la indexación es manual. Un documento que nadie indexó es invisible para este nodo.

Docs Write

Crea o actualiza un documento, a partir de markdown o de texto enriquecido, con tres modos:

Modo

Efecto

Crear

Un documento nuevo

Actualizar

Reemplaza el contenido de uno existente

Agregar

Suma al final de uno existente

Agregar es el que hay que usar cuando un flujo acumula — una bitácora, un resumen que crece durante el día, notas juntadas por evento. Actualizar reemplaza todo, así que agregar usando Actualizar es un bug de pérdida de datos esperando a ocurrir.

Junto con Docs Query, esto da un ciclo de leer → procesar → escribir enteramente dentro del workspace.

Siguiente

  • Lógica del lado del servidor — donde los secretos y el control de flujo se juntan

  • Nodos de acción — llamar APIs, otras automatizaciones y agentes

  • Corridas y depuración — leer una corrida sin filtrar un secreto en ella

  • Automatizaciones, IA y la API


Cómo se ve

Las secciones Query, Code y Utilities de la paleta de nodos

Los grupos chicos del final de la paleta, juntos.

Note está acá y es el único nodo que no hace nada: es un comentario clavado en el canvas. Usalo. Una automatización que otra persona va a tener que cambiar en seis meses se merece una frase explicando por qué el grafo tiene la forma que tiene.