referência da CLI ug
Use a CLI do Unity Gateway (ug) para configurar e iniciar agentes de programação. Para ver um passo a passo, consulte o início rápido de agente de programação.
Instalar
Instale ug e, em seguida, verifique a versão instalada:
uv tool install git+https://github.com/databricks/unity-gateway
ug --version
Requer uv e Python 3.12 ou posterior.
Configurar
Comando | O que o recurso faz |
|---|---|
| Faça login em um workspace do Databricks e configure seus agentes usando as configurações do seu administrador ou a configuração guiada. |
| Configure seus agentes para usar o workspace no URL especificado. |
| Autentique com um access token pessoal em vez de OAuth. Primeiro, execute |
Lançar um agente
Esses comandos abrem o agente no seu terminal, prontos para o seu fluxo de trabalho de codificação habitual.
Comando | O que o recurso faz |
|---|---|
| Inicie o agente selecionado pela configuração do workspace publicada pelo seu administrador. |
| Iniciar o Claude Code por meio do Unity Gateway. |
| Inicie o Codex por meio do Unity Gateway. |
| Inicie o Gemini CLI por meio do Unity Gateway. |
| Inicie o OpenCode por meio do Unity Gateway. |
| Inicie a CLI do GitHub Copilot por meio do Unity Gateway. |
| Inicie o Pi por meio do Unity Gateway. |
| Iniciar o Cursor Agent. As solicitações de modelo usam sua account do Cursor. |
Para o Claude Code ou o Codex, adicione --refresh para dar refresh na autenticação, nos modelos e na configuração do workspace antes de iniciar. Você também pode passar argumentos específicos do agente para o comando de inicialização.
Servidores MCP
Comando | O que o recurso faz |
|---|---|
| Selecione servidores MCP e adicione as conexões deles aos seus agentes configurados. |
| Mostrar os servidores MCP configurados e o status relatado por cada agente. |
| Selecione as conexões MCP a serem removidas de seus agentes. Os servidores permanecem no workspace. |
Habilidades
Comando | O que o recurso faz |
|---|---|
| Selecione as habilidades publicadas e faça o download dos arquivos delas nos diretórios de habilidades de agente locais. |
| Connect skills from selected Unity Catalog schemas through MCP, without downloading files. |
| Mostrar as habilidades configuradas para seus agentes e como elas foram adicionadas. |
| Selecione as pastas de habilidades **download** para excluir do seu computador. As habilidades publicadas permanecem inalteradas. |
| Remover os esquemas selecionados da conexão MCP do registro de habilidades. Os arquivos de habilidades download são mantidos. |
Para servidores e habilidades nomeados, seleção de esquemas e downloads de projetos, consulte Adicionar ferramentas e habilidades.
Gerencie sua configuração
Comando | O que o recurso faz |
|---|---|
| Exiba os seus gastos atuais, o orçamento total e a porcentagem usada. |
| Verifique sua instalação local e a configuração do agente e ofereça correções para os problemas encontrados. |
| Instale a versão mais recente do Unity Gateway CLI a partir do GitHub. |
| Exiba a configuração do agente de codificação salva do seu administrador como JSON para reutilização. |
| Restaure os arquivos de configuração do agente que tiveram backup feito e limpe o estado de configuração salvo de |
Ajuda do comando
Use --help para ver as opções da sua versão instalada:
Comando | O que o recurso faz |
|---|---|
| Mostrar os comandos disponíveis e as opções gerais. |
| Mostrar opções de configuração de workspace e agente. |
| Mostrar opções para download de skills ou para conectá-las por meio do MCP. |