Conectar um bot à CortanaConnect a bot to Cortana

Cortana é um canal habilitado para fala que pode enviar e receber mensagens de voz e texto.Cortana is a speech-enabled channel that can send and receive voice messages in addition to textual conversation. Para que um bot possa se conectar à Cortana, ele deve ser projetado para fala e também texto.A bot intended to connect to Cortana should be designed for speech as well as text. Uma habilidade da Cortana é um bot que pode ser invocado usando um cliente da Cortana.A Cortana skill is a bot that can be invoked using a Cortana client. A publicação de um bot o adiciona à lista de habilidades disponíveis.Publishing a bot adds the bot to the list of available skills.

Para adicionar o canal da Cortana, abra o bot no Portal do Azure, clique na folha Canais e clique em Cortana.To add the Cortana channel, open the bot in the Azure Portal, click the Channels blade, and then click Cortana.

Adicione o canal da Cortana

Configurar a CortanaConfigure Cortana

Ao conectar seu bot ao canal da Cortana, algumas informações básicas sobre seu bot serão preenchidas previamente no formulário de registro.When connecting your bot with the Cortana channel, some basic information about your bot will be pre-filled into the registration form. Examine essas informações com atenção.Review this information carefully. Esse formulário contém os campos a seguir.This form consists of the following fields.

CampoField DESCRIÇÃODescription
Ícone de HabilidadeSkill icon Um ícone exibido na tela da Cortana quando sua habilidade for invocada.An icon that is displayed in the Cortana canvas when your skill is invoked. Isso também será usado quando as habilidades forem detectáveis (como a Microsoft Store).This is also used where skills are discoverable (like the Microsoft store). (Apenas PNG com no máximo 32KB).(32KB max, PNG only).
Nome de exibiçãoDisplay name O nome da sua habilidade da Cortana é exibido ao usuário na parte superior da interface do usuário visual.The name of your Cortana skill is displayed to the user at the top of the visual UI. (Limite de 30 caracteres)(30 character limit)
Nome da invocaçãoInvocation name Esse é o nome falado pelos usuários ao invocar uma habilidade.This is the name users say when invoking a skill. Ele não deve ter mais do que três palavras e deve ser fácil de pronunciar.It should be no more than three words and easy to pronounce. Confira as Diretrizes de nome de invocação para saber mais sobre como escolher esse nome.See the Invocation Name Guidelines for more information on how to choose this name.

Configurações padrão

!OBSERVAÇÃO: Atualmente, o Cortana não dá suporte ao uso da autenticação de conta do AAD (Azure Active Directory).!NOTE: Cortana does not currently support the use of Azure Active Directory (AAD) Account authentication. Você precisará usar uma MSA (Conta Microsoft) para publicar seu bot com êxito no Cortana.You will need to use a Microsoft Account (MSA) to successfully publish your bot to Cortana.

Informações gerais sobre o botGeneral bot information

Em Gerenciar a identidade do usuário por meio da seção de serviços conectados pressione a opção para habilitá-lo.Under the Manage user identity through connected services section press the option to enable it. Preencha o formulário.Fill in the form.

Todos os campos marcados com um asterisco (*) são obrigatórios.All fields marked with an asterisk (*) are required. Um Bot deve ser publicado no Azure antes de poder ser conectado à Cortana.A Bot must be published to Azure before it can be connected to Cortana.

Gerenciar identidade de usuário, parte 1 Gerenciar identidade de usuário, parte 2Manage user identity, part 1 Manage user identity, part 2

Quando a Cortana deve solicitar a entrada de um usuárioWhen should Cortana prompt for a user to sign in

Selecione Entrar na invocação se você quiser que a Cortana conecte o usuário no momento em que ele invocar uma habilidade.Select Sign in at invocation if you want Cortana to sign in the user at the time they invoke your skill.

