Introdução à integração de reconhecimento de linguagem conversacional (versão preliminar)

  • Artigo

Importante

Este tópico contém a documentação de pré-lançamento e está sujeito a alterações.

A Versão prévia dos recursos não foi criada para uso em ambientes de produção e pode ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e fornecer comentários.

Este tópico inclui os procedimentos passo a passo de que você precisa para começar a usar a integração de reconhecimento de linguagem conversacional (CLU). Vamos começar.

Abaixo estão as etapas para criar um bot usando um modelo de CLU existente:

  1. Preparar o ambiente.
  2. Preparar seu projeto de reconhecimento de linguagem coloquial.
  3. Mapear intenções e entidades de CLU:

Preparar o ambiente

Antes de começar, verifique se você tem o nome do projeto e o nome da implantação do seu modelo de CLU.

  1. Crie um novo bot do Power Virtual Agents.

    Observação

    Certifique-se de que o ambiente para seu bot foi criado em uma região compatível com o Power Virtual Agents e que tem uma região CLU equivalente.

    Nem todas as regiões compatíveis com o Power Virtual Agents têm uma região CLU equivalente.

  2. Com o bot aberto, expanda a guia Configurações no painel do menu lateral e selecione Idioma.

    Captura de tela do aplicativo Web do Power Virtual Agents com as opções de menu Configurações e Idioma destacadas.

    Observação

    Se você já tiver ativado uma conexão CLU, pule para a etapa 4.

  3. Para criar uma nova conexão, no Power Apps, escolha o menu Conexões, selecione …Mais e procure Azure Cognitive Service for Language.

    Serviço Cognitivo do Azure para Linguagem.

  4. Na lista suspensa Recurso de NLU, escolha NLU do Power Virtual Agent.

    Opção de linguagem para selecionar o recurso de NLU.

Observação

Se vir o seguinte, então você não estará conectado ao Azure Congnitive Service for Language. Siga a etapa 3 para conectar-se.

Menu de opções de idioma quando não conectado ao Azure Congnitive Service for Language.

  1. Selecione o + (sinal de adição) à direita do nome do conector para exibir a página de configurações de autenticação.

  2. Insira o nome de exibição, a chave de API, a chave de conta, a URL do site e selecione Salvar. Depois que o Power Apps criar o conector, retorne ao seu bot do Power Virtual Agents. Insira o nome de exibição, o tipo de autenticação, a chave da conta e a URL do site.

  3. Para exibi-lo na lista Conexões, clique com o botão direito do mouse no conector Serviço Cognitivo do Azure para Linguagem e selecione Editar.

  4. Altere o nome de exibição para diferenciá-lo de outros conectores de CLU. O nome que você inserir para alterar pode ser o nome de sua preferência.

  5. Na navegação à esquerda no Power Virtual Agents, escolha Linguagem, na lista suspensa Recurso de NLU, escolha [o nome que você digitou na última etapa] e, em seguida, selecione Salvar.

  6. Na opção Excluir frases de gatilho de exemplo?, selecione Salvar instantâneo. Isso salva o conteúdo do bot, incluindo frases de gatilho e diálogos do bot, em um arquivo de lista de pendências no formato YAML.

    Selecione Salvar instantâneo para excluir frases de gatilho de exemplo.

  7. Insira o nome do projeto e as informações da implantação, em seguida, selecione Salvar. Escolha um projeto e modelo no Serviço Cognitivo do Azure para Linguagem.

Em seguida, volte para o Power Virtual Agents. Voltar para o ambiente de NLU remove o tópico do sistema Analisar texto. Isso também requer a adição manual de frases de exemplo para tópicos atualmente mapeados para intenções externas.

Alterne para o NLU do Power Virtual Agents.

Agora que concluiu a preparação do seu ambiente, você está pronto para mapear intenções e entidades para dados do modelo de CLU.

Preparar seu projeto de reconhecimento de linguagem coloquial

  1. Caso não tenha uma assinatura do Azure, crie uma conta gratuita antes de começar.
  2. Em seguida, crie um recurso de linguagem no Language Studio, com o recurso reconhecimento de linguagem coloquial ativado.
  3. Observe que, para garantir que o PVA funcione corretamente, você precisará criar intenções para tópicos do sistema do Power Virtual Agent e para tópicos personalizados que você pode quiser criar.
  4. Crie entidades personalizadas que deseja usar no projeto do Power Virtual Agents.
  5. Treine e implante o projeto na mesma região que seu recurso do Power Virtual Agents.

