Omnigent — szybki start

Important

Omnigent jest w wersji beta. Aby zapoznać się z dokumentacją typu open source, zobacz dokumentację omnigenta.

Omnigent działa jako wdrożenie zarządzane w Azure Databricks. Serwer, który koordynuje Twoje sesje, jest zarządzany za Ciebie, a Ty logujesz się przy użyciu tożsamości obszaru roboczego usługi Azure Databricks. Ta strona obejmuje konfigurację specyficzną dla Azure Databricks. Aby uzyskać więcej informacji na temat funkcji i możliwości omnigentów typu open source, zobacz dokumentację omnigentów .

Prerequisites

Musisz mieć:

• Wersja zapoznawcza Omnigent jest włączona dla obszaru roboczego. Zobacz Zarządzanie podglądami na poziomie obszaru roboczego.
• Przestrzeń robocza w regionie obsługującym Databricks Unity Gateway. Zobacz Dostępność funkcji usługi Databricks według regionów.

Aby zainstalować aplikację Omnigent przy użyciu interfejsu wiersza polecenia, musisz mieć następujące elementy:

• Python 3.12+
• Node.js 22 LTS z npm i tmux

Wybieranie hosta

Narzędzie Omnigent zawsze działa na zarządzanym serwerze wdrażania Azure Databricks. Host, na którym działa agent, to twój własny komputer. Możesz zainstalować interfejs wiersza polecenia Omnigent i zarejestrować laptopa lub maszynę wirtualną jako hosta, aby agenci mogli uzyskiwać dostęp do lokalnych plików, narzędzi lub sieci. Host lokalny jest dostępny tylko wtedy, gdy maszyna i omni host proces są uruchomione.

Logujesz się za pomocą tożsamości obszaru roboczego Azure Databricks, a Twoje sesje są wyświetlane w interfejsie użytkownika <workspace-url>/omnigent, gdzie można je udostępniać innym użytkownikom obszaru roboczego.

Uruchamianie narzędzia Omnigent na własnej maszynie

Zainstaluj interfejs wiersza polecenia Omnigent i zarejestruj laptopa lub maszynę wirtualną jako hosta. Maszyna, którą zarejestrujesz, stanie się środowiskiem uruchomieniowym dla Twoich agentów, dlatego wybierz maszynę, która ma dostęp do narzędzi, plików i sieci, których potrzebuje Twój agent. Host lokalny jest dostępny tylko wtedy, gdy maszyna i omni host proces są uruchomione.

1. Zainstaluj Omnigent z opcją dodatkową databricks, która dodaje integrację z zarządzaną platformą.

   Instalowanie skryptu

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

   UV

   uv tool install "omnigent[databricks]"
   

   Pip

   pip install "omnigent[databricks]"
   

2. Konfigurowanie poświadczeń modelu. Uruchom polecenie omni setup:

   omni setup
   

   

3. Poświadczenia są przypisane do konkretnego harness, więc musisz najpierw wybrać harness, a następnie określić sposób dostarczenia jego poświadczeń.

   • Aby wywołać interfejsy API modeli bazowych w obszarze roboczym, wybierz Databricks i wprowadź adres URL obszaru roboczego. To loguje Cię do obszaru roboczego i kieruje wywołania modelu tego harnessu przez Databricks Unity Gateway, więc nie ma kluczy API do zarządzania, a korzystanie jest tam nadzorowane i rozliczane.
   • W przeciwnym razie podaj własny klucz interfejsu API, subskrypcję lub bramę.

4. Zaloguj się za pomocą tożsamości Azure Databricks i zarejestruj maszynę jako hosta Omnigent host:

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

5. W przeglądarce internetowej przejdź do strony <workspace-url>/omnigent.

6. Wybierz pozycję Nowa sesja.

7. Otwórz selektor hosta i wybierz zarejestrowaną maszynę. Wybrany host określa środowisko wykonywania, w którym działa agent, dlatego wybierz hosta, który ma dostęp do narzędzi, plików i sieci potrzebnych agentów.

   

8. Opisz zadanie w kompozytorze i wyślij je, aby rozpocząć sesję.

Łączenie aplikacji klasycznej lub aplikacji mobilnej

Aplikacja komputerowa Omnigent jest opcjonalna i dostępna tylko w systemie macOS. Zainstaluj aplikację klasyczną, a następnie po utworzeniu hosta wybierz pozycję Połącz z nowym serwerem w aplikacji i wprowadź adres URL obszaru roboczego.

Aplikacja mobilna Omnigent łączy się w ten sam sposób. Zainstaluj go ze sklepu App Store lub użyj mobilnego internetowego interfejsu użytkownika w dowolnej przeglądarce telefonicznej, a następnie wprowadź adres URL obszaru roboczego. Aby uzyskać szczegółowe informacje na temat instalacji i konfiguracji, zobacz dokumentację aplikacji mobilnej Omnigent.

Jeśli obszar roboczy ogranicza dostęp do sieci, administrator może wymagać zezwolenia urządzeniom przenośnym na dostęp do obszaru roboczego, zanim będzie można nawiązać połączenie. Zobacz Dostęp do sieci mobilnej.