Integrar sistemas y datos

Gestionar archivos con Data Fabric

En UiPath Maestro™, los archivos se gestionan a través de Data Fabric (anteriormente conocido como Data Service).Cada vez que se descarga un archivo de una fuente (como un archivo adjunto de correo electrónico o un proveedor de almacenamiento en la nube), el archivo se carga en una entidad en Data Fabric que admita el almacenamiento de archivos.

A continuación, se hace referencia al archivo utilizando una referencia de Data Fabric, un triplete formado por:

• NombreDeEntidad
• IdDeRegistro
• NombreDelCampo

Esta referencia permite que el archivo se utilice en cualquier lugar de tu proceso agéntico.

Requisitos previos

Antes de utilizar archivos en Maestro, asegúrate de que:

• Data Fabric está habilitada en tu organización o tenant.
• Se configura una entidad con un campo compatible con archivos.

No se requieren campos adicionales más allá de los rellenados automáticamente por Data Fabric, cuando se crea un registro.

Caso de uso de ejemplo

Este ejemplo muestra cómo descargar un archivo de Box y enviarlo como archivo adjunto de correo electrónico.

1. Descargar el archivo

   • Configura una Tarea de envío para ejecutar una actividad Descargar archivo desde el conector de Box.
   • Selecciona el archivo que deseas descargar.
   • Establece la Salida del recurso de archivo utilizando el editor de Data Fabric. Elige la Entidad y el Campo que admitan archivos.

   

   Cuando se ejecuta, la actividad devolverá una referencia de Data Fabric (EntityName, RecordId, FieldName) que apunte al nuevo registro de archivo en Data Fabric.

2. Enviar el archivo por correo electrónico

   • Configure otra Tarea de envío usando la actividad Enviar correo electrónico del conector de Outlook.
   • Adjunta el archivo haciendo referencia al IdDeRegistro del paso anterior en el editor de Data Fabric.

   

Después de la prueba, encontrarás el IdDeRegistro disponible en las variables del flujo de trabajo.

También puedes verificar que el archivo existe en la aplicación Data Fabric buscando IdDeRegistro.

ADVERTENCIA:

• En Maestro, los archivos se admiten exclusivamente a través de Data Fabric.
• Si un archivo ya existe en Data Fabric, puedes reutilizarlo añadiendo su referencia de Data Fabric.

Uso de agentes en Maestro

Cómo funcionan los agentes en Maestro

Los agentes están representados en los flujos de trabajo de Maestro BPMN como tareas de servicio. Cuando tu proceso llama a una Tarea de servicio, Maestro invoca el agente correspondiente con los parámetros de entrada necesarios para la instancia de proceso específica.

Los agentes devuelven datos de salida a Maestro, que se utilizan para determinar los siguientes pasos en el flujo de trabajo. Puedes configurar agentes para informar de las herramientas utilizadas, las decisiones tomadas y rastrear datos para apoyar la depuración y la transparencia.

Los agentes pueden ser:

• Creados directamente en UiPath Platform (código bajo o codificado)
• Conectados a través de API externas o Integration Service
• Desencadenados mediante eventos o señales basadas en la lógica de flujo de trabajo

Observa un ejemplo del mundo real: UiPath Maestro: el cerebro detrás de la automatización de préstamos sin problemas y transparente.

Conexión de agentes a través de Integration Service

UiPath Integration Service proporciona conectores listos para usar y personalizados para integrar sistemas externos en tus automatizaciones:

• Conectores prediseñados para servicios como Salesforce, Microsoft 365 y Google Workspace
• Creador de conectores personalizados para exponer cualquier API de REST a UiPath Platform
• Gestión unificada de credenciales y conexiones

Usa Integration Service para permitir que Maestro envíe/reciba datos de agentes o sistemas no alojados de forma nativa en UiPath. Más información sobre Integration Service.

Uso de agentes externos

Maestro es neutral con respecto al proveedor. Puedes orquestar el trabajo a través de tus agentes de IA externos preferidos, sin reconstruir tus procesos, utilizando conectores de Integration Service de UiPath.

Puedes orquestar:

