- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- UiPath para agentes de codificación
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- UIP Docsai
- añadir-entidad-de-datos-de-prueba
- añadir-cola-de-datos-de-prueba
- añadir-variación-de-datos-de-prueba
- Analizar
- Crear
- Crear proyecto
- Diferencia
- Buscar actividades
- obtener-reglas-del-analizador
- obtener-predeterminado-actividad-xaml
- obtener-errores
- obtener-casos-de-prueba-manual
- obtener-pasos-de-prueba-manual
- obtener versiones
- get-workflow-example
- indicar-aplicación
- indicar-elemento
- inspeccionar-paquete
- install-data-fabric-entities
- instalar-o-actualizar-paquetes
- enumerar-data-fabric-entities
- ejemplos-de-flujo-de-trabajo-de-lista
- Paquete
- restore
- archivo de ejecución
- plantillas-de-búsqueda
- iniciar-studio
- detener la ejecución
- UIA
- Seguimientos de UIP
- Migración
- Referencia y soporte
Guía del usuario de UiPath CLI
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.
Before running the packager verbs in CI or on a fresh machine, make sure your runtime and runner OS match the project flavor — see Prerequisites.
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]
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.
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.
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
Two environmental constraints govern when and where the packager verbs can run.
.NET runtime
The packager verbs (pack, build, analyze, restore) wrap the Studio packager and the workflow compiler — both .NET-backed. A runner that invokes them must have a .NET runtime available.
For the full context on why rpa-tool keeps a .NET dependency while the rest of the CLI runs on Node.js, see Breaking changes — Runtime change.
Runner OS for Windows projects
Studio projects come in two non-legacy flavors — Cross-platform (targetFramework: "Portable" in project.json) and Windows (targetFramework: "Windows"). The runner OS must match the project flavor:
- Cross-platform projects can be operated on from any OS — Windows, macOS, or Linux.
- Windows projects require a Windows runner, regardless of which verb you are running. The Linux and macOS toolchain cannot resolve the Windows-only references these projects pull in.
- Los proyectos Windows: heredados son una categoría independiente: requieren la herramienta
uip rpa-legacy, que es solo para Windows por diseño.
Match the runner OS in your CI to the project flavor, or split the pipeline so cross-platform work runs on Linux/macOS and Windows project work runs on a Windows agent.
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.