maestro
latest
false
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.
UiPath logo, featuring letters U and I in white

Guía del usuario de Maestro

Última actualización 21 de nov. de 2025

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:

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.

Importante:
  • 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:

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 utilizar qué:
  • Conector: sistema compatible, esquema estable, autenticación gestionada, mejor opción a largo plazo.
  • Flujo de trabajo de API: API nueva o no compatible, formas de respuesta cambiantes o salida solo de transmisión.
Guías paso a paso

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 sends input parameters as a JSON payload in the format:
{
  "key1": "value1",
  "key2": "value2"
}{
  "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ámetroDescripción
roleRol o contexto de la tarea (por ejemplo, validación frente a resumen)
promptInstrucciones proporcionadas al agente, a menudo incluyendo datos específicos del proceso
toolsLista de herramientas que el agente puede utilizar para completar la tarea
user_idIdentificador único compartido entre el proceso y el contexto del agente

Solicitud de ejemplo: "Completa la validación de préstamo para {loan_application_number}. Responde en formato JSON utilizando el parámetro 'loan_application_status'."

Salidas de ejemplo (del agente a Maestro)

ParámetroDescripción
conversation_idReferencia a la sesión de diálogo o interacción
loan_application_statusResultado de estado devuelto por el agente
tokens_usedMetadatos sobre el uso de recursos
Importante: 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 empresarial con el archivo DMN cargado, ya no podrás cambiar su versión.
    Nota: Asegúrate de que los nombres de los argumentos solo consten 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 provide business users with role-based dashboards, forms, and triage hubs to manage day-to-day operations. They enable real-time visibility into process health, helping users identify delays, inefficiencies, and escalations—all from a unified workspace across agents, robots, and people.

With Process Apps, teams can:

  • Resolve delays and SLA breaches with real-time context and guided decisions.
  • Make smarter resourcing choices to improve operational efficiency.
  • Drive faster issue resolution and better business outcomes across the organization.

Process Apps combine Maestro process orchestration and UiPath® low-code app development, giving operations teams actionable insights without switching between systems.

Requisitos previos

To use Process Apps, ensure the following services are available in your Automation Cloud tenant:
  • UiPath Automation Cloud™
  • UiPath Maestro™

Comience ya

You can start exploring Process Apps using the UiPath TypeScript SDK and sample app resources.
Tabla 1.
RersourceDescripción
SDK GitHubUiPath TypeScript SDK documentation
Sample React appProcess App sample
NPM packageUiPath TypeScript SDK

Casos de uso de ejemplo

  • Triage dashboards: Track process incidents and act on escalations directly from an operations console.
  • Case and SLA management: Monitor SLAs, identify breaches, and trigger recovery processes.
  • Human-in-the-loop operations: Provide contextual forms for approvals, corrections, or exception handling.

Integration with Maestro

Process Apps connect to Maestro process and incident data to deliver real-time insight into running executions. As a business user, you can monitor instances, track KPIs, and take action on tasks in a single interface, without developer tools.

Example: A Finance Operations Process App can surface delayed invoice approvals from Maestro and allow users to approve or reassign tasks directly, without leaving the app.

¿Te ha resultado útil esta página?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Uipath Logo
Confianza y seguridad
© 2005-2025 UiPath. Todos los derechos reservados.