Referência CLI ug

Use a CLI do Gateway Unity (ug) para configurar e lançar agentes de codificação. Para uma explicação, consulte o quickstart do agente de codificação.

Install

Instale, ugdepois verifique a versão instalada:

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

Para requisitos, consulte os pré-requisitos de início rápido.

Configure

Comando O que faz
ug configure Inicie sessão num espaço de trabalho do Azure Databricks e configure os seus agentes usando as definições do seu administrador ou configuração guiada.
ug configure --workspace https://your-workspace.databricks.com Configure os seus agentes para usarem o espaço de trabalho na URL especificada.
ug configure --profile <name> --use-pat Autentica com um token de acesso pessoal em vez de OAuth. Primeiro, execute databricks configure --host <workspace-url> para guardar o seu token num perfil de configuração, depois passe esse perfil com --profile (por exemplo, --profile DEFAULT). O perfil fornece a URL do espaço de trabalho.

Lançar um agente

Estes comandos abrem o agente no seu terminal, pronto para o seu fluxo de trabalho habitual de codificação.

Comando O que faz
ug Inicie o agente selecionado pela configuração de espaço de trabalho publicada pelo seu administrador.
ug claude Lançar o Claude Code através do Unity Gateway.
ug codex Lançar o Codex através do Unity Gateway.
ug gemini Lançar a CLI Gemini através do Unity Gateway.
ug opencode Inicie o OpenCode através do Unity Gateway.
ug copilot Inicie a CLI do GitHub Copilot através do Unity Gateway.
ug pi Lançar o Pi através do Unity Gateway.
ug cursor Lançar o Agente do Cursor. Os pedidos de modelos usam a tua conta Cursor.

Para Claude Code ou Codex, adicione --refresh à atualização autenticação do workspace, modelos e configuração antes de lançar. Também podes passar argumentos específicos do agente ao comando de lançamento.

Servidores MCP

Comando O que faz
ug mcp add Seleciona os servidores MCP e adiciona as suas ligações aos teus agentes configurados.
ug mcp list Mostrar servidores MCP configurados e o estado reportado por cada agente.
ug mcp remove Selecione ligações MCP para remover dos seus agentes. Os servidores permanecem no espaço de trabalho.

Competências

Comando O que faz
ug skills add Selecione as competências publicadas e descarregue os seus ficheiros para diretórios de competências dos agentes locais.
ug skills add --via mcp Ligue competências de esquemas selecionados do Catálogo Unity através do MCP, sem descarregar ficheiros.
ug skills list Mostra as competências configuradas para os teus agentes e como foram adicionadas.
ug skills remove Selecione pastas de habilidades descarregadas para eliminar do seu computador. As competências publicadas mantêm-se inalteradas.
ug skills remove --via mcp Remover esquemas selecionados da ligação MCP do registo de competências. Os ficheiros de habilidades descarregados são mantidos.

Para servidores e competências nomeadas, seleção de esquemas e downloads de projetos, consulte Adicionar ferramentas e competências.

Gere a sua configuração

Comando O que faz
ug usage Mostre os seus gastos atuais, orçamento total e percentagem utilizada.
ug doctor Verifique a instalação local e a configuração do agente, e ofereça soluções para os problemas encontrados.
ug upgrade Instale a versão mais recente da CLI do Unity Gateway a partir do GitHub.
ug export Imprime a configuração do agente de codificação guardada pelo administrador como JSON para reutilização.
ug revert Restaurar os ficheiros de configuração do agente com backup e limpar ugo estado de configuração guardado.

Ajuda do comando

Use --help para ver as opções da sua versão instalada:

Comando O que faz
ug --help Mostra comandos disponíveis e opções gerais.
ug configure --help Mostrar as opções de configuração do espaço de trabalho e do agente.
ug skills add --help Mostre opções para descarregar competências ou ligá-las através do MCP.
  • Última atualização a