オムニジェント クイックスタート

重要

オムニジェントは ベータ版です。 オープン ソースのドキュメントについては、 Omnigent のドキュメントを参照してください

オムニジェントは、Azure Databricksでマネージド デプロイとして実行されます。 セッションを調整するサーバーは自動的に管理され、Azure Databricks ワークスペース ID を使用してサインインします。 このページでは、Azure Databricksに固有のセットアップについて説明します。 オムニジェントの機能の詳細については、 オープンソースの Omnigent ドキュメント を参照してください。

前提条件

以下のものが必要です:

CLI を使用して Omnigent をインストールするには、次のものが必要です。

  • Python 3.12 以降
  • npm および tmux 付きの Node.js 22 LTS

ホストを選択する

オムニジェントは、常にマネージド Azure Databricks 展開サーバーで実行されます。 エージェントを実行するホストは、独自のマシンです。 エージェントがローカル ファイル、ツール、またはネットワークにアクセスできるように、Omnigent CLI をインストールし、ラップトップまたは VM をホストとして登録します。 ローカル ホストは、コンピューターと omni host プロセスの実行中にのみ使用できます。

Azure Databricks ワークスペース ID を使用してサインインすると、セッションが<workspace-url>/omnigent UI に表示され、他のワークスペース ユーザーと共有できます。

自分のマシンで Omnigent を起動する

Omnigent CLI をインストールし、ラップトップまたは VM をホストとして登録します。 登録したマシンがエージェントの実行環境になるため、エージェントが必要とするツール、ファイル、ネットワークにアクセスできるマシンを選択します。 ローカル ホストは、コンピューターと omni host プロセスの実行中にのみ使用できます。

  1. databricksを追加して Omnigent をインストールすると、マネージド プラットフォームの統合が追加されます。

    スクリプトのインストール

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

    UV

    uv tool install "omnigent[databricks]"
    

    pip

    pip install "omnigent[databricks]"
    
  2. モデルの認証情報を設定します。 omni setupを実行します。

    omni setup
    

    ターミナルでオムニ セットアップを実行して、ハーネス資格情報の追加を開始します。

  3. 資格情報はハーネスごとにスコープが設定されるため、ハーネスを選択してから、その資格情報を指定する方法を選択する必要があります。

    • ワークスペースの Foundation Model API を呼び出すには、 Databricks を選択し、ワークスペースの URL を入力します。 これによりワークスペースにサインインし、ハーネスのモデル呼び出しは Databricks Unity AI Gateway 経由でルーティングされるため、管理すべき API キーはなく、使用状況の管理と課金はそこで行われます。
    • それ以外の場合は、独自の API キー、サブスクリプション、またはゲートウェイを指定します。
  4. Azure Databricks ID でサインインし、マシンを Omnigent ホストとして登録します。

    omni login <workspace-url>
    omni host --server <workspace-url>
    
  5. Web ブラウザーで、<workspace-url>/omnigent にアクセスします。

  6. [ 新しいセッション] を選択します。

  7. ホスト ピッカーを開き、登録したマシンを選択します。 選択したホストによってエージェントが実行される実行環境が決まります。そのため、エージェントが必要とするツール、ファイル、ネットワークにアクセスできるホストを選択します。

    登録済みのローカル ホストが選択されたオムニジェント ワークスペース UI ホスト ピッカー。

  8. コンポーザーでタスクを記述し、送信してセッションを開始します。

デスクトップ アプリまたはモバイル アプリを接続する

Omnigent デスクトップ アプリは省略可能であり、macOS でのみ使用できます。 デスクトップ アプリをインストールし、ホストを作成したら、アプリで [新しいサーバーに接続 ] を選択し、ワークスペースの URL を入力します。

オムニジェント モバイル アプリも同じように接続します。 App Store からインストールするか、任意の電話ブラウザーでモバイル Web UI を使用して、ワークスペースの URL を入力します。 インストールとセットアップの詳細については、 Omnigent モバイル ドキュメントを参照してください

ワークスペースでネットワーク アクセスが制限されている場合、管理者は、接続する前にモバイル デバイスがワークスペースにアクセスできるようにする必要がある場合があります。 モバイル ネットワーク アクセスを参照してください。