Pular para o conteúdo principal

Comece a usar agentes de codificação

O Unity Gateway conecta agentes de codificação como Claude Code, Codex e OpenCode a modelos de vários provedores, ferramentas MCP e habilidades compartilhadas. Escolha um modelo para a tarefa, dê ao seu agente acesso aos dados da empresa e use os fluxos de trabalho da sua equipe.

Você pode se conectar de duas maneiras:

  • Use o ug (recomendado): Instale a CLI do Unity Gateway, faça login e inicie seu agente preferido. ug gerencia as configurações de conexão específicas do agente e aplica a configuração da sua organização, para que você possa começar a codificar sem editar arquivos de configuração ou gravar scripts de instalação.
  • Configure a conexão você mesmo: Insira o endpoint do gateway e as configurações de autenticação no seu agente. Consulte Agentes de codificação compatíveis para escolher seu agente e abrir o seu guia de configuração para desktop e CLI.

Este guia orienta você pelo uso de ug.

nota

Se o seu administrador já instalou o ug e configurou o seu dispositivo, prossiga diretamente para a inicialização do seu agente.

Before you begin

Você precisa de:

  • Sua URL do Workspace do Databricks e acesso aos modelos que deseja usar. Peça ao seu administrador caso não os tenha.
  • Python 3.12 ou posterior e uv.

1. Instale o ug

No terminal, execute:

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

To check the installation, run:

Bash
ug --version

O número da versão instalada deve ser exibido.

2. Lançar seu agente

Abra um terminal no diretório do seu projeto. Execute o comando para o agente que você deseja usar:

Bash
ug claude

Ao usar pela primeira vez, siga as instruções para selecionar seu workspace e fazer login. ug gerencia a conexão com o Unity Gateway e, em seguida, abre o agente escolhido com a mesma interface e o mesmo fluxo de trabalho que você já conhece. Você pode começar a usá-lo imediatamente.

Para alternar modelos durante uma sessão, use /model para escolher entre os disponíveis em sua organização.

3. Adicionar ferramentas e habilidades

No terminal, execute:

Bash
ug mcp add
ug skills add

Choose the MCP servers and skills you want to add from those you have access to. MCP tools connect your agent to data and services; skills provide instructions for specific tasks.

Em seguida, inicie ou reinicie seu agente para usar o que você adicionou:

Comando dentro do agente

O que você pode fazer

/mcp

Verifique os servidores MCP adicionados e o status da conexão deles.

/skills

Navegue pelas habilidades adicionadas e selecione uma para sua tarefa.

Comando dentro do agente

O que você pode fazer

/mcp

Verifique os servidores MCP adicionados e o status da conexão deles.

/skills

Navegue pelas habilidades adicionadas e selecione uma para sua tarefa.

Os comandos de barra variam de acordo com o agente. Verifique o menu de ajuda para comandos de modelo, MCP e habilidades. Consulte Adicionar ferramentas e habilidades para mais opções de configuração.

4. Verifique seu uso

No terminal, execute:

Bash
ug usage

Você verá quanto gastou e quanto do seu orçamento usou.

Próximos passos