RPA de UIP

uip rpa es la herramienta RPA: el puente entre la CLI y una instalación de UiPath Studio. Empaqueta proyectos de Studio en archivos .nupkg , ejecuta el analizador y compilador de flujos de trabajo, andamios y ejecuta proyectos, y expone las operaciones de Studio utilizadas por los agentes de codificación de IA y el sistema de habilidades.

Instálalo con o invoca uip tools install rpa y deja que se ejecute uip rpa … instalación automática. Consulta Herramientas (complementos) para el modelo de instalación y herramientas uip para el comando que gestiona la instalación de herramientas. rpa es el prefijo del comando; el paquete subyacente es @uipath/rpa-tool.

Antes de ejecutar los verbos del empaquetador en CI o en una máquina nueva, asegúrate de que tu runtime y tu SO del ejecutor coincidan con el tipo de proyecto — consulta Requisitos previos.

Comandos

Cada verbo uip rpa tiene su propia página de referencia. Para obtener listas de argumentos activos en la versión de tu herramienta instalada, ejecuta uip rpa <verb> --help.

Verbo	Descripción
add-test-data-entity	Añade una entidad de Data Service como origen de datos para un caso de prueba.
add-test-data-queue	Añade una cola de datos de prueba desde Orchestrator como origen de datos para un caso de prueba.
add-test-data-variation	Añade un archivo de variación de datos CSV/Excel a un caso de prueba.
analyze	Ejecuta el analizador de flujo de trabajo en un proyecto con una política de gobernanza.
build	Compila un proyecto de Studio sin producir un .nupkg.
create-project	Aplica andamios a un nuevo proyecto a partir de una plantilla.
diff	Mostrar diferencias entre dos archivos en una ventana de diferencias de Studio.
find-activities	Buscar actividades que coincidan con una consulta y etiquetas opcionales.
get-analyzer-rules	Enumera las reglas del analizador de flujo de trabajo habilitadas para el proyecto abierto.
get-default-activity-xaml	Recupera la representación XAML de una actividad con valores predeterminados.
get-errors	Recuperar diagnósticos de un archivo o de todo el proyecto, filtrados por gravedad.
get-manual-test-cases	Obtén casos de prueba manuales de Test Manager.
get-manual-test-steps	Obtenga pasos de prueba manuales para una lista de ID de casos de prueba.
get-versions	Enumerar las versiones disponibles de un paquete NuGet en todas las fuentes configuradas.
get-workflow-example	Recupera el XAML para un ejemplo de flujo de trabajo por clave.
indicate-application	Indica una aplicación en pantalla utilizando Studio.
indicate-element	Indica un elemento de IU en la pantalla utilizando Studio.
inspect-package	Inspecciona la API pública de un paquete NuGet a través de la reflexión.
install-data-fabric-entities	Añada o elimine las vinculaciones de entidades de Data Fabric en el proyecto activo.
install-or-update-packages	Instala o actualiza los paquetes NuGet en el proyecto actual.
list-data-fabric-entities	Enumerar las entidades de Data Fabric relevantes para el proyecto activo.
list-workflow-examples	Buscar ejemplos de flujo de trabajo de RPA por etiqueta de servicio.
pack	Empaqueta un proyecto de Studio en un .nupkg.
restore	Descarga las dependencias declaradas en project.json
run-file	Ejecutar o depurar un flujo de trabajo/archivo codificado.
search-templates	Buscar plantillas de proyecto en fuentes NuGet configuradas.
start-studio	Asegúrate de que se esté ejecutando una instancia de Studio.
stop-execution	Detener una ejecución en curso iniciada previamente con run-file.
uia	Subgrupo CLI de Automatización de IU.

list-instances también está registrado, oculto de --help : enumera las instancias de Studio en ejecución visibles para el resolver.

Sinopsis

uip rpa pack <project> [options]
uip rpa build <projectDir> [options]
uip rpa analyze <project> --governance-file-path <policy> [options]
uip rpa restore <project> [outputPath] [options]
uip rpa start-studio [options]
uip rpa <verb> [options]

