Omnigent 快速入门

Important

Omnigent 处于 Beta 版中。 有关开源文档，请参阅 Omnigent 文档。

Omnigent 在 Azure Databricks 上作为托管部署运行：协调会话的服务器是为你管理的，并且你使用Azure Databricks工作区标识登录。 本页介绍特定于Azure Databricks的设置。 有关 Omnigent 特性和功能的详细信息，请参阅 开源 Omnigent 文档 。

先决条件

您必须具备：

• 已为您的工作区启用 Omnigent 预览版。 请参阅管理工作区级预览。
• 支持 Databricks Unity AI 网关的区域中的工作区。 请参阅 Databricks 功能可用性（按区域）。

若要使用 CLI 安装 Omnigent，必须具备：

• Python 3.12+
• 附带 npm 和 tmux 的 Node.js 22 LTS

在自己的计算机上启动 Omnigent

在笔记本电脑或 Azure Databricks VM 上安装 Omnigent，并将其注册为主机。

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
   

   

   • 若要通过 AI 网关路由模型，请在凭据选取器中选择 Databricks 并输入工作区 URL。
   • 否则，请提供自己的 API 密钥、订阅或网关。

3. 使用Azure Databricks标识登录，并将计算机注册为 Omnigent 主机：

   omni login <workspace-url>
   omni host --server <workspace-url>
   

4. 在 Web 浏览器中，导航到 <workspace-url>/omnigent。

5. 选择 “新建会话”。

6. 打开主机选取器，然后选择已注册的计算机。

   

7. 在编写器中描述一个任务，并发送以开始会话。

连接桌面应用

Omnigent 桌面应用是可选的，目前仅在 macOS 上可用。 安装桌面应用，然后在创建主机后，在应用中选择“连接到新服务器”，然后输入工作区 URL。