Omnigent 快速入门

Important

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

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

先决条件

您必须具备：

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

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

选择主机

Omnigent 始终在托管Azure Databricks部署服务器上运行。 执行代理的主机是你自己的计算机。 安装 Omnigent CLI 并将笔记本电脑或 VM 注册为主机，以便代理可以访问本地文件、工具或网络。 仅当计算机和进程正在运行时， omni host 本地主机才可用。

使用Azure Databricks工作区标识登录，会话会显示在 UI 中<workspace-url>/omnigent，这些会话可以与其他工作区用户共享。

在自己的计算机上启动 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

    在终端中运行 omni setup 以开始添加智能体连接器凭据。

  3. 凭据是针对各个 harness 单独设定的，因此您必须先选择一个 harness，然后再选择如何提供该 harness 的凭据。

    • 若要调用工作区 的基础模型 API，请选择 Databricks 并输入工作区 URL。 这会让你登录到该工作区，并将该 harness 的模型调用路由到 Databricks Unity AI Gateway，因此无需管理 API 密钥，且使用情况将在那里统一治理和计费。
    • 否则，请提供自己的 API 密钥、订阅或网关。

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

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

  5. 在网络浏览器中，前往 <workspace-url>/omnigent。

  6. 选择 “新建会话”。

  7. 打开主机选取器，然后选择已注册的计算机。 选择的主机确定代理在其中运行的执行环境，因此请选择有权访问代理所需的工具、文件和网络的主机。

    Omnigent 工作区 UI 主机选取器，其中已选中一个已注册的本地主机。

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

连接桌面应用或移动应用

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

Omnigent 移动应用以相同的方式进行连接。 从 App Store 安装它或使用任何手机浏览器中的移动 Web UI，然后输入工作区 URL。 有关安装和安装详细信息，请参阅 Omnigent 移动文档。

如果工作区限制网络访问，管理员可能需要允许移动设备访问工作区，然后才能进行连接。 请参阅 移动网络访问。

  • Last updated on