Pular para o conteúdo principal
Última atualização em

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:

Para abrir o Omnigent em um Databricks Sandbox, você também deve ter:

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 que difere é o host que executa seu agente:

  • Databricks Sandbox (gerenciado): O Databricks provisiona e executa o host na cloud. Ele continua sendo executado quando seu laptop está desligado, e suas credenciais nunca saem do Databricks. Selecione esta opção para começar rapidamente.
  • Sua própria máquina (local): O senhor instala o CLI Omnigent e registra seu laptop ou uma VM como host. Seu laptop ou VM se torna o ambiente de execução 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.

O senhor faz login com sua identidade do workspace Databricks de qualquer forma, pois ambos os hosts são executados pelo mesmo servidor gerenciado. A visibilidade da sessão e o compartilhamento são os mesmos para ambos: suas sessões aparecem na UI <workspace-url>/omnigent e podem ser compartilhadas com outros usuários do workspace, independentemente de qual host as executa.

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.

  1. No seu navegador da web, vá para <workspace-url>/omnigent.
  2. Selecione Nova sessão .
  3. Abra o seletor de host e selecione Sandbox .
  4. Descreva uma tarefa no composer e envie-a para iniciar a sessão.

Seletor de host da interface do usuário do workspace Omnigent com o Databricks sandbox selecionado.

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.
Bash
curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"

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

    Bash
    omni setup

    Executando a configuração do omni no terminal para começar a adicionar credenciais de harness.

  2. 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.

  3. 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>

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

  5. Selecione Nova sessão .

  6. 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.

    Seletor de host da interface do usuário do workspace Omnigent com um host local registrado selecionado.

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

Conecte o aplicativo para desktop ou o aplicativo móvel​

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.

O aplicativo móvel Omnigent conecta da mesma forma. Instale-o na App Store ou use a interface web móvel em qualquer navegador de celular, depois, insira o URL do Workspace. Para detalhes de instalação e configuração, consulte a documentação móvel do Omnigent.

Se o seu workspace restringir o acesso à rede, um administrador talvez precise permitir que os dispositivos móveis alcancem o workspace antes que seja possível conectar. Consulte acesso à rede móvel.

Nesta página