Mapear intenções e entidades de CLU para tipos de dados predefinidos do Power Virtual Agents

Você cria um novo bot do Power Virtual Agents mapeando os tópicos existentes para intenções de CLU. Você pode mapear intenções e entidades manualmente. Para mapeamento em massa, consulte Usar o assistente da ferramenta Em massa.

Mapear intenções manualmente:

  1. Abra seu bot do Power Virtual Agents.

  2. Na navegação à esquerda, selecione Tópicos.

    Selecione Tópicos na navegação à esquerda.

  3. Na seção Frases do nó Gatilho, selecione o link Editar .

    Selecione o link Editar.

  4. Na caixa Adicionar frases, insira o nome da intenção de CLU que você deseja mapear.

    Insira o nome da intenção de CLU.

    Observação

    O nome da intenção de CLU deve ser digitado exatamente como armazenado no modelo de CLU, incluindo o uso de letras maiúsculas e minúsculas.

  5. Clique no sinal de + (adição) à direita da caixa Adicionar frases para salvar a intenção.

Mapear entidades manualmente:

  1. Abra seu bot do Power Virtual Agents.

  2. Na navegação à esquerda, selecione Entidades.

    Selecione Entidades na navegação à esquerda.

  3. Selecione Nova entidade na página Entidades. Selecione + Nova entidade para criar uma nova entidade.

  4. No painel Nova entidade, adicione um nome, descrição (opcional) e Tipo de dados para sua entidade. Insira o nome, a descrição e o tipo de dados da sua nova entidade.

  5. Para acessar entidades predefinidas de CLU, no menu suspenso Tipo de Dados, selecione Dos dados de exemplo e escolha um dos trechos de código JSON predefinidos de CLU.

  6. (Opcional) Se quiser importar o esquema JSON de um arquivo de exemplo, escolha Obter esquema do JSON de exemplo para acessar o arquivo externo.

Usar o assistente da ferramenta Em massa

Você cria um novo bot mapeando tópicos existentes em massa para intenções de CLU usando o assistente Mapear intenções e entidades. Com o assistente, seu bot pode utilizar automaticamente intenções existentes do seu modelo de CLU em vez de frases de gatilho a fim de determinar para qual tópico mapear.

Comece carregando o arquivo de dados do modelo de CLU e mapeie automaticamente as intenções de CLU para o seu bot do Power Virtual Agents.

  1. Na navegação à esquerda, selecione Linguagem e Adicionar tópicos e entidades dos dados do modelo.

  2. Na opção Nome do arquivo, selecione Escolher arquivo para selecionar o arquivo de dados do qual você deseja carregar seu modelo de CLU.

  3. Em seguida, você vê o arquivo de dados do modelo na janela Visualização. Selecione Avançar para continuar.

  4. selecione Adicionar intenções e entidades.

  5. Na tela Mapear tópicos existentes para intenções de CLU, escolha uma intenção de CLU para mapear para o tópico correspondente. Mapeie tópicos existentes para intenções de CLU.

  6. Revise suas seleções e selecione Salvar. Revise sua seleção e selecione Salvar.

  7. (Opcional) Para as intenções que não são mapeadas para um tópico existente, você pode criar novos tópicos. No assistente, você verá uma lista de intenções de CLU que não foram mapeadas para um tópico. No campo Criar um novo tópico, insira um nome para cada um dos tópicos que você deseja criar e selecione Avançar.
    Crie novos tópicos para intenções de CLU.

    Observação

    Todos os campos que você deixar em branco serão ignorados pelo assistente.

  8. Depois que todas as intenções e entidades de CLU forem mapeadas para tópicos do Power Virtual Agents, selecione Concluído. Adicione intenções e entidades e selecione Concluído para concluir.

Depois de concluir este procedimento, os tópicos do seu bot aparecerão no painel Tópicos do Power Virtual Agents. Para obter mais informações, consulte Gerenciar tópicos.