Genie 应用构建器

Important

此功能在 Beta 版中。 要使用它,工作区管理员必须从预览页面开启“治理代理式应用构建”。 请参阅 Manage Azure Databricks 预览版。

Genie 应用构建器允许你在 Azure Databricks 界面中通过用自然语言描述来构建 Databricks 应用。 描述你想要的应用,Genie App Builder 会用 Databricks AppKit(Azure Databricks 的数据和 AI 应用框架)生成该应用。 你会审查一个可用的预览版,通过后续提示进行完善,然后部署。

Genie App Builder 在 App Space 中构建应用。 应用空间是一个治理边界,管理员在其中定义谁可以创建和使用应用,这些应用拥有哪些权限,以及哪些支出策略适用于它们。 被治理的代理应用构建预览同时启用了Genie App Builder和App Spaces。 参见 应用空间。

使用 Genie 应用构建器快速构建内部数据和 AI 应用,无需编写代码。 要自己控制应用代码、运行时或扩展,可以 从模板创建应用 ,或者 创建自定义应用 。

Requirements

要使用 Genie 应用构建器,你需要以下条件:

  • 支持区域内的工作区:

    australiaeast、brazilsouth、canadacentral、centralindia、centralus、eastus、eastus2、francecentral、germanywestcentral、japaneast、northcentralus、northeurope、southcentralus、southeastasia、uksouth、westeurope、westus、westus2

    Azure 中国区域不受支持。

  • 合作伙伴驱动的AI功能在账户和工作区层面都已开启。 请参阅 合作伙伴支持的 AI 功能。

  • 跨地理区域处理已开启,如果工作区所在的地理区域要求如此。 请参阅 “启用跨地理位置处理”。

  • 应用空间上的 CAN CREATE APP 权限。 请参见 应用空间权限。

  • 用户浏览器能够访问 *.databricksapps.com,编辑器和预览都运行在那里。 工作空间的IP访问列表和前端专用链接设置适用于这些流量。 使用前端专用链接时,databricksapps.com必须解析到你的私有端点。 参见 入口流量控制。

构建一个应用

用自然语言描述应用,然后通过后续提示不断完善,直到它达到你想要的效果。

  1. 在你的 Azure Databricks 工作区中,打开应用主页,点击左侧导航中的 Build 选项卡。
  2. 选择要在其中构建的应用空间。
  3. (可选)输入应用名称。
  4. 输入一个自然语言提示,描述该应用。 请参见 获得更佳效果的提示。
  5. Genie 应用构建器会生成应用预览。 当提示时,点击 登录 ,并在新浏览器标签页完成登录。参见 “登录预览”。
  6. 通过后续提示完善应用。
  7. 当应用按你想要的方式运行时,就部署它。

部署的应用在空闲时会缩容到零,用户请求时会再次启动。 参见 应用运行时。

要持续改进已部署的应用,请点击应用详情页上的 Genie App Builder。

登录到预览版

预览是从与工作区不同的域加载的,所以你需要单独登录。 登录会在一个新的浏览器标签页中打开。如果你的浏览器屏蔽了工作区的弹窗,允许它们并点击“重新尝试”。

预览还需要第三方 Cookie。 如果浏览器阻止了它们,可以在浏览器设置中允许该工作区使用第三方 Cookie,或者点击 在新标签页打开,在独立标签页中查看预览。

分享一个应用

部署应用后,分享它以便其他用户运行:

  1. 在应用详情页面,点击 分享。
  2. 添加用户或组,并选择权限级别:
    • CAN USE:运行并与应用互动。
    • CAN MANAGE编辑、分享并删除应用。

App Space 的用户授权设置限制了谁可以使用该应用。 如果该空间设置为 任何角色,你可以与任何用户共享应用。 如果空间设置为 仅限所选角色,你只能与能够切换到该角色的用户共享,且他们必须切换到该角色才能使用应用。 参见基于 角色的访问控制 和 配置Databricks应用的权限。

数据存取

