迁移到 Azure 资源创作密钥Migrate to an Azure resource authoring key

重要

从 12 月 3 日开始,现有的 LUIS 用户必须完成迁移过程才能继续创作 LUIS 应用程序。Starting December 3rd, existing LUIS users must complete the migration process to continue authoring LUIS applications.

语言理解 (LUIS) 创作身份验证已从电子邮件帐户更改为 Azure 资源。Language Understanding (LUIS) authoring authentication has changed from an email account to an Azure resource. 如果你尚未进行迁移,请使用本文来了解如何迁移你的帐户。Use this article to learn how to migrate your account, if you haven't migrated yet.

什么是迁移?What is migration?

迁移是指将创作身份验证从电子邮件帐户更改为 Azure 资源的过程。Migration is the process of changing authoring authentication from an email account to an Azure resource. 迁移后,你的帐户会关联到 Azure 订阅和 Azure 创作资源。Your account will be linked to an Azure subscription and an Azure authoring resource after you migrate.

必须从 LUIS 门户执行迁移。Migration has to be done from the LUIS portal. 例如,如果你使用 LUIS CLI 创建创作密钥,则需在 LUIS 门户中完成迁移过程。If you create the authoring keys by using the LUIS CLI, for example, you'll need to complete the migration process in the LUIS portal. 迁移后,你的应用程序的共同创作者仍然能够存在,但会被添加到 Azure 资源级别,而不是应用程序级别。You can still have co-authors on your applications after migration, but these will be added on the Azure resource level instead of the application level. 帐户的迁移无法撤消。Migrating your account can't be reversed.

备注

  • 如果你需要创建一个预测运行时资源,则可通过单独的过程来创建它。If you need to create a prediction runtime resource, there's a separate process to create it.
  • 有关应用程序和参与者如何受影响的信息,请参阅下面的迁移说明部分。See the migration notes section below for information on how your applications and contributors will be affected.
  • LUIS 应用的创作是免费的,如 F0 层所指示的那样。Authoring your LUIS app is free, as indicated by the F0 tier. 了解有关定价层的更多信息Learn more about pricing tiers.

迁移先决条件Migration prerequisites

  • 有效的 Azure 订阅。A valid Azure subscription. 请要求你的租户管理员将你添加到订阅,或者注册一个免费订阅Ask your tenant admin to add you on the subscription, or sign up for a free one.
  • 来自 LUIS 门户或 Azure 门户的 LUIS Azure 创作资源。A LUIS Azure authoring resource from the LUIS portal or from the Azure portal.
    • 从 LUIS 门户创建创作资源是下一部分所述的迁移过程的一部分。Creating an authoring resource from the LUIS portal is part of the migration process described in the next section.
  • 如果你是应用程序的协作者,则应用程序不会自动迁移。If you're a collaborator on applications, applications won't automatically migrate. 在完成迁移流时,系统会提示你导出这些应用。You will be prompted to export these apps while going through the migration flow. 你还可以使用导出 APIYou can also use the export API. 迁移后,你可以将应用导入回 LUIS。You can import the app back into LUIS after migration. 导入过程会创建一个具有新应用 ID 的新应用,你是该应用的所有者。The import process creates a new app with a new app ID, for which you're the owner.
  • 如果你是应用程序的所有者,则无需导出应用,因为它们会自动迁移。If you're the owner of the application, you won't need to export your apps because they'll migrate automatically. 提供了一个电子邮件模板,其中包含每个应用程序的所有协作者的列表,因此,这些协作者可以收到迁移过程通知。An email template with a list of all collaborators for each application is provided, so they can be notified of the migration process.