• Servicios de IA propios
• Motores de decisión externos
• Microservicios o bots alojados en otras plataformas

Maestro invoca a estos agentes llamando a puntos finales REST y espera una carga útil de respuesta con datos estructurados.

Conexión de agentes externos a través de Integration Service

En tiempo de diseño, añade una tarea de servicio, elige Iniciar y esperar al agente externo y configura la actividad del agente desde el conector seleccionado. En runtime, Maestro envía la solicitud y el contexto al agente y espera la respuesta. Asignas esa respuesta a variables para impulsar puertas de enlace, asignaciones y acciones posteriores.

Los siguientes enlaces muestran cómo conectar un agente externo, ejecutarlo desde un proceso de Maestro y capturar su salida para enrutamiento y decisiones:

• Agentes de Snowflake Cortex
• Agentes de Databricks
• Agentes de Azure AI Foundry
• Iniciar agente de CrewAI (vista previa)
• Ejecutar agente de Google Vertex

Inicios rápidos: integraciones de flujo de trabajo de API

Da preferencia a conectores de Integration Service cuando existen. Usa flujos de trabajo de API cuando necesites conectividad en el nivel de API (API tempranas, esquemas en evolución o respuestas en streaming). Define solicitudes y salidas de forma declarativa, analiza JSON sin código personalizado y pasa los resultados a tu proceso de Maestro.

Cuándo usar cuál:

• Conector: sistema compatible, esquema estable, autenticación gestionada, la mejor opción a largo plazo.
• Flujo de trabajo de API: API nueva o no compatible, formas de respuesta cambiantes o salida de solo transmisión.

Guías paso a paso

• Snowflake Cortex: flujo de trabajo de API: gestiona la salida de transmisión del agente de Cortex, la ensambla en una respuesta utilizable y devuelve JSON estructurado para la automatización posterior.
• Databricks Genie: flujo de trabajo de API: inicia una conversación, sondea el estado del mensaje hasta COMPLETADO, extrae el SQL generado (attachment_id), lo ejecuta y devuelve la respuesta.

Configuración de propiedades del agente

En Maestro, los agentes se tratan como participantes en un proceso empresarial. Dentro de un flujo de trabajo BPMN, los agentes se representan mediante tareas de servicio, que pueden invocar tanto agentes alojados en UiPath como agentes externos. Cada tarea de agente puede configurarse con parámetros de entrada y salida específicos, que permiten a Maestro pasar datos sensibles al contexto al agente y recibir resultados estructurados a cambio.

Consulta Tareas en el modelado BPMN para obtener una descripción general de las tareas de servicio en Maestro.

Modos de ejecución de agente

El comportamiento del agente se define en el panel de propiedades de una tarea de servicio. Puedes configurar la tarea para llamar a un agente de UiPath o a un agente externo, dependiendo de las necesidades de tu negocio.

Iniciar y esperar al agente

Usa esta opción para invocar un agente implementado en tu tenant de UiPath. Esto incluye lo siguiente:

• Agentes de código bajo creados con herramientas como Agent Builder.
• Agentes codificados desarrollados en Python u otros lenguajes e implementados en Orchestrator.

En runtime, Maestro envía parámetros de entrada al agente en formato JSON. Cuando el agente completa la ejecución, devuelve una respuesta con los valores de salida que espera el proceso.

Iniciar y esperar al agente externo

Utiliza esta opción para conectarte a sistemas de terceros o externos. Debes especificar:

• Conector: el destino de integración (por ejemplo, CrewAI, Salesforce u otro servicio)

• Conexión: una instancia configurada del conector que representa a un agente específico o un conjunto de credenciales específicas del contexto.

  Nota:

  Puedes utilizar el mismo agente con diferentes permisos o comportamientos definiendo varias conexiones.

  

Entradas y salidas

Las entradas y salidas para agentes se configuran de la misma manera que otros tipos de tareas de Maestro.

• Entradas: variables o expresiones pasadas al agente en runtime.
• Salidas: variables rellenadas a partir de la respuesta JSON del agente.

