如何创建和管理 LUIS 资源

重要

LUIS 将于 2025 年 10 月 1 日停用,从 2023 年 4 月 1 日开始,你将无法创建新的 LUIS 资源。 建议将 LUIS 应用程序迁移对话语言理解,以便从持续的产品支持和多语言功能中受益。

使用本文了解可与 LUIS 结合使用的 Azure 资源类型,以及如何管理它们。

创作资源

创作资源可用于创建、管理、训练、测试和发布应用程序。 LUIS 创作资源有一个可用的定价层,即免费 (F0) 层,该层可为你提供:

  • 100 万个创作事务
  • 每月 1,000 个测试预测终结点请求。

可使用 v3.0-preview LUIS 编程 API 来管理创作资源。

预测资源

预测资源可让你在超出创作资源提供的 1,000 个请求范围之外查询预测终结点。 预测资源有两个可用的定价层

  • 免费 (F0) 预测资源,它每月提供 10,000 个预测终结点请求。
  • 标准 (S0) 预测资源,这是付费层。

可使用 v3.0-preview LUIS 终结点 API 来管理预测资源。

注意

  • 还可使用多服务资源来获取可用于多项 Azure AI 服务的单个终结点。
  • LUIS 提供了两种类型的 F0(免费层级)资源:一种用于创作事务,另一种用于预测事务。 如果用于预测事务的免费配额不足,请确保你使用的是每月提供 10,000 个免费事务的 F0 预测资源,而不是每月提供 1,000 个预测事务的创作资源。
  • 你应当在要进行发布和查询的区域中创作 LUIS 应用。

创建 LUIS 资源

若要创建 LUIS 资源,可使用 LUIS 门户、Azure 门户或 Azure CLI。 创建资源后,需要将它们分配给应用,供其使用。

使用 LUIS 门户创建 LUIS 创作资源

  1. 登录 LUIS 门户,选择你所在的国家/地区,然后同意使用条款。 如果在门户中看到“我的应用”部分,则表示 LUIS 资源已存在,可跳过下一步。

  2. 在出现的“选择创作”窗口中,找到你的 Azure 订阅和 LUIS 创作资源。 如果没有资源,可新建一个。

    Choose a type of Language Understanding authoring resource.

    创建新的创作资源时,请提供以下信息:

    • 租户名称:与 Azure 订阅关联的租户。
    • Azure 订阅名称:将对资源计费的订阅。
    • Azure 资源组名称:你选择或创建的自定义资源组名称。 使用资源组可将 Azure 资源分组,以便进行访问和管理。
    • Azure 资源名称:你选择的自定义名称,用作创作和预测终结点查询的 URL 的一部分。
    • 定价层:定价层确定每秒和每月的最大事务数。

使用 LUIS 门户创建 LUIS 预测资源

  1. 在应用程序中转到“管理”选项卡。

  2. 在左侧导航栏中,选择“Azure 资源”。

  3. 选择“添加预测资源”按钮。

    Add Prediction resource from portal

    如果已有预测资源,请添加。 否则,请选择“创建新的预测资源”。

    Add Prediction resource from portal-2

分配 LUIS 资源

创建资源并不一定意味着要使用它,你需要将其分配给应用。 可以在 LUIS 中为单个应用或所有应用分配创作资源。

使用 LUIS 门户分配资源

将创作资源分配给所有应用

以下过程将创作资源分配给所有应用。

  1. 登录到 LUIS 门户
  2. 在右上角选择你的用户帐户,然后选择“设置”。
  3. 在“用户设置”页上选择“添加创作资源”,然后选择现有的创作资源。 选择“保存” 。

将资源分配给特定应用

以下过程将资源分配给特定应用。

  1. 登录到 LUIS 门户。 从“我的应用”列表中选择应用。

  2. 转到“管理”>“Azure 资源” :

    Choose a type of Language Understanding prediction resource.

  3. 在“预测资源”或“创作资源”选项卡上,选择“添加预测资源”或“添加创作资源”按钮。

  4. 使用窗体中的字段查找正确的资源,然后选择“保存”。

