Referencia a la CLI de ug

Utiliza la CLI de Unity Gateway (ug) para configurar y lanzar agentes de codificación. Para una guía, consulta el programa de inicio rápido del agente de codificación.

Install

Instala ug, luego revisa la versión instalada:

uv tool install git+https://github.com/databricks/unity-gateway
ug --version

Requiere uv Python 3.12 o posterior.

Configure

Comando	Qué hace
ug configure	Inicia sesión en un espacio de trabajo de Azure Databricks y configura tus agentes usando la configuración o la configuración guiada de tu administrador.
ug configure --workspace https://your-workspace.databricks.com	Configura a tus agentes para que usen el espacio de trabajo en la URL especificada.
ug configure --profile <name> --use-pat	Autentica con un token de acceso personal en lugar de OAuth. Primero ejecuta databricks configure --host <workspace-url> para guardar tu token en un perfil de configuración, luego pasa ese perfil con --profile (por ejemplo, --profile DEFAULT). El perfil proporciona la URL del espacio de trabajo.

Lanzar un agente

Estos comandos abren el agente en tu terminal, listo para tu flujo de trabajo habitual de codificación.

Comando	Qué hace
ug	Lanza el agente seleccionado por la configuración de espacio de trabajo publicada por tu administrador.
ug claude	Lanza Claude Code a través de Unity Gateway.
ug codex	Lanzar el Codex a través de Unity Gateway.
ug gemini	Lanza la CLI Gemini a través de Unity Gateway.
ug opencode	Lanza OpenCode a través de Unity Gateway.
ug copilot	Lanza la CLI de GitHub Copilot a través de Unity Gateway.
ug pi	Lanza Pi a través de Unity Gateway.
ug cursor	Lanza el Agente del cursor. Las solicitudes de modelo usan tu cuenta Cursor.

Para Claude Code o Codex, añade --refresh a la actualización la autenticación del espacio de trabajo, los modelos y la configuración antes de lanzar. También puedes pasar argumentos específicos de los agentes al comando de lanzamiento.

Servidores MCP

Comando	Qué hace
ug mcp add	Selecciona servidores MCP y añade sus conexiones a tus agentes configurados.
ug mcp list	Mostrar servidores MCP configurados y el estado reportado por cada agente.
ug mcp remove	Selecciona conexiones MCP para eliminar de tus agentes. Los servidores permanecen en el espacio de trabajo.

Habilidades

Comando	Qué hace
ug skills add	Selecciona las habilidades publicadas y descarga sus archivos en directorios de habilidades de agentes locales.
ug skills add --via mcp	Conecta habilidades de esquemas seleccionados del catálogo de Unity a través de MCP, sin necesidad de descargar archivos.
ug skills list	Muestra las habilidades configuradas para tus agentes y cómo se han añadido.
ug skills remove	Selecciona carpetas de habilidades descargadas para eliminar de tu ordenador. Las habilidades publicadas permanecen sin cambios.
ug skills remove --via mcp	Elimina los esquemas seleccionados de la conexión MCP del registro de habilidades. Se conservan los archivos de habilidades descargados.

Para servidores y habilidades nombradas, selección de esquemas y descargas de proyectos, consulta Añadir herramientas y habilidades.

Gestiona tu configuración

Comando	Qué hace
ug usage	Muestra tu gasto actual, presupuesto total y porcentaje utilizado.
ug doctor	Revisa la instalación local y la configuración del agente, y ofrece soluciones para los problemas encontrados.
ug upgrade	Instala la última versión de la CLI de Unity Gateway desde GitHub.
ug export	Imprime la configuración guardada del agente de codificación de tu administrador como JSON para reutilizarla.
ug revert	Restaura los archivos de configuración del agente respaldado y borra ugel estado de configuración guardado de la empresa.

Ayuda del mando

Úsalo --help para ver las opciones de tu versión instalada:

Comando	Qué hace
ug --help	Muestra los comandos disponibles y las opciones generales.
ug configure --help	Muestra las opciones de configuración del espacio de trabajo y del agente.
ug skills add --help	Muestra opciones para descargar habilidades o conectarlas a través de MCP.