Início rápido do Omnigent

Important

Omnigent está em Beta. Para a documentação open-source, consulte a documentação da Omnigent.

O Omnigent corre como uma implementação gerida no Azure Databricks. O servidor que coordena as suas sessões é gerido por si, e você inicia sessão com a identidade do seu espaço de trabalho Azure Databricks. Esta página cobre a configuração específica do Azure Databricks. Consulte a documentação de código aberto do Omnigent para mais informações sobre as funcionalidades e capacidades do Omnigent.

Pré-requisitos

Tem de ter:

• A versão preliminar do Omnigent está ativada para o seu espaço de trabalho. Consulte Gerir as pré-visualizações ao nível do espaço de trabalho.
• Um espaço de trabalho numa região que suporta o Databricks Unity AI Gateway. Veja disponibilidade de funcionalidades do Databricks por região.

Para instalar o Omnigent usando a linha de código, deve ter:

• Python 3.12+
• Node.js 22 LTS com NPM e TMUX

Escolha um anfitrião

O Omnigent é sempre executado no seu servidor de implantação gerido do Azure Databricks. O host que executa o seu agente é a sua própria máquina. Instala a CLI Omnigent e regista o seu portátil ou uma VM como host para que os agentes possam aceder a ficheiros locais, ferramentas ou redes. Um host local está disponível apenas enquanto a sua máquina e o omni host processo estiverem a correr.

Inicia sessão com a identidade do seu espaço de trabalho Azure Databricks, e as suas sessões aparecem na <workspace-url>/omnigent interface, onde podem ser partilhadas com outros utilizadores do espaço de trabalho.

Lança o Omnigent na tua própria máquina

Instala a CLI do Omnigent e regista o teu portátil ou uma VM como host. A máquina que registas torna-se o ambiente de execução dos teus agentes, por isso escolhe a máquina que tem acesso às ferramentas, ficheiros e rede de que o agente precisa. Um host local está disponível apenas enquanto a sua máquina e o omni host processo estiverem a correr.

1. Instala o Omnigent com o databricks extra, que adiciona a integração com a plataforma gerida.

   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. Configura credenciais de modelo. Executar omni setup:

   omni setup
   

   

3. As credenciais estão associadas a cada harness, pelo que deve selecionar um harness e, em seguida, escolher como fornecer as credenciais correspondentes.

   • Para invocar as APIs do Modelo Foundation do seu espaço de trabalho, escolha Databricks e introduza o URL do seu espaço de trabalho. Isto permite-te iniciar sessão no espaço de trabalho e encaminha as chamadas ao modelo desse harness através do Unity AI Gateway da Databricks, pelo que não há chaves de API para gerir e a utilização é gerida e faturada aí.
   • Caso contrário, forneça a sua própria chave de API, subscrição ou gateway.

4. Inicia sessão com a tua identidade Azure Databricks e regista a máquina como um host Omnigent:

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

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

6. Selecione Nova sessão.

7. Abre o seletor de anfitriões e seleciona a máquina que registaste. O host que selecionas determina o ambiente de execução em que o agente corre, por isso escolhe o host que tem acesso às ferramentas, ficheiros e rede de que o agente precisa.

   

8. Descreve uma tarefa no compositor e envia-a para iniciar a sessão.

Ligue a aplicação para computador ou a aplicação móvel

A aplicação de desktop Omnigent é opcional e só está disponível no macOS. Instale a aplicação de ambiente de trabalho e, depois de criar um alojamento, selecione Ligar ao novo servidor na aplicação e introduza o URL do seu espaço de trabalho.

A aplicação móvel Omnigent liga-se da mesma forma. Instale-o a partir da App Store ou use a interface web móvel em qualquer navegador de telemóvel, depois introduza a URL do seu espaço de trabalho. Para detalhes de instalação e configuração, consulte a documentação móvel do Omnigent.

Se o seu espaço de trabalho restringir o acesso à rede, um administrador pode precisar de permitir que dispositivos móveis cheguem ao espaço antes de se poder ligar. Ver acesso à rede móvel.