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.
  • Last updated on