迁移步骤Migration steps

  1. 登录到 LUIS 门户时,Azure 迁移窗口会打开,其中包含迁移步骤。When you sign-in to the LUIS portal, an Azure migration window will open with the steps for migration. 如果将其关闭,则无法继续创作 LUIS 应用程序,所显示的唯一操作将是继续进行迁移。If you dismiss it, you won't be able to proceed with authoring your LUIS applications, and the only action displayed will be to continue with the migration.

    迁移时限简介Migration Window Intro

  2. 如果你的任何应用有协作者,你会看到所拥有的应用程序名称的列表,以及每个应用程序上的创作区域和协作者电子邮件。If you have collaborators on any of your apps, you will see a list of application names owned by you, along with the authoring region and collaborator emails on each application. 建议向协作者发送一封电子邮件,通知其有关迁移的信息,方法是单击应用程序名称左侧的“发送”符号按钮。We recommend sending your collaborators an email notifying them about the migration by clicking on the send symbol button on the left of the application name. 如果协作者具有分配给应用程序的预测资源,则应用程序名称旁边会显示 * 符号。A * symbol will appear next to the application name if a collaborator has a prediction resource assigned to your application. 迁移后,这些应用仍会向其分配这些预测资源,即使协作者没有创作应用程序所需的访问权限。After migration, these apps will still have these prediction resources assigned to them even though the collaborators will not have access to author your applications. 但是,如果预测资源的所有者从 Azure 门户重新生成了密钥,则此分配会中断。However, this assignment will be broken if the owner of the prediction resource regenerated the keys from the Azure portal.

    通知协作者Notify collaborators

    对于每个协作者和应用,会打开默认的电子邮件应用程序,显示一封格式简单的电子邮件。For each collaborator and app, the default email application opens with a lightly formatted email. 可以在发送电子邮件之前对其进行编辑。You can edit the email before sending it. 电子邮件模板包含确切的应用 ID 和应用名称。The email template includes the exact app ID and app name.

    Dear Sir/Madam,
    
    I will be migrating my LUIS account to Azure. Consequently, you will no longer have access to the following app:
    
    App Id: <app-ID-omitted>
    App name: Human Resources
    
    Thank you
    

    备注

    将帐户迁移到 Azure 后,你的应用将不再可供协作者使用。After you migrate your account to Azure, your apps will no longer be available to collaborators.

  3. 如果你是任何应用的协作者,则会显示与你共享的应用程序名称的列表以及每个应用程序的创作区域和所有者电子邮件。If you're a collaborator on any apps, a list of application names shared with you is shown along with the authoring region and owner emails on each application. 建议通过单击应用程序名称左侧的导出按钮来导出应用的副本。It is recommend to export a copy of the apps by clicking on the export button on the left of the application name. 你可以在迁移后将这些应用重新导入回来,因为它们不会随你自动迁移。You can import these apps back after you migrate, because they won't be automatically migrated with you. 如果你具有分配给应用程序的预测资源,则应用程序名称旁边会显示 * 符号。A * symbol will appear next to the application name if you have a prediction resource assigned to an application. 迁移后,你的预测资源仍会分配给这些应用程序,即使你不再有权创作这些应用。After migration, your prediction resource will still be assigned to these applications even though you will no longer have access to author these apps. 如果希望中断预测资源与应用程序之间的分配,则需转到 Azure 门户并重新生成密钥If you want to break the assignment between your prediction resource and the application, you will need to go to Azure portal and regenerate the keys.

    导出应用程序。Export your applications.

  4. 在迁移区域的窗口中,系统会要求你将应用程序迁移到创作应用程序时所在的区域中的 Azure 资源。In the window for migrating regions, you will be asked to migrate your applications to an Azure resource in the same region they were authored in. LUIS 有三个创作区域和门户LUIS has three authoring regions and portals. 此窗口会显示在其中创作了你拥有的应用程序的区域。The window will show the regions where your owned applications were authored. 根据你使用的区域门户和你创作的应用,显示的迁移区域可能会有所不同。The displayed migration regions may be different depending on the regional portal you use, and apps you've authored.

    多区域迁移。Multi region migration.

  5. 对于每个区域,请使用按钮来选择是创建新的 LUIS 创作资源,还是迁移到现有资源。For each region, choose to create a new LUIS authoring resource, or to migrate to an existing one using the buttons.

    选择创建新的创作资源还是使用现有的创作资源choose to create or existing authoring resource

    提供以下信息:Provide the following information:

    • 租户名称:与你的 Azure 订阅关联的租户。Tenant Name: The tenant that your Azure subscription is associated with. 默认情况下,这设置为你当前正在使用的租户。By default this is set to the tenant you're currently using. 可通过以下方式切换租户:关闭此窗口,并选择屏幕右上方包含你的姓名首字母的头像。You can switch tenants by closing this window and selecting the avatar in the top right of the screen, containing your initials. 单击“迁移到 Azure”以重新打开该窗口。Click on Migrate to Azure to re-open the window.
    • Azure 订阅名称:将要与资源关联的订阅。Azure Subscription Name: The subscription that will be associated with the resource. 如果有多个订阅属于你的租户,请从下拉列表中选择所需的订阅。If you have more than one subscription that belongs to your tenant, select the one you want from the drop-down list.
    • 创作资源名称:你选择的自定义名称。Authoring Resource Name: A custom name that you choose. 它用作创作和预测终结点查询的 URL 的一部分。It's used as part of the URL for your authoring and prediction endpoint queries. 如果要创建新的创作资源,请注意,资源名称只能包含字母数字字符、-,并且不能以 - 开头或结尾。If you are creating a new authoring resource, note that the resource name can only include alphanumeric characters, -, and can’t start or end with -. 如果名称中包含任何其他符号,则资源创建和迁移操作会失败。If any other symbols are included in the name, resource creation and migration will fail.
    • Azure 资源组名称:你从下拉列表中选择的自定义资源组名称。Azure Resource Group Name: A custom resource group name that you choose from the drop-down list. 使用资源组可将 Azure 资源分组,以便进行访问和管理。Resource groups allow you to group Azure resources for access and management. 如果订阅中目前没有资源组,则不允许在 LUIS 门户中创建资源组。If you currently do not have a resource group in your subscription, you will not be allowed to create one in the LUIS portal. 请转到 Azure 门户来创建一个资源组,然后转到 LUIS 以继续完成登录过程。Go to Azure portal to create one then go to LUIS to continue the sign-in process.
  6. 在所有区域中成功迁移后,单击“完成”。After you have successfully migrated in all regions, click on finish. 现在,你将能够访问你的应用程序。You will now have access to your applications. 你可以继续在门户中创作和维护所有区域中的所有应用程序。You can continue authoring and maintaining all your applications in all regions within the portal.

