Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
Para los requisitos, consulta los requisitos previos de inicio rápido.
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 --agents claude,codex |
Configura los agentes listados sin que te lo pidan. Para añadir también servidores MCP, añade --mcp con sus nombres completos del catálogo de Unity. Consulta Añadir servidores MCP directamente. |
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.
Para lanzar un agente con un modelo específico, como en un script, añade --model el nombre completo del Catálogo de Unity del modelo. Esto funciona con ug claude, ug codex, y ug copilot:
ug claude --model <full-model-name>
Para elegir un modelo de forma interactiva después de que el agente comience, introduzca /model.
Servidores MCP
Para el selector de servidores, otros servidores MCP de Azure Databricks y la configuración para otros clientes MCP, consulta Añadir herramientas y habilidades.
| 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. |
Añadir servidores MCP directamente
Para añadir servidores MCP sin el selector, pasa sus nombres completos del Catálogo de Unity (<catalog>.<schema>.<server-name>) a --names:
ug mcp add --names system.ai.github,system.ai.slack
Los nombres de un comando deben estar en el mismo esquema. De lo contrario, ug devuelve un error. Para añadir un servidor desde otro esquema, ejecuta ug mcp add de nuevo:
ug mcp add --names "<catalog>.<schema>.<server-name>"
Para añadir cada servidor MCP en un esquema:
ug mcp add --location "<catalog>.<schema>"
Por defecto, ug mcp add añade servidores a cada uno de tus agentes configurados y no elimina las conexiones existentes. Para añadir servidores solo a agentes específicos, añade --agents:
ug mcp add --agents claude,codex --names system.ai.github
Para configurar un agente y añadir sus servidores MCP en un solo comando, use ug configure con --mcp:
ug configure --agents claude --mcp system.ai.github,system.ai.slack
Reinicia tu agente con su comando habitual ug y luego corre ug mcp list para comprobar las conexiones.
Añadir servidores MCP para todos los desarrolladores (administradores)
Un administrador de espacio de trabajo puede añadir servidores MCP para cada desarrollador en el espacio de trabajo mediante una configuración de agente de codificación. Listelos mcp_servers.sources en el nivel superior de la configuración. Cada entrada es el nombre<catalog>.<schema>.<server-name> completo () de un servidor o bien un esquema completo (<catalog>.<schema>.*), y las entradas pueden proceder de diferentes esquemas. Por ejemplo, esta configuración mantiene todos los servidores dentro system.ai y añade un servidor de otro esquema:
{
"mcp_servers": {
"sources": ["system.ai.*", "<catalog>.<schema>.<server-name>"]
}
}
Para obtener más información, consulte mcp_servers.
Los desarrolladores se encargan ug configure de sincronizar los servidores con sus agentes. Pueden añadir más servidores con ug mcp add, que salta los servidores que ya proporciona la configuración del 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 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 los límites de gasto aplicables y el porcentaje utilizado. Consulta tu consumo. |
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. |
Comprueba tu uso
Consulta los límites de gasto de Unity Gateway que se aplican a ti.
| Comando | Qué hace |
|---|---|
ug usage |
Muestra hasta cinco límites de gasto aplicables, ordenados del porcentaje más alto al menor utilizado. |
ug usage --all |
Muestra todos los límites de gasto aplicables en el mismo orden. |
Cada entrada incluye un pequeño ID de presupuesto y una de las siguientes etiquetas:
| Etiqueta | Lo que muestra |
|---|---|
| Límite personal mensual | Tu consumo respecto al umbral por usuario del presupuesto para el mes. |
| Límite compartido mensual | Uso combinado entre usuarios cubiertos por el presupuesto frente a su umbral compartido para el mes. |
| Límite personal diario | Tu consumo en relación con el umbral por usuario del presupuesto para ese día. |
| Límite compartido diario | Uso combinado entre usuarios cubiertos por el presupuesto frente a su umbral compartido para el día. |
Tus gastos pueden contar para varios límites aplicables. Un solo presupuesto puede contener varios límites, por lo que varias entradas pueden compartir un ID de presupuesto.
Para más información sobre presupuestos y umbrales, consulte Establecer presupuestos y límites de gasto para Unity Gateway.
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 mcp add --help |
Mostrar opciones para añadir servidores MCP por nombre, esquema o agente. |
ug skills add --help |
Muestra opciones para descargar habilidades o conectarlas a través de MCP. |