uip (comandos básicos)

Comandos básicos en UiPath CLI que no requieren instalación de herramientas, que cubren la autenticación, el ciclo de vida de la herramienta, las habilidades, el puente MCP y la finalización del shell.

La superficie de comandos del núcleo es todo lo que se incluye en el host (@uipath/cli), sin necesidad de instalar ninguna herramienta. Estos comandos gestionan la autenticación, el ciclo de vida de la herramienta, las habilidades del agente de codificación de IA, el puente MCP y la finalización del shell. Todos los comandos de esta página están disponibles en el momento en que finaliza npm install -g @uipath/cli .

Para los comandos que se comunican con una superficie de UiPath (Orchestrator, Soluciones, Agentes, etc.), consulta las páginas de referencia por herramienta: cada una se proporciona mediante un paquete npm independiente que el host carga bajo demanda.

Los comandos del host

El host CLI registra 11 comandos de nivel superior (uip track es telemetría interna oculta y no está orientada al usuario; los otros 10 son):

Comando	Propósito	Se requiere inicio de sesión
uip login	Autenticarse a través de OAuth2 interactivo, aplicación externa, variables de entorno o identidad federada/de carga de trabajo; cambiar de tenant. Escribe una sesión en .uipath/.auth.	—
uip logout	Elimina el archivo de credenciales.	—
uip login status	Muestra la organización actual, el tenant, la caducidad y qué archivo de credenciales está leyendo la CLI.	Opcional (informa Not logged in de lo contrario)
uip config	Obtener, establecer y borrar los valores de configuración CLI locales (incluidas las lecturas de version-pin uip tools update).	—
uip user	Muestra la identidad del usuario actualmente autenticado.	Sí
uip feedback	Envía comentarios sobre la CLI.	—
uip tools	Enumera, busca, instala, actualiza y desinstala las herramientas instalables (Orchestrator, Solution, Agent, Test Manager, …).	—
uip skills	Instala las habilidades de UiPath en los agentes de codificación de IA.	—
uip mcp	Exponer CLI como servidor de protocolo de contexto de modelo a través de stdio.	Por run_command (hereda la sesión basada en archivo).
uip update	Actualiza automáticamente la CLI, sus herramientas instaladas y las habilidades instaladas.	—
uip completion	Instalar o imprimir la finalización de la pestaña del shell (bash, zsh, fish, pwsh).	—

Sinopsis

uip login [--tenant <name>] [--organization <name>] [--authority <url>] [--client-id <id>] [--client-secret <secret> | --client-assertion <jwt>] [--scope <scopes>] [--no-browser] [-f <folder>]
uip login status                       [-f <folder>]
uip login refresh                      [--login-validity <minutes>]
uip login which                        [-f <folder>]
uip login tenant list                  [-f <folder>]
uip login tenant set <name>            [-f <folder>]
uip logout                             [-f <folder>]
uip config get / set / clear <key>
uip user
uip feedback send
uip tools list / search / install / update / uninstall …
uip skills list / search / show / install / update / uninstall --agent <name>
uip mcp serve
uip update [--dry-run] [--tools-only] [--skills-only]
uip completion [shell] [--print] [--uninstall]

Cada comando también respeta el marcador global --interactive/--no-interactive (consulta Opciones globales): no existe una forma abreviada específica de comando para ello.

Todos los comandos básicos respetan las opciones globales (--output, --output-filter, --log-level, --log-file, --profile, --interactive/--no-interactive) y siguen el contrato de código de salida estándar.

Cómo se relaciona la superficie del núcleo con las herramientas

Cada invocación uip <tool> … se ejecuta sobre estos:

1. La autenticación se establece una vez con uip login y es heredada por cada llamada de herramienta posterior (Orchestrator, Solución, Agente, …).
2. El ciclo de vida de la herramienta (uip tools install) controla qué paquetes de extensión se cargan la próxima vez que se invoca un prefijo de herramienta.
3. Las habilidades se encuentran junto a las herramientas: enseñan a los agentes de IA a utilizar uip en lugar de añadir nuevos comandos.
4. MCP envuelve toda la superficie (herramientas básicas + instaladas) como una única herramienta MCP a la que cualquier cliente compatible con MCP puede llamar.
5. La finalización descubre los comandos en el momento de la instalación, así que vuelve a ejecutar uip completion después de uip tools install si quieres que se completen los comandos recién añadidos.

Consulta Cómo se organiza UiPath CLI para la arquitectura host-vs-tool en profundidad.

Forma de autenticación

Todos los comandos básicos, excepto los propios comandos de autenticación, funcionan sin una sesión: solo se comunican con los archivos locales (config, manifest, script de finalización). Los comandos de autenticación gestionan la propia sesión:

• uip login : OAuth2 interactivo (navegador), aplicación externa (credenciales de cliente), token de variable de entorno e identidad federada/de carga de trabajo (--client-assertion). Consulta Autenticación. --profile delimita el ámbito de la sesión a un conjunto de credenciales con nombre, ortogonal al flujo que utilizas.
• uip logout : elimina el archivo. El flujo env-var no tiene nada que borrar.
• uip login status : informa de la sesión activa.
• uip login refresh : actualiza de forma proactiva el token de acceso y emite una carga útil de sesión legible por la máquina para los consumidores programáticos.
• uip login which — imprime desde dónde se resolvió el archivo de sesión/credencial activo.
• uip login tenant list / set : cambia de tenant sin volver a autenticar.

Los comandos de herramientas heredan cualquier sesión que esté en el disco en el momento de la invocación; --tenant anula por llamada.

Donde cada comando envía su salida

Transmisión	Contenido
Salida estándar	El sobre JSON estructurado (Result, Code, Data, …). Uno por invocación.
Estándar	Registros (controlados por --log-level), indicadores de progreso y texto de error legible por humanos. JSON nunca analizable por máquina.

La división se aplica en todas partes; puedes redirigirlos de forma independiente:

uip tools list > tools.json 2> uip.log

Consulta Formatos de salida para los cinco formatos (json, table, yaml, plain, markdown) y el filtrado JMESPath.

Ver también

• Conceptos: cómo se organiza UiPath CLI : qué significa "host" y por qué el núcleo se divide de las herramientas.
• Conceptos: herramientas (complementos) : la lista blanca de instalación automática y la fijación de versiones.
• Conceptos: habilidades : cómo uip skills install extiende los agentes de IA.
• Conceptos: sesiones y credenciales : qué escribe uip login y dónde.
• Autenticación : los flujos de autenticación en detalle, incluido el inicio de sesión de identidad federada/de carga de trabajo.
• Opciones globales, códigos de salida : contratos compartidos por cada comando.