Todos los verbos uip rpa respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Se aplican los códigos de salida estándar.

El grupo uip rpa principal acepta un pequeño conjunto de opciones compartidas por cada verbo:

Opción principal	Descripción
--project-dir <path>	Directorio del proyecto en el que opera el verbo. El valor predeterminado es el directorio de trabajo actual.
--studio-dir <path>	Ruta a una instalación de Studio cuando la detección no puede encontrar una automáticamente.
--robot-dir <path>	Ruta a un directorio de instalación de Robot.
--timeout <seconds>	Espera máxima para la operación subyacente. Predeterminado: 300.
--verbose	Registro detallado.

Estos pueden pasarse antes o después del nombre del subcomando.

Nota:

Marcar superficie

Las páginas por verbo documentan las opciones principales. Como rpa-tool integra el empaquetador de Studio, un puñado de marcas de empaquetador de nicho (material de firma, configuración de fuentes de NuGet, filtros de tipo de salida) siguen las marcas nativas del empaquetador subyacente: ejecute uip rpa <verb> --help en una instalación en vivo para ver el conjunto completo para su versión de la herramienta instalada. Los nombres de los marcadores son coherentes en todas las versiones de la herramienta dentro de la línea MAYOR.MENOR de CLI; consulta Control de versiones y estabilidad.

Nota:

Envoltorio heredado solo para Windows

Una herramienta hermana, @uipath/rpa-legacy-tool (alias rpa-legacy), envuelve la .NET CLI heredada 2025.10 para los usuarios que necesitan características solo de Windows que aún no se han portado a multiplataforma uip rpa. Expone uip rpa-legacy <verb> para package, validate, debug, find-package, find-activities y type-definition. Consulta la documentación de .NET CLI 2025.10 heredado para su referencia de marcador. rpa-legacy es solo para Windows; rpa cubre la superficie moderna.

Requisitos previos

Dos restricciones del entorno rigen cuándo y dónde se pueden ejecutar los verbos del empaquetador.

Runtime.NET

Los verbos del empaquetador (pack, build, analyze, restore) envuelven el empaquetador de Studio y el compilador del flujo de trabajo, ambos respaldados por .NET. Un ejecutor que los invoque debe tener un tiempo de ejecución .NET disponible.

Para obtener el contexto completo sobre por qué rpa-tool mantiene una dependencia de.NET mientras que el resto de la CLI se ejecuta en Node.js, consulta Cambios de última hora: cambio de runtime.

Runner OS para proyectos de Windows

Los proyectos de Studio vienen en dos sabores no heredados: multiplataforma (targetFramework: "Portable" en project.json) y Windows (targetFramework: "Windows"). El sistema operativo del ejecutor debe coincidir con el tipo del proyecto:

• Los proyectos multiplataforma se pueden ejecutar desde cualquier sistema operativo: Windows, macOS o Linux.
• Los proyectos de Windows requieren un ejecutor de Windows, independientemente del verbo que esté ejecutando. La cadena de herramientas de Linux y macOS no puede resolver las referencias solo de Windows que extraen estos proyectos.
• Los proyectos Windows: heredados son una categoría independiente: requieren la herramienta uip rpa-legacy , que es solo para Windows por diseño.

Haga coincidir el sistema operativo del ejecutor en su CI con el tipo de proyecto, o divida el proceso para que el trabajo multiplataforma se ejecute en Linux/macOS y el trabajo del proyecto de Windows se ejecute en un agente de Windows.

Ver también

• Herramientas (complementos) : instala el modelo para @uipath/rpa-tool.
• Migración desde.NET CLI : mapa completo de comando a comando para los verbos del empaquetador.
• uip tools — instalar y gestionar herramientas.
• Control de versiones y estabilidad : contrato de semver para versiones de herramientas.
• Habilidades : cómo los agentes de codificación de IA impulsan los verbos uip rpa .