Omnigent Schnellstart

Von Bedeutung

Omnigent ist in Beta. Die Open-Source-Dokumentation finden Sie in der Omnigent-Dokumentation.

Omnigent wird als verwaltete Bereitstellung auf Azure Databricks ausgeführt. Der Server, der Ihre Sitzungen koordiniert, wird für Sie verwaltet, und Sie melden sich mit Ihrer Azure Databricks Arbeitsbereichsidentität an. Auf dieser Seite wird das Setup behandelt, das für Azure Databricks spezifisch ist. Weitere Informationen zu Omnigent-Features und -Funktionen finden Sie in der Open Source Omnigent-Dokumentation .

Voraussetzungen

Sie benötigen Folgendes:

Um Omnigent mit der CLI zu installieren, müssen Sie folgendes haben:

  • Python 3.12+
  • Node.js 22 LTS mit npm und tmux

Auswählen eines Hosts

Omnigent wird immer auf Ihrem verwalteten Azure Databricks Bereitstellungsserver ausgeführt. Der Host, der Ihren Agent ausführt, ist Ihr eigener Computer. Sie installieren die Omnigent CLI und registrieren Ihren Laptop oder eine VM als Host, damit Agents auf lokale Dateien, Tools oder Netzwerke zugreifen können. Ein lokaler Host ist nur verfügbar, während Ihr Computer und der omni host Prozess ausgeführt werden.

Sie melden sich mit Ihrer Azure Databricks-Workspace-Identität an, und Ihre Sitzungen werden in der <workspace-url>/omnigent Benutzeroberfläche angezeigt, wo sie mit anderen Workspace-Benutzern geteilt werden können.

Starten Sie Omnigent auf Ihrer eigenen Maschine

Installieren Sie die Omnigent CLI, und registrieren Sie Ihren Laptop oder einen virtuellen Computer als Host. Der Computer, den Sie registrieren, wird zur Ausführungsumgebung für Ihre Agents. Wählen Sie also den Computer aus, der Zugriff auf die Tools, Dateien und das Netzwerk hat, die Ihr Agent benötigt. Ein lokaler Host ist nur verfügbar, während Ihr Computer und der omni host Prozess ausgeführt werden.

  1. Installieren Sie Omnigent mit dem Zusatz databricks, der die Integration für die verwaltete Plattform hinzufügt.

    Skript installieren

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

    UV

    uv tool install "omnigent[databricks]"
    

    pip

    pip install "omnigent[databricks]"
    
  2. Richten Sie die Modellanmeldedaten ein. Ausführen omni setup:

    omni setup
    

    Omni-Einrichtung im Terminal ausführen, um Anmeldeinformationwn hinzuzufügen.

  3. Anmeldeinformationen gelten pro Harness. Daher müssen Sie zunächst ein Harness auswählen und dann festlegen, wie dessen Anmeldeinformationen bereitgestellt werden.

    • Um die Foundation Model-APIs Ihres Arbeitsbereichs aufzurufen, wählen Sie Databricks aus, und geben Sie Ihre Arbeitsbereichs-URL ein. Dadurch werden Sie im Workspace angemeldet, und die Modellaufrufe dieses Harnesses werden über Databricks Unity AI Gateway geleitet, sodass keine API-Schlüssel verwaltet werden müssen und die Nutzung dort gesteuert und abgerechnet wird.
    • Stellen Sie andernfalls Ihren eigenen API-Schlüssel, Ihr Abonnement oder Ihr Gateway bereit.
  4. Melden Sie sich mit Ihrer Azure Databricks Identität an, und registrieren Sie den Computer als Omnigent-Host:

    omni login <workspace-url>
    omni host --server <workspace-url>
    
  5. Rufen Sie im Webbrowser <workspace-url>/omnigent auf.

  6. Wählen Sie "Neue Sitzung" aus.

  7. Öffnen Sie die Hostauswahl, und wählen Sie den computer aus, den Sie registriert haben. Der ausgewählte Host bestimmt die Ausführungsumgebung, in der der Agent ausgeführt wird. Wählen Sie daher den Host aus, der Zugriff auf die Tools, Dateien und das Netzwerk hat, in der Ihr Agent benötigt wird.

    Die UI-Host-Auswahl des Omnigent-Arbeitsbereichs bei ausgewähltem registrierten lokalen Host.

  8. Beschreiben Sie eine Aufgabe im Composer und senden Sie sie, um die Sitzung zu starten.

Verbinden der Desktop-App

Die Omnigent-Desktop-App ist optional und nur unter macOS verfügbar. Installieren Sie die Desktop-App, und wählen Sie dann nach dem Erstellen eines Hosts die Option "Mit neuem Server verbinden" in der App aus, und geben Sie Ihre Arbeitsbereichs-URL ein.