Início rápido do Omnigent

info

Beta

O Omnigent está em Beta. Para a documentação de código aberto, consulte a documentação do Omnigent.

O Omnigent é executado como uma implantação gerenciada no Databricks. O servidor que coordena suas sessões é gerenciado para você, e você faz login com sua identidade do workspace do Databricks. Esta página aborda a configuração que é específica do Databricks. Consulte a documentação de código aberto do Omnigent para mais informações sobre os recursos e capacidades do Omnigent.

Pré-requisitos

Você deve ter:

• A prévia Omnigent habilitada para seu workspace. Consulte Gerenciar prévias em nível de workspace.
• Um workspace em uma região que oferece suporte ao Databricks Unity AI Gateway. Consulte Disponibilidade de recursos do Databricks por região.

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

• Python 3.12+
• Node.js 22 LTS com npm e tmux

Escolha um host

O Omnigent sempre é executado no seu servidor de implantação gerenciado do Databricks. O host que executa seu agente é a sua própria máquina. Você instala a CLI do Omnigent e registra seu laptop ou uma VM como um host para que os agentes possam acessar arquivos locais, ferramentas ou redes. Um host local está disponível apenas enquanto sua máquina e o processo omni host estiverem em execução.

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

Inicie o Omnigent em sua própria máquina

Instale a CLI do Omnigent e registre seu laptop ou uma VM como um host. A máquina que você registrar se torna o ambiente de execução para seus agentes, então, escolha a máquina que tenha acesso às ferramentas, arquivos e à rede de que seu agente precisa. Um host local está disponível somente enquanto sua máquina e o processo omni host estiverem em execução.

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

Install script

Bash

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

UV

Bash

uv tool install "omnigent[databricks]"

Pip

Bash

pip install "omnigent[databricks]"

2. Configurar credenciais do modelo. Execução omni setup:

   Bash

   omni setup

   

3. As credenciais têm escopo por harness, portanto, você deve selecionar um harness e, em seguida, escolher como fornecer suas credenciais.

   • Para invocar as APIs do Foundation Model do seu workspace, escolha **Databricks** e insira seu URL de workspace. Isso o conecta ao workspace e encaminha as chamadas de modelo desse harness através do Databricks Unity AI Gateway, então não há keys de API para gerenciar e o uso é governado e cobrado lá.
   • Caso contrário, forneça sua própria API key, inscrição ou gateway.

4. Inicie sessão com a sua identidade Databricks e registe a máquina como um host Omnigent:

   Bash

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

5. No seu navegador da web, vá para <workspace-url>/omnigent.

6. Selecione Nova sessão .

7. Abra o seletor de host e selecione a máquina que você registrou. O host que você selecionar determina o ambiente de execução em que o agente é executado, então, escolha o host que tenha acesso às ferramentas, arquivos e à rede de que seu agente precisa.

   

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

Conecte o aplicativo de desktop

O aplicativo de desktop Omnigent é opcional e está disponível apenas no macOS. Instale o aplicativo de desktop, em seguida, depois de ter criado um host, selecione **Conectar ao novo servidor** no aplicativo e insira seu URL de workspace.