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.

O Omnigent é executado como uma implantação gerenciada no Azure Databricks. O servidor que coordena suas sessões é gerenciado para você, e você faz login com sua identidade do workspace do Azure Databricks. 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 Databricks 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 e tmux

Escolher um host

O Omnigent sempre é executado no servidor de implantação Azure Databricks gerenciado. O host que executa seu agente é seu próprio computador. 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. Um host local só está disponível enquanto o computador e o omni host processo estão 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. Um host local só está disponível enquanto o computador e o omni host processo estão em execução.

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

   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 workspace e encaminha as chamadas ao modelo desse harness por meio do Databricks Unity Gateway, portanto não há chaves de API para gerenciar, e o uso é governado 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 da área de trabalho Omnigent é opcional e só está disponível no macOS. 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.