メインコンテンツまでスキップ

Omnigentクイックスタート

備考

ベータ版

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

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

前提条件

以下が必要です:

Databricks SandboxでOmnigentを開くには、次のものも必要です。

CLI を使用して Omnigent をインストールするには、以下が必要です:

  • Python 3.12以降
  • npmとtmuxを備えたNode.js 22 LTS

ホストを選択する

Omnigentは常に、マネージドDatabricksデプロイサーバーで実行されます。異なるのは、エージェントを実行するホストです。

  • Databricks Sandbox (マネージド): Databricksがクラウド上でホストをプロビジョニングして実行します。お使いのノートパソコンの電源がオフになっても実行され続け、認証情報はDatabricksから離れることはありません。すぐに起動するには、これを選択してください。
  • 自分のマシン (ローカル): Omnigent CLIをインストールし、ノートパソコンまたはVMをホストとして登録します。ノートパソコンまたはVMが実行環境となるため、エージェントはローカルファイル、ツール、またはネットワークにアクセスできます。ローカルホストは、マシンとomni hostプロセスが実行されている間のみ利用可能です。

どちらの場合でも、ホストは同じマネージドサーバーを介して実行されるため、DatabricksワークスペースIDでサインインします。セッションの可視性と共有はどちらも同じです。セッションは<workspace-url>/omnigent UIに表示され、どのホストで実行されても他のワークスペースユーザーと共有できます。

DatabricksサンドボックスでOmnigentを起動

Omnigent を実行する最も簡単な方法は、Databricks サンドボックスを使用することです。これは、Databricks がプロビジョニングするマネージドクラウドホストです。エージェントは、ノートパソコンがスリープ状態でも稼働し続ける、隔離された再現可能な環境で実行されます。モデルは、お客様のワークスペースの基盤モデルAPIを介してAI Gateway経由で自動的にルーティングされるため、管理するAPIキーはなく、モデルの使用はAI Gatewayのガバナンスと制御を継承します。

  1. ウェブブラウザで<workspace-url>/omnigentにアクセスします。
  2. 新しいセッション を選択してください。
  3. ホストピッカーを開き、 サンドボックス を選択してください。
  4. コンポーザーでタスクを説明し、セッションを開始するために送信してください。

Databricksサンドボックスが選択されたOmnigentワークスペースUIホストピッカー。

独自のコンピューターでOmnigentを起動する

Omnigent CLIをインストールし、お使いのノートパソコンまたはVMをホストとして登録します。登録するマシンはエージェントの実行環境になるため、エージェントが必要とするツール、ファイル、ネットワークにアクセスできるマシンを選択してください。ローカルホストは、お使いのマシンとomni hostプロセスが実行されている場合にのみ利用可能です。

  1. databricks追記文を使用してOmnigentをインストールします。これにより、マネージドプラットフォーム統合が追加されます。
Bash
curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"
  1. モデル認証情報をセットアップします。ラン omni setup

    Bash
    omni setup

    ターミナルでomni setupを実行して、ハーネスの資格情報の追加を開始します。

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

    • ワークスペースの基盤モデルAPI を呼び出すには、**Databricks**を選択し、ワークスペースのURLを入力します。 これによりワークスペースにサインインされ、Databricks Unity AI Gateway 経由でそのハーネスのモデル呼び出しがルーティングされます。そのため、管理するAPIキーはなく、使用状況はそこで管理および請求されます。
    • そうでない場合は、ご自身のAPIキー、サブスクリプション、またはゲートウェイを提供してください。
  3. Databricks IDでサインインし、マシンをOmnigent ホストとして登録します。

    Bash
    omni login <workspace-url>
    omni host --server <workspace-url>
  4. ウェブブラウザで<workspace-url>/omnigentにアクセスします。

  5. 新しいセッション を選択してください。

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

    登録済みのローカルホストが選択されたOmnigentワークスペースUIホストピッカー。

  7. コンポーザーでタスクを説明し、セッションを開始するために送信してください。

デスクトップアプリを接続する

Omnigentデスクトップアプリはオプションであり、macOSでのみ利用可能です。デスクトップアプリをインストールし、ホストを作成した後、アプリで Connect to new server を選択し、ワークスペースのURLを入力してください。