Important
Omnigent 目前還在 測試階段。 關於開源文件，請參見 Omnigent 文件。
Azure Databricks 上的 Omnigent 是一個與你的工作空間身份提供者及 Unity Gateway 整合的受管式伺服器部署。 這個伺服器會協調你的場次，並讓你能與他人合作。 本頁介紹的是 Azure Databricks 專屬的設定。 欲了解更多 Omnigent 的功能與能力，請參閱 開源的 Omnigent 文件 。
先決條件
您必須擁有：
- Omnigent 預覽功能已啟用於你的工作區。 請參閱管理工作區層級預覽。
- 一個支援 Unity Gateway 的區域工作區。 請參閱 Databricks 依區域提供的功能可用性。
要使用 CLI 安裝 Omnigent，您必須具備：
- Python 3.12+
- Node.js 22 LTS 與 npm
- tmux（僅限 macOS 和 Linux）
選擇主持人或跑者
Managed Omnigent 在 Azure Databricks 上執行伺服器。 你的代理程式執行工作的主機或執行器，就是你自己的電腦。 你安裝 Omnigent CLI，並將筆電或虛擬機註冊為主機，讓代理人員能存取本地檔案、工具或網路。 此主機僅在機器開機且 omni host 程序執行時可用。
你用 Azure Databricks 工作區身份登入，你的工作階段會顯示在 <workspace-url>/omnigent UI 中，並與其他工作區使用者分享。
在你自己的電腦上啟動 Omnigent
安裝 Omnigent CLI，並註冊你的筆電或虛擬機作為主機。 你註冊的機器就是代理的執行環境，所以選擇能存取代理所需工具、檔案和網路的機器。 此主機僅在機器開機且 omni host 程序執行時可用。
安裝 Omnigent 與
databricksExtra 一起，這會增加管理平台的整合功能。Note
在 Windows 上，請使用 UV 標籤，因為安裝腳本只支援 macOS 和 Linux。 基於 tmux 的終端機包裝器在 Windows 上無法使用，且代理程式在沒有檔案系統或網路隔離的情況下執行。 請參閱 Omnigent README 的 Windows 部分。
安裝腳本
curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra "databricks"紫外線
uv tool install "omnigent[databricks]"Pip
pip install "omnigent[databricks]"設定模型憑證。 執行
omni setup：omni setup
憑證是以各個 harness 為範圍，因此你必須先選取一個 harness，再選擇提供其憑證的方式。
- 要呼叫你工作空間的 基礎模型 API，選擇 Databricks 並輸入你的工作區 URL。 這會讓你登入該工作區，並將該 harness 的模型呼叫經由 Unity Gateway 路由，因此無須管理 API 金鑰，且使用量也會在那裡受到管控並計費。
- 否則，請自行提供 API 金鑰、訂閱或閘道。
請用你的 Azure Databricks 身份登入，並將機器註冊為 Omnigent 主機：
omni login <workspace-url> omni host --server <workspace-url>在您的網頁瀏覽器中，前往
<workspace-url>/omnigent。選取 新工作階段。
打開主機選擇器，選擇你註冊的機器。 你選擇的主機決定代理執行環境，所以請選擇能存取代理所需工具、檔案和網路的主機。
在 Composer 中描述一項任務，然後送出以開始工作階段。
連接桌面應用程式或行動應用程式
Omnigent 桌面應用程式為選配，適用於 macOS、Windows 和 Linux。 安裝桌面應用程式，建立主機後，在應用程式中選擇 「連接新伺服器 」並輸入你的工作區網址。
Omnigent 行動應用程式的連線方式相同。 從 App Store 安裝，或使用任何手機瀏覽器的行動網頁介面，然後輸入你的工作區網址。 關於安裝和設定細節，請參考 Omnigent Mobile 文件。
如果你的工作區限制了網路存取，管理員可能需要先允許行動裝置進入工作區，才能讓你連線。 請參見 行動網路存取。