迁移说明Migration notes

  • 迁移前,共同创作者在 LUIS 应用级别称为“协作者”。Before migration, coauthors are known as collaborators on the LUIS app level. 迁移后,将在 Azure 资源级别使用 Azure 参与者角色来实现相同的功能。After migration, the Azure role of contributor is used for the same functionality on the Azure resource level.
  • 如果你已登录到多个 LUIS 区域门户,则系统会要求你一次在多个区域中进行迁移。If you have signed-in to more than one LUIS regional portal, you will be asked to migrate in multiple regions at once.
  • 如果你是应用程序的所有者,则应用程序会自动随你一起迁移。Applications will automatically migrate with you if you're the owner of the application. 如果你是应用程序的协作者,则应用程序不会随你一起迁移。Applications will not migrate with you if you're a collaborator on the application. 但是,系统会提示协作者导出所需的应用。However, collaborators will be prompted to export the apps they need.
  • 应用程序所有者无法选择要迁移的应用子集。所有者无法了解协作者是否已迁移。Application owners can't choose a subset of apps to migrate and there is no way for an owner to know if collaborators have migrated.
  • 迁移不会自动将协作者移动或添加到 Azure 创作资源。Migration does not automatically move or add collaborators to the Azure authoring resource. 应用所有者需要在迁移后完成此步骤。The app owner is the one who needs to complete this step after migration. 此步骤需要对 Azure 创作资源的权限This step requires permissions to the Azure authoring resource.
  • 将参与者分配给 Azure 资源后,需要先迁移参与者,然后参与者才能访问应用程序。After contributors are assigned to the Azure resource, they will need to migrate before they can access applications. 否则,参与者将没有创作应用程序所需的访问权限。Otherwise, they won't have access to author the applications.

在迁移后使用应用Using apps after migration

在迁移过程完成后,你拥有的所有 LUIS 应用现在会被分配到单个 LUIS 创作资源。After the migration process, all your LUIS apps for which you're the owner will now be assigned to a single LUIS authoring resource. “我的应用”列表显示了已迁移到新的创作资源的应用。The My Apps list shows the apps migrated to the new authoring resource. 在访问你的应用之前,请选择“选择其他创作资源”来选择订阅和创作资源,以查看可创作的应用。Before you access your apps, select Choose a different authoring resource to select the subscription and authoring resource to view the apps that can be authored.

选择订阅和创作资源select subscription and authoring resource

如果你计划以编程方式编辑应用,则你需要使用创作密钥值。If you plan to edit your apps programmatically, you'll need the authoring key values. 在 LUIS 门户中,单击屏幕顶部的“管理”,然后选择“Azure 资源”,这样就可以显示这些值。These values are displayed by clicking Manage at the top of the screen in the LUIS portal, and then selecting Azure Resources. 在 Azure 门户中,资源的“密钥和终结点”页上也提供了它们。They're also available in the Azure portal on the resource's Key and endpoints page. 你还可以从同一页面创建更多的创作资源并分配它们。You can also create more authoring resources and assign them from the same page.