Selecione Entrar quando for necessário se você usar um cartão de entrada do Serviço de Bot para a entrada do usuário.Select Sign in when required if you use a Bot Service sign-in card to sign in the user. Normalmente, você usa essa opção se quiser conectar o usuário somente se ele usar um recurso que exige autenticação.Typically, you use this option if you want to sign in the user only if they will use a feature that requires authentication. Quando sua habilidade envia uma mensagem que inclui o cartão de entrada como anexo, a Cortana ignora o cartão de entrada e executa o fluxo de autorização usando as configurações da Conta de Conexão.When your skill sends a message that includes the sign-in card as an attachment, Cortana ignores the sign-in card and performs the authorization flow using the Connect Account settings.

Nome da contaAccount name

O nome da sua habilidade que você quer exibir quando o usuário entrar em sua habilidade.The name of your skill that you want displayed when the user signs in to your skill.

ID de cliente para serviços de terceirosClient ID for third-party services

ID do aplicativo do seu bot.Your bot's application ID. Você recebeu a ID quando registrou seu bot.You received the ID when you registered your bot.

Lista de escopos separados por espaçosSpace-separated list of scopes

Especifique os escopos exigidos pelo serviço (confira a documentação do serviço).Specify the scopes that the service requires (see the service's documentation).

URL de autorizaçãoAuthorization URL

Defina como https://login.microsoftonline.com/common/oauth2/v2.0/authorize.Set to https://login.microsoftonline.com/common/oauth2/v2.0/authorize.

Opções de tokenToken options

Selecione POST.Select POST.

Tipo de concessãoGrant type

Selecione Código de autorização para usar o fluxo de concessão de código, ou selecione Implícito para usar o fluxo implícito.Select Authorization code to use the code grant flow, or select Implicit to use the implicit flow.

URL de tokenToken URL

Para o tipo de concessão Código de autorização defina como https://login.microsoftonline.com/common/oauth2/v2.0/token.For the Authorization code grant type, set to https://login.microsoftonline.com/common/oauth2/v2.0/token.

Senha/segredo do cliente para serviços de terceirosClient secret/password for third party services

A senha do bot.The bot's password. Você recebeu a senha quando registrou seu bot.You received the password when you registered your bot.

Esquema de autenticação de clienteClient authentication scheme

Selecione HTTP Básico.Select HTTP Basic.

O acesso à Internet é necessário para autenticar usuáriosInternet access required to authenticate users

Deixe desmarcada.Leave this unchecked.

Solicitar dados de perfil do usuário (opcional)Request user profile data (optional)

A Cortana fornece acesso a vários tipos diferentes de informações de perfil do usuário, as quais você pode usar para personalizar o bot para o usuário.Cortana provides access to several different types of user profile information, that you can use to customize the bot for the user. Por exemplo, se uma habilidade tiver acesso ao nome e ao local do usuário, a habilidade poderá ter uma resposta personalizada, por exemplo, "Olá Kamran, espero que tenha um dia agradável em Bellevue, Washington".For example, if a skill has access to the user's name and location then the skill can have custom response such as "Hello Kamran, I hope you are having a pleasant day in Bellevue, Washington."

Clique em Adicionar uma solicitação de perfil do usuário e selecione as informações de perfil de usuário que você deseja na lista suspensa.Click Add a user profile request, then select the user profile information you want from the drop-down list. Adicione um nome amigável ao acesso dessas informações no código do seu bot.Add a friendly name to use to access this information from your bot's code.

Implantar na CortanaDeploy on Cortana

Quando você terminar de preencher o formulário de registro da sua habilidade da Cortana, clique em Implantar na Cortana para concluir a conexão.When you are done filling out the registration form for your Cortana skill, click Deploy on Cortana to complete the connection. Isso levará você de volta à folha Canais do seu bot, e você verá que ele está conectado à Cortana.This brings you back to your bot's Channels blade and you should see that it is now connected to Cortana.

Neste ponto, seu bot já foi implantado como uma habilidade da Cortana à sua conta.At this point your bot is deployed as a Cortana skill to your account.

Próximas etapasNext steps