取消分配资源

取消分配资源时,不会将其从 Azure 中删除。 只会将其从 LUIS 取消链接。

使用 LUIS 门户取消分配资源

  1. 登录到 LUIS 门户,然后从“我的应用”列表中选择一个应用。
  2. 转到“管理”>“Azure 资源” 。
  3. 选择资源相对应的“取消分配资源”按钮。

资源所有权

Azure 资源(例如 LUIS 资源)归包含该资源的订阅所有。

若要更改资源的所有权,可以执行以下操作之一:

  • 转让订阅的所有权
  • 将 LUIS 应用导出为文件,然后在其他订阅上导入该应用。 可以从 LUIS 门户中的“我的应用”页面进行导出。

资源限制

创作密钥创建限制

可以按订阅为每个区域创建最多 10 个创作密钥。 发布区域不同于创作区域。 请确保在与你希望将客户端应用程序置于其中的发布区域对应的创作区域中创建应用。 有关创作区域映射到发布区域的方式的信息,请参阅创作和发布区域

有关详细信息,请参阅资源限制

有关密钥使用限制的错误

使用限制取决于定价层。

如果超过了每秒事务数 (TPS) 配额,则会出现 HTTP 429 错误。 如果超过了每月事务数 (TPM) 配额,则会出现 HTTP 403 错误。

更改定价层

  1. Azure 门户中,转到“所有资源”并选择资源

    Screenshot that shows a LUIS subscription in the Azure portal.

  2. 在左侧菜单中选择“定价层”,查看可用的定价层

  3. 选择想要的定价层,然后单击“选择”以保存更改。 完成定价更改后,右上方将显示一条通知以及定价层更新。

查看 Azure 资源指标

查看 Azure 资源使用情况的摘要

可以在 Azure 门户中查看 LUIS 使用情况信息。 “概述”页会显示摘要,其中包含最近的调用和错误。 如果你发出 LUIS 终结点请求,则最多需要五分钟才会显示更改。

Screenshot that shows the overview page.

自定义 Azure 资源使用图表

“指标”页面提供了更详细的数据视图。 可针对特定的“时间段”和“指标”配置指标图表 。

Screenshot that shows the metrics page.

总事务数阈值警报

如果你希望知道何时达到特定的事务阈值(例如 10,000 个事务),则可以创建警报:

  1. 在左侧菜单中,选择“警报”

  2. 在顶部菜单栏中,选择“新建警报规则”

    Screenshot that shows the alert rules page.

  3. 选择“添加条件”

    Screenshot that shows the add condition page for alert rules.

  4. 选择“总调用数”

    Screenshot that shows the total calls page for alerts.

  5. 向下滚动到“警报逻辑”部分,然后根据需要设置属性并单击“完成”

    Screenshot that shows the alert logic page.

  6. 若要在警报规则触发时发送通知或调用操作,请转到“操作”部分并添加操作组。

    Screenshot that shows the actions page for alerts.

重置创作密钥

对于已迁移的创作资源应用:如果创作密钥已泄露,请在 Azure 门户中该创作资源的“密钥”页上重置密钥。

对于尚未迁移的应用:可在 LUIS 门户的所有应用中重置此密钥。 如果通过创作 API 创作应用,则需要将 Ocp-Apim-Subscription-Key 的值更改为新密钥。

重新生成 Azure 密钥

可以在 Azure 门户的“密钥”页上重新生成 Azure 密钥。

应用所有权、访问权限和安全性

应用是由其 Azure 资源定义的,这些资源取决于所有者的订阅。

你可以移动自己的 LUIS 应用。 可使用以下资源来帮助你通过 Azure 门户或 Azure CLI 实现此目的:

后续步骤