使用 Genie App Builder 构建的应用通过两种方式访问数据:

  • 作为已登录用户:在用户授权下,应用会以登录用户的身份执行操作。 应用只能访问用户已能访问的数据和资源,且仅限于应用空间允许的范围内。 如果空间需要角色,应用会根据该角色的权限来操作。 请参阅范围。
  • 作为应用:管理员可以将共享数据(例如 Unity Catalog 表和卷)以及共享资源(例如 SQL 仓库和服务终结点)添加到应用空间。 该空间中的每个应用都可以使用各自的标识来使用这些资源。 请参阅 将资源添加到 Databricks 应用。

例如,当用户打开使用用户授权的仪表盘应用时,应用只查询用户有权限读取的 Unity Catalog 表。

更好效果的建议

要获得更好的Genie App Builder效果,请遵循以下建议:

  • 从简单开始,然后不断迭代:先写一个简短的提示,然后通过后续提示添加功能,而不是用一个大提示来描述整个应用。 短迭代周期效果最好,尤其是在刚开始的时候。
  • 具体说明用户界面和行为:描述应用应有的页面、用户输入的输入、要展示的图表或表格,以及用户可以采取的操作。 还要说明应用应该如何表现,包括要应用哪些筛选、默认值以及数据写入的位置。

例如:

  • 常规:“生成销售仪表板。”
  • 具体说明:“创建一个只有一页的销售仪表盘。 显示按地区划分的月度收入条形图和按收入排名前10的账户表格。 添加一个默认为EMEA的区域过滤器。”

应用运行时

使用 Genie App Builder 构建的应用运行在隔离的按需无服务器计算上。 每个应用最多运行一个实例,闲置一段时间后会缩减到零个实例。 应用缩容后,应用启动期间的第一个请求会花更长时间。

当应用缩容时,内存或本地磁盘中的状态会丢失。 为了在缩减过程中保持状态,可以将其存储在 Lakebase 表、Unity Catalog 卷或其他外部存储中。 请参见 应用状态。 如果你需要一个始终在线的应用或水平缩放,可以用模板或自己的代码创建应用。 参见 Databricks应用的水平缩放。

局限性

使用 Genie App Builder 构建的应用有以下限制:

  • 应用程序没有到公共互联网的出站访问。 出站访问仅限于 Azure Databricks workspace 以及 Azure Databricks 管理的 npm 和 PyPI 包代理。
  • 工作区级的安全出口网关和无服务器专用链接配置不适用于这些应用。 请参阅 为 Databricks 应用配置网络。
  • 包只能通过 Azure Databricks 管理的包代理进行安装。 不支持自定义包仓库。

Genie 应用构建器故障排除

本节介绍了你在构建应用时可能遇到的问题。

编辑器卡在连接上了

如果编辑器停留在 正在连接到计算资源 状态超过几分钟,或显示 无法连接到您的编辑器。正在重试…,您的浏览器可能无法访问 *.databricksapps.com 上的编辑器地址。 工作区的网络设置通常会导致这种情况:

  • IP访问列表:工作空间的IP访问列表必须允许你所在的网络。 该列表同样适用于 *.databricksapps.com。 如果你的浏览器通过 专用链接 访问工作区,但databricksapps.com无法通过公共互联网访问工作区,请参见下一项。
  • 前端 专用链接:如果你的工作区使用前端 专用链接,databricksapps.com 必须像你的工作区 URL 一样解析到你的私有终结点。 在浏览器的开发者工具中,在对 *.databricksapps.com 的失败请求中查找编辑器的地址,并在运行浏览器的机器上,或在浏览器所在的网络中运行 nslookup <editor-address>。 如果返回的是公网 IP 地址,就将databricksapps.com添加到你的 专用链接 的 DNS 设置中。 参见 DNS配置。

Pricing

在测试阶段,Genie App Builder、App Spaces 或使用 Genie App Builder 构建的应用均免费。 测试版功能的价格可能会有所调整。

其他资源