Omnigentクイックスタート
ベータ版
Omnigent はベータ版です。オープンソースのドキュメントについては、Omnigentドキュメントを参照してください。
Omnigent は、Databricks上でマネージドデプロイメントとして実行されます。セッションを調整するサーバーは管理されており、Databricks ワークスペースのIDでサインインします。このページでは、Databricksに固有のセットアップについて説明します。Omnigentの機能と機能の詳細については、「オープンソースの Omnigent ドキュメント」を参照してください。
前提条件
以下が必要です:
- ワークスペースで Omnigent プレビューが有効になっています。ワークスペースレベルのプレビューを管理するを参照してください。
- Databricks Unity AI Gatewayをサポートするリージョンにあるワークスペース。地域別のDatabricks機能の可用性を参照してください。
Databricks SandboxでOmnigentを開くには、次のものも必要です。
- Databricks サンドボックスもサポートするリージョンにあるワークスペース。制限事項を参照してください。
- ワークスペースで サンドボックス プレビューが有効になりました。ワークスペース レベルのプレビューを管理するを参照してください。
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のガバナンスと制御を継承します。
- ウェブブラウザで
<workspace-url>/omnigentにアクセスします。 - 新しいセッション を選択してください。
- ホストピッカーを開き、 サンドボックス を選択してください。
- コンポーザーでタスクを説明し、セッションを開始するために送信してください。

独自のコンピューターでOmnigentを起動する
Omnigent CLIをインストールし、お使いのノートパソコンまたはVMをホストとして登録します。登録するマシンはエージェントの実行環境になるため、エージェントが必要とするツール、ファイル、ネットワークにアクセスできるマシンを選択してください。ローカルホストは、お使いのマシンとomni hostプロセスが実行されている場合にのみ利用可能です。
databricks追記文を使用してOmnigentをインストールします。これにより、マネージドプラットフォーム統合が追加されます。
- Install script
- UV
- Pip
curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"
uv tool install "omnigent[databricks]"
pip install "omnigent[databricks]"
-
モデル認証情報をセットアップします。ラン
omni setup:Bashomni setup
-
資格情報はハーネスごとにスコープが設定されているため、ハーネスを選択してから、その資格情報を提供する方法を選択する必要があります。
- ワークスペースの基盤モデルAPI を呼び出すには、**Databricks**を選択し、ワークスペースのURLを入力します。 これによりワークスペースにサインインされ、Databricks Unity AI Gateway 経由でそのハーネスのモデル呼び出しがルーティングされます。そのため、管理するAPIキーはなく、使用状況はそこで管理および請求されます。
- そうでない場合は、ご自身のAPIキー、サブスクリプション、またはゲートウェイを提供してください。
-
Databricks IDでサインインし、マシンをOmnigent ホストとして登録します。
Bashomni login <workspace-url>
omni host --server <workspace-url> -
ウェブブラウザで
<workspace-url>/omnigentにアクセスします。 -
新しいセッション を選択してください。
-
ホストピッカーを開き、登録したマシンを選択します。選択するホストによってエージェントが実行される実行環境が決まるため、エージェントが必要とするツール、ファイル、およびネットワークにアクセスできるホストを選択してください。

-
コンポーザーでタスクを説明し、セッションを開始するために送信してください。
デスクトップアプリを接続する
Omnigentデスクトップアプリはオプションであり、macOSでのみ利用可能です。デスクトップアプリをインストールし、ホストを作成した後、アプリで Connect to new server を選択し、ワークスペースのURLを入力してください。