Maestro envía parámetros de entrada como carga útil JSON en el formato:

{
  "key1": "value1",
  "key2": "value2"
}

El agente debe devolver una respuesta JSON utilizando los mismos nombres de parámetros que espera Maestro. Estos valores se asignan para procesar variables mediante la sección Salida > Respuesta en el panel Propiedades de la tarea.

Ejemplos de entrada y salida

Entradas de ejemplo (de Maestro a agente):

Parámetro	Descripción
role	Rol o contexto de la tarea (por ejemplo, validación frente a resumen)
prompt	Instrucciones proporcionadas al agente, a menudo incluyendo datos específicos del proceso
tools	Lista de herramientas que el agente puede utilizar para completar la tarea
user_id	Identificador único compartido entre el proceso y el contexto del agente

Ejemplo de solicitud:"Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."

Salidas de ejemplo (de agente a Maestro)

Parámetro	Descripción
conversation_id	Referencia a la sesión de diálogo o interacción
loan_application_status	Resultado de estado devuelto por el agente
tokens_used	Metadatos sobre el uso de recursos

ADVERTENCIA:

Para utilizar la salida del agente en tu flujo de trabajo, debes asignar cada parámetro de salida a una variable de proceso en la configuración Salida > Respuesta de la tarea.

Reglas empresariales (vista previa)

Las reglas empresariales permiten a los desarrolladores de RPA almacenar y gestionar archivos de modelo de decisión y notación (DMN) como parte de un flujo de trabajo o diagrama de proceso.

Reglas empresariales en Orchestrator

Las reglas empresariales en Orchestrator te permiten almacenar y gestionar reglas basadas en Modelo de decisión y Notación (DMN). Puedes evaluar estas reglas dentro de cualquier proceso agéntico utilizando una actividad dedicada. Además, puedes modificar las reglas sin necesidad de volver a implementar los procesos que las utilizan. Esto facilita la actualización y el mantenimiento de la lógica empresarial de forma dinámica.

En Orchestrator utilizamos el siguiente conjunto de capacidades para el almacenamiento y la gestión:

• Almacene los archivos DMN con acceso basado en roles para usuarios y robots
• Control de versiones
• Vinculación de reglas empresariales en distintas carpetas
• Etiquetado

Para ejecutar reglas empresariales, Maestro incluye una nueva tarea de reglas empresariales que es compatible con DMN v1.3.

Acceso a las versiones de las reglas empresariales

Para llevar un control de tus reglas empresariales, utiliza el campo Versión. Tras guardar la regla con el archivo DMN cargado, ya no podrás cambiar su versión.

Puedes ver la versión de una regla empresarial desde la página Reglas empresariales. Para consultar la versión, selecciona una regla empresarial y, a continuación, edita la regla empresarial o ve directamente a Más acciones y selecciona Ver versiones.

En caso de necesidad, también puedes descargar la versión de una regla empresarial a través de uno de los siguientes métodos:

• Una vez que hayas cargado el archivo DMN durante la creación de la regla empresarial, selecciona el icono de descarga ubicado junto al archivo.
• En la página Reglas empresariales, en la regla empresarial deseada, selecciona Más acciones y luego Descargar versión. Como alternativa, en Más acciones, selecciona Ver versiones. Se abre un panel lateral, donde puedes seleccionar el icono de descarga junto a la versión que deseas descargar.

Enlaces a reglas empresariales

Para vincular reglas empresariales desde otras carpetas:

1. En la página Reglas empresariales, selecciona Añadir regla empresarial y, a continuación, Enlace desde otras carpetas.
2. A continuación, la página Importar regla empresarial muestra una lista de todas las reglas empresariales de otras carpetas.
3. Selecciona una o más reglas empresariales para añadir a la carpeta actual, luego Continuar y luego Enlace.

Para gestionar enlaces de reglas empresariales:

1. En la página Reglas empresariales, selecciona una regla empresarial, ve a Más Acciones y selecciona Administrar enlaces.
2. En la siguiente ventana, selecciona una o más carpetas donde añadir una regla empresarial, o deselecciona las carpetas para eliminar una regla empresarial.
3. Selecciona Actualizar.

