Pular para o conteúdo principal

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 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:

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.

  1. No seu navegador da web, navegue até <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 o Omnigent em seu laptop ou em uma VM do Databricks e registre-o como um host.

  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. Configure as credenciais do modelo. Execute omni setup e, em seguida, adicione uma credencial para um ou mais agentes:

    Bash
    omni setup

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

    • 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.
  2. 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>
  3. No seu navegador da web, navegue até <workspace-url>/omnigent.

  4. Selecione Nova sessão .

  5. Abra o seletor de host e selecione a máquina que você registrou.

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

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