向创作资源添加参与者Adding contributors to authoring resources

如果应用需要由他人创作,则需在 Azure 门户的创作资源中添加关联的电子邮件地址。If your apps need to be authored by other people, you need to add the associated email addresses in the Azure portal's authoring resource.

如果你是 Azure 订阅的所有者或管理员,则可将参与者添加到资源。If you're the owner or administrator of your Azure subscription, you can add a contributor to the resource.

如果你不是 Azure 订阅的所有者或管理员,则你的 Azure 帐户需要具有 Microsoft.Authorization/roleAssignments/write 权限。If you're not the owner or administrator of your Azure subscription, your Azure account needs to have Microsoft.Authorization/roleAssignments/write permissions.

如果在执行此角色分配时遇到问题,请查看:If you have trouble with this role assignment, review:

了解在创作资源上如何添加参与者Learn how to add contributors on your authoring resource. 参与者将有权访问该资源下的所有应用程序。Contributors will have access to all applications under that resource.

可以通过 Azure 门户在该资源的“访问控制(IAM)”页上向创作资源添加参与者。You can add contributors to the authoring resource from the Azure portal, on the Access Control (IAM) page for that resource. 有关详细信息,请参阅向应用添加参与者For more information, see Add contributors to your app.

备注

如果 LUIS 应用的所有者将协作者迁移到并添加为 Azure 资源上的参与者,协作者将仍无法访问该应用,除非他们自己也进行迁移。If the owner of the LUIS app migrated and added the collaborator as a contributor on the Azure resource, the collaborator will still have no access to the app unless they also migrate.

排查迁移过程的问题Troubleshooting the migration process

如果在下拉列表中找不到你的 Azure 订阅:If you cannot find your Azure subscription in the drop-down list:

  • 请确保你有一个有效的 Azure 订阅,且该订阅有权创建认知服务资源。Ensure that you have a valid Azure subscription that's authorized to create Cognitive Services resources. 转到 Azure 门户并检查订阅状态。Go to the Azure portal and check the status of the subscription. 如果你没有帐户,请创建一个 Azure 帐户If you don't have one, create a Azure account.

  • 确保你是在与有效订阅关联的正确租户中。Ensure that you're in the proper tenant associated with your valid subscription. 可通过以下方式切换租户:选择屏幕右上方包含你的姓名首字母的头像。You can switch tenants selecting the avatar in the top right of the screen, containing your initials.

    用于切换目录的页面Page for switching directories

如果你有现有的创作资源,但在选择“使用现有的创作资源”选项时找不到它,则:If you have an existing authoring resource but can't find it when you select the Use Existing Authoring Resource option:

  • 创建你的资源的区域可能不同于你尝试在其中进行迁移的区域。Your resource was probably created in a different region than the one your are trying to migrate in.
  • 请改为通过 LUIS 门户创建新资源。Create a new resource from the LUIS portal instead.

如果你选择“创建新的创作资源”选项,但迁移失败并出现“检索用户的 Azure 信息失败,请稍后再重试”错误消息,则:If you select the Create New Authoring Resource option and migration fails with the error message "Failed retrieving user's Azure information, retry again later":

  • 在单个区域中,你的订阅可能每个都有 10 个或更多个创作资源。Your subscription might have 10 or more authoring resources per region, per subscription. 如果是这样,则无法创建新的创作资源。If that's the case, you won't be able to create a new authoring resource.
  • 请选择“使用现有的创作资源”选项,并选择你的订阅下的现有资源之一,通过这种方式进行迁移。Migrate by selecting the Use Existing Authoring Resource option and selecting one of the existing resources under your subscription.

新建支持请求Create new support request

如果你有故障排除部分未解决的任何迁移问题,请创建支持主题并在下面的字段中提供以下信息:If you are having any issues with the migration that are not addressed in the troubleshooting section, please create a support topic and provide the information below with the following fields:

  • 问题类型:技术方面Issue Type: Technical
  • 订阅:从下拉列表中选择一个订阅Subscription: Choose a subscription from the dropdown list
  • 服务:搜索并选择“认知服务”Service: Search and select "Cognitive Services"
  • 资源:选择一个 LUIS 资源(如果有)。Resource: Choose a LUIS resource if there is an existing one. 如果没有,请选择“常规问题”。If not, select General question.

后续步骤Next steps