Ejecutar una regla empresarial

Nota:

Antes de ejecutar una regla empresarial, asegúrate de:

• Haber modelado un archivo DMN con la ayuda de un editor compatible con DMN.
• Haber creado una nueva regla empresarial en Orchestrator cargando el archivo DMN.

1. Para ejecutar una regla empresarial, abre un proceso de Maestro
2. Añade a tu proceso una tarea de regla empresarial.
3. Selecciona el archivo DMN almacenado en Orchestrator como regla empresarial.
4. Asigna argumentos de entrada y salida según cómo se modela el archivo DMN.

Editar una regla empresarial

Para editar una regla empresarial, necesitas permisos de edición en reglas empresariales.

1. En la página Reglas empresariales, selecciona una regla empresarial, luego ve a Más Acciones y luego selecciona Editar.

2. A continuación, puedes editar los siguientes campos: Nombre, Descripción, Etiquetas, Propiedades y Archivo.

   Nota:

   Tras guardar la regla con el archivo DMN cargado, ya no podrás cambiar su versión.

   Nota:

   Asegúrate de que los nombres de los argumentos constan solo de letras, dígitos y el carácter de guion bajo. Los nombres deben comenzar con una letra o el carácter de guion bajo.

3. Selecciona Actualizar.

Eliminar una regla empresarial

Para eliminar una regla empresarial, necesitas permisos de Eliminar en reglas empresariales.

1. En la página Reglas empresariales, selecciona una regla empresarial.
2. A continuación, ve a Más acciones.
3. Selecciona Eliminar.

Apps de proceso (vista previa)

Información general

Process Apps proporciona a los usuarios empresariales paneles basados en roles, formularios y hubs de triaje para gestionar las operaciones cotidianas. Habilitan la visibilidad en tiempo real del estado del proceso, lo que ayuda a los usuarios a identificar retrasos, ineficiencias y escalaciones, todo desde un espacio de trabajo unificado para agentes, robots y personas.

Con Process Apps, los equipos pueden:

• Resolver los retrasos y las infracciones de SLA con contexto en tiempo real y decisiones guiadas.
• Elegir recursos de forma más inteligente para mejorar la eficiencia operativa.
• Impulsa una resolución más rápida de incidencias y mejores resultados empresariales por toda la organización.

Process Apps combina la orquestación de procesos de Maestro y el desarrollo de aplicaciones de bajo código de UiPath®, lo que proporciona a los equipos de operaciones información accionable sin cambiar entre sistemas.

Requisitos previos

Para utilizar Process Apps, asegúrate de que tengas disponibles los siguientes servicios en tu tenant de Automation Cloud:

• UiPath Automation Cloud™
• UiPath Maestro™

Comience ya

Puedes empezar a explorar Process Apps utilizando el SDK de UiPath TypeScript y recursos de aplicaciones de muestra.

Tabla 1.

Recurso	Descripción
SDK GitHub	Documentación de UiPath TypeScript SDK
Aplicación de muestra React	Muestra de aplicación de proceso
Paquete NPM	UiPath TypeScript SDK

Casos de uso de ejemplo

• Paneles de triaje: realiza un seguimiento de los incidentes del proceso y actúa en las escaladas directamente desde una consola de operaciones.
• Gestión de casos y SLA: supervisa los SLA, identifica infracciones y desencadena procesos de recuperación.
• Operaciones con intervención humana: proporciona formularios contextuales para aprobaciones, correcciones o gestión de excepciones.

Integración con Maestro

Process Apps se conecta a los datos de procesos e incidentes de Maestro para proporcionar información en tiempo real sobre las ejecuciones. Como usuario empresarial, puedes supervisar instancias, realizar un seguimiento de los indicadores clave de rendimiento (KPI) y realizar acciones sobre tareas en una sola interfaz y sin herramientas de desarrollador.

Ejemplo: una aplicación de proceso de Finance Operations puede mostrar aprobaciones de facturas retrasadas de Maestro y permitir a los usuarios aprobar o reasignar tareas directamente, sin salir de la aplicación.