Início rápido do Omnigent

Importante

Omnigent está em Beta. Para obter a documentação de software livre, consulte a documentação do Omnigent.

Omnigent no Azure Databricks é uma implantação gerenciada do servidor integrada ao provedor de identidade do seu espaço de trabalho e ao Unity Gateway. Este servidor coordena suas sessões e permite que você colabore com outras pessoas. Esta página aborda a configuração específica para Azure Databricks. Consulte a documentação do Omnigent de software livre para obter mais informações sobre recursos e funcionalidades do Omnigent.

Pré-requisitos

Você deve ter:

• A versão prévia do Omnigent foi habilitada para o seu espaço de trabalho. Consulte Gerenciar pré-visualizações no nível do espaço de trabalho.
• Um espaço de trabalho em uma região que suporta o Unity Gateway. Consulte a disponibilidade de recursos do Databricks por região.

Para instalar o Omnigent usando a CLI, você deve ter:

• Python 3,12+
• Node.js 22 LTS com npm
• tmux (apenas macOS e Linux)

Escolha um apresentador ou corredor

O Managed Omnigent roda o servidor no Azure Databricks. O host ou runner em que seu agente executa suas tarefas é a sua própria máquina. Instale a CLI do Omnigent e registre seu laptop ou uma VM como host para que os agentes possam acessar arquivos locais, ferramentas ou redes. Esse host só está disponível enquanto a máquina está ligada e o omni host processo está em execução.

Você faz login com sua identidade do workspace do Azure Databricks, e suas sessões aparecem na interface do <workspace-url>/omnigent, onde elas podem ser compartilhadas com outros usuários do workspace.

Inicie o Omnigent em seu próprio computador

Instale a CLI do Omnigent e registre seu laptop ou uma VM como host. O computador registrado torna-se o ambiente de execução para seus agentes, portanto, escolha o computador que tem acesso às ferramentas, arquivos e rede de que seu agente precisa. Esse host só está disponível enquanto a máquina está ligada e o omni host processo está em execução.

1. Instale o Omnigent com o databricks extra, que adiciona a integração de plataforma gerenciada.

   Note

   No Windows, use a aba UV, porque o script de instalação suporta apenas macOS e Linux. Os wrappers de terminal baseados em TMUX não estão disponíveis no Windows, e os agentes rodam sem isolamento do sistema de arquivos ou da rede. Veja a seção Windows do Omnigent README.

   Instalar script

   curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"
   

   UV

   uv tool install "omnigent[databricks]"
   

   Pip

   pip install "omnigent[databricks]"
   

2. Configurar credenciais de modelo. Executar omni setup:

   omni setup
   

   

3. As credenciais são específicas de cada harness, portanto você deve selecionar um harness e, em seguida, escolher como fornecer essas credenciais.

   • Para invocar as APIs do Modelo de Base do workspace, escolha Databricks e insira a URL do workspace. Isso conecta você ao espaço de trabalho e encaminha, pelo Unity Gateway, as chamadas ao modelo desse harness, de modo que não há chaves de API para gerenciar, e o uso é controlado e cobrado por lá.
   • Caso contrário, forneça sua própria chave de API, assinatura ou gateway.

4. Entre com sua identidade Azure Databricks e registre o computador como um host Omnigent:

   omni login <workspace-url>
   omni host --server <workspace-url>
   

5. No navegador da Web, acesse <workspace-url>/omnigent.

6. Selecione Nova sessão.

7. Abra o seletor de host e selecione o computador que você registrou. O host selecionado determina o ambiente de execução em que o agente é executado, portanto, escolha o host que tem acesso às ferramentas, arquivos e rede de que seu agente precisa.

   

8. Descreva uma tarefa no compositor e envie-a para iniciar a sessão.

Conectar o aplicativo para desktop ou o aplicativo móvel

O aplicativo desktop Omnigent é opcional e está disponível no macOS, Windows e Linux. Instale o aplicativo da área de trabalho e, depois de criar um host, selecione Conectar-se ao novo servidor no aplicativo e insira a URL do workspace.

O aplicativo móvel Omnigent se conecta da mesma maneira. Instale-o pela App Store ou use a interface web móvel em qualquer navegador de celular e depois insira a URL do seu espaço de trabalho. Para obter detalhes sobre instalação e configuração, consulte a documentação móvel da Omnigent.

Se o espaço de trabalho restringir o acesso à rede, talvez um administrador precise permitir que dispositivos móveis acessem o espaço de trabalho antes que você possa se conectar. Consulte o acesso à rede móvel.