Início rápido do Omnigent
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 específica do Databricks. Consulte a documentação de código aberto do Omnigent para obter mais informações sobre os recursos e funcionalidades do Omnigent.
Pré-requisitos
Você deve ter um workspace em uma região que suporte o Databricks Unity AI Gateway. Consulte Disponibilidade de recursos do Databricks por região.
Para iniciar o Omnigent em um Databricks Sandbox, você também deve ter:
- Um workspace em uma região que também oferece suporte ao Databricks Sandbox. Consulte Limitações.
- Os previews do AI Gateway e do Sandbox ativados para seu workspace. Consulte Gerenciar prévias do Databricks.
Para instalar o Omnigent usando a CLI, você precisa ter:
- Python 3.12+
- Node.js 22 LTS com npm e tmux
Inicie o Omnigent em um Sandbox do Databricks
A maneira mais fácil de executar o Omnigent é com um Databricks Sandbox: um host de cloud gerenciado que o Databricks provisiona para você. Seu agente é executado em um ambiente isolado e reproduzível que permanece ativo mesmo quando seu laptop está em modo de suspensão. Os modelos são roteados pelas APIs do Foundation Model do seu workspace por meio do AI Gateway automaticamente, então não há chaves de API para gerenciar e o uso do seu modelo herda a governança e os controles do AI Gateway.
- No seu navegador da web, navegue até
<workspace-url>/omnigent. - Selecione Nova sessão .
- Abra o seletor de host e selecione Sandbox .
- Descreva uma tarefa no composer e envie-a para iniciar a sessão.

Inicie o Omnigent em sua própria máquina
Instale o Omnigent em seu laptop ou em uma VM do Databricks e registre-o como um host.
- Instale o Omnigent com o extra
databricks, que adiciona a integração com a plataforma gerenciada.
- Install script
- UV
- Pip
curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"
uv tool install "omnigent[databricks]"
pip install "omnigent[databricks]"
-
Configure as credenciais do modelo. Execute
omni setupe, em seguida, adicione uma credencial para um ou mais agentes:Bashomni setup
- Para rotear modelos por meio do AI Gateway, selecione Databricks no seletor de credenciais e insira a URL do seu workspace.
- Caso contrário, forneça sua própria API key, inscrição ou gateway.
-
Inicie sessão com a sua identidade Databricks e registe a máquina como um host Omnigent:
Bashomni login <workspace-url>
omni host --server <workspace-url> -
No seu navegador da web, navegue até
<workspace-url>/omnigent. -
Selecione Nova sessão .
-
Abra o seletor de host e selecione a máquina que você registrou.

-
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á atualmente disponível apenas para macOS. Instale o aplicativo de desktop, em seguida, depois de criar um host, selecione Conectar a um novo servidor no aplicativo e insira a URL do seu workspace.