如何创建和管理 LUIS 资源

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

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

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

   

   创建新的创作资源时，请提供以下信息：

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

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

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

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

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

   

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

   

在不使用 LUIS 门户的情况下创建 LUIS 资源

使用 Azure CLI 单独创建每项资源。

1. 登录 Azure CLI：

   az login
   

   此命令打开一个浏览器，使你可以选择正确的帐户并提供身份验证。

2. 创建一个 LUIS.Authoring 种类的名为 my-luis-authoring-resource 的 LUIS 创作资源。 在 chinaeast2 区域的名为 my-resource-group 的现有资源组中创建它。

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l chinaeast2 --yes
   

3. 创建 LUIS 种类的名为 my-luis-prediction-resource 的 LUIS 预测终结点资源。 在 chinaeast2 区域的名为 my-resource-group 的现有资源组中创建它。 如果需要比免费层提供的吞吐量更高的吞吐量，请将 F0 更改为 S0。 详细了解定价层和吞吐量。

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l chinaeast2 --yes
   

使用 LUIS 门户分配资源

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

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

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

将资源分配给特定应用

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

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

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

   

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

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

在不使用 LUIS 门户的情况下分配预测资源

对于 CI/CD 管道等自动化进程，可使用以下步骤将 LUIS 资源自动分配给 LUIS 应用：

1. 获取 Azure 资源管理器令牌，它是一个字母数字字符的字符串。 此令牌即将过期，请立即使用。 也可使用以下 Azure CLI 命令。

   az account get-access-token --resource=https://management.core.chinacloudapi.cn/ --query accessToken --output tsv
   

2. 使用令牌跨订阅请求 LUIS 运行时资源。 使用 API 获取用户帐户有权访问的 LUIS Azure 帐户。

   此 POST API 需要以下值：

   标头	Value
   Authorization	Authorization 的值为 Bearer {token}。 单词 Bearer 和空格前面必须是令牌值。
   Ocp-Apim-Subscription-Key	你的创作密钥。

   API 返回 JSON 对象的数组，这些对象表示 LUIS 订阅。 返回的值包括订阅 ID、资源组和资源名称，返回为 AccountName。 在要将 LUIS 资源分配给 LUIS 应用的数组中查找一个项。

3. 使用将 LUIS Azure 帐户分配给应用程序 API，将令牌分配给 LUIS 资源。

   此 POST API 需要以下值：

   类型	设置	值
   标头	Authorization	Authorization 的值为 Bearer {token}。 单词 Bearer 和空格前面必须是令牌值。
   标头	Ocp-Apim-Subscription-Key	你的创作密钥。
   标头	Content-type	application/json
   Querystring	appid	LUIS 应用 ID。
   正文		{AzureSubscriptionId：订阅 ID； ResourceGroup：具有预测资源的资源组名称； AccountName：预测资源的名称}

   此 API 成功时，将返回 201 - created status。

使用 LUIS 门户取消分配资源

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

在不使用 LUIS 门户的情况下取消分配预测资源

1. 获取 Azure 资源管理器令牌，它是一个字母数字字符的字符串。 此令牌即将过期，请立即使用。 也可使用以下 Azure CLI 命令。

   az account get-access-token --resource=https://management.core.chinacloudapi.cn/ --query accessToken --output tsv
   

2. 使用令牌跨订阅请求 LUIS 运行时资源。 使用从用户帐户有权访问的获取 LUIS Azure 帐户 API。

   此 POST API 需要以下值：

   标头	Value
   Authorization	Authorization 的值为 Bearer {token}。 单词 Bearer 和空格前面必须是令牌值。
   Ocp-Apim-Subscription-Key	你的创作密钥。

   API 返回 JSON 对象的数组，这些对象表示 LUIS 订阅。 返回的值包括订阅 ID、资源组和资源名称，返回为 AccountName。 在要将 LUIS 资源分配给 LUIS 应用的数组中查找一个项。

3. 使用从应用程序取消分配 LUIS Azure 帐户 API，将令牌分配给 LUIS 资源。

   此 DELETE API 需要以下值：

   类型	设置	值
   标头	Authorization	Authorization 的值为 Bearer {token}。 单词 Bearer 和空格前面必须是令牌值。
   标头	Ocp-Apim-Subscription-Key	你的创作密钥。
   标头	Content-type	application/json
   Querystring	appid	LUIS 应用 ID。
   正文		{AzureSubscriptionId：订阅 ID； ResourceGroup：具有预测资源的资源组名称； AccountName：预测资源的名称}

   此 API 成功时，将返回 200 - OK status。