Começar a utilizar a integração de compreensão de linguagem conversacional

Este artigo mostra como integrar um modelo de CLU a um agente.

Pré-requisitos

• Um modelo de CLU totalmente treinado, incluindo intenções para todos os tópicos do sistema e para quaisquer tópicos personalizados que você queira criar
• A chave e o URL de predição para o modelo implementado
• O nome do projeto da CLU e o nome da implementação
• Uma chave de conta para os Serviços Cognitivos
• Uma URL de site para o Azure AI Language
• Uma conta do Copilot Studio
• Um agente do Copilot Studio configurado para usar orquestração clássica
• Um conector de idioma do Copilot Studio configurado para usar credenciais fornecidas pelo fabricante

Prepare seu projeto CLU

1. Se não tiver uma subscrição do Azure, crie uma conta gratuita.

2. Crie um recurso de idioma no Language Studio, com a funcionalidade compreensão de linguagem conversacional ativada.

   Para garantir que o agente do Copilot Studio funcione corretamente, o modelo de CLU criado deve ter intenções para todos os tópicos do sistema e para quaisquer tópicos personalizados adicionados ao agente.

3. Defina as entidades que você deseja que seu agente do Copilot Studio use.

4. Prepare e implemente o projeto da CLU na mesma região que o seu agente do Copilot Studio.

Prepare o seu agente

1. Vá para a página Configurações do seu agente. As configurações para a categoria IA generativa são exibidas.

2. Se a orquestração generativa estiver ativada, mude para orquestração clássica: em Orquestração, selecione Não.

3. Selecione Compreensão de idioma no painel lateral.

4. Selecione Utilize o NLU do Azure pré-criado.

5. Se o seu ambiente ainda não estiver conectado ao Azure AI Language ou se você quiser usar uma nova conexão, selecione Gerenciar conexões, vá para Power Apps e crie uma conexão CLU.

6. Selecione a conexão CLU desejada.

7. Selecione Guardar. Uma janela é exibida, solicitando que você salve um instantâneo do seu agente antes de excluir todas as frases de gatilho existentes para seus tópicos.

8. Selecione Salvar instantâneo e salve o arquivo ZIP resultante (botContent.zip) no local desejado. O arquivo ZIP contém um único arquivo YAML (botContent.yml) com o conteúdo do agente, incluindo frases de gatilho e mensagens.

9. Selecione Sim, excluir minhas frases de gatilho e, em seguida, selecione Continuar.

10. Insira o nome e as informações de implantação do modelo para o projeto apropriado do Azure AI Language e selecione Salvar. Quando essa operação for concluída, você poderá ver um novo tópico do sistema chamado Analisar texto. Este tópico está conectado ao seu modelo de CLU e sua finalidade é reconhecer intenções e entidades em conversas entre clientes e seu agente.

    Observação

    Alterar a configuração de compreensão de idioma para o seu agente de volta para o Microsoft Copilot Studio NLU remove o tópico de sistema Analisar texto. Também exige que adicione manualmente frases de exemplo para tópicos atualmente mapeados para intenções externas.

Mapear intenções e entidades da CLU

No agente do Copilot Studio, comece a mapear os tópicos existentes para as intenções da CLU. Você pode mapear manualmente intenções e entidades ou executar mapeamento em massa.

Mapeie manualmente as intenções da CLU para tópicos

1. Vá para a página Tópicos do seu agente.

2. Selecione o tópico pretendido.

3. No nó Acionador, selecione Editar. O painel Frases é exibido.

4. Em Nome da intenção, insira o nome da intenção da CLU que você deseja mapear para este tópico. O nome da intenção aparece no nó Acionador em Intenção externa.

   Observação

   O nome da intenção da CLU deve ser introduzido exatamente como armazenado no modelo da CLU, incluindo a correspondência de maiúsculas e minúsculas.

5. Selecione Guardar.

6. Repita estes passos para qualquer tópico restante que pretenda mapear para uma intenção da CLU externa.

Mapear entidades manualmente

1. Vá para a página Configurações do seu agente.

2. Selecione Entidades.

3. Selecione Adicionar uma entidade>Registar uma entidade externa.

4. No painel que se abre, introduza o nome pretendido e uma descrição (opcional).

5. Para Tipo de Dados, selecione A partir dos dados de exemplo.

6. Selecione Obter esquema do exemplo JSON, insira um trecho de código JSON para sua entidade CLU e selecione Confirmar. Encontre exemplos de trechos JSON em Registro de entidade para integração de compreensão de linguagem conversacional.

7. Selecione Salvar e feche o painel.

8. Repita essas etapas para qualquer entidade restante que você queira mapear para uma entidade CLU externa.

Executar mapeamento em massa

1. Vá para a página Configurações do seu agente.

2. Selecione Language Understanding.

3. Selecione Adicionar tópicos e entidades a partir de dados do modelo. O assistente Adicionar intenções e entidades é apresentado.

4. Selecione Escolher arquivo para selecionar o arquivo com os dados do modelo da CLU.

   Os dados do modelo aparecem no painel Visualização .

5. Selecione Avançar. A tela Mapear tópicos existentes é exibida.

6. Selecione a intenção desejada da CLU para cada tópico.

7. Reveja as suas seleções e selecione Seguinte. A tela Criar novos tópicos é exibida, mostrando intenções que não estão mapeadas para um tópico existente.

8. Se desejar, crie um novo tópico para cada uma dessas intenções: em Criar um novo tópico, insira um nome para cada tópico que você deseja criar.

   Observação

   O assistente ignora todos os campos deixados em branco.

9. Selecione Avançar. A tela Registrar entidades é exibida, mostrando as entidades CLU do arquivo de dados do modelo.

10. Selecione o tipo de dados apropriado para as entidades que você deseja usar e selecione Avançar. A tela Revisão é exibida.

11. Revise os mapeamentos na guia Tópicos existentes, Novos tópicos e Novas entidades e selecione Salvar.

12. Revise as informações na tela Sucesso e selecione Concluído.

Depois de concluir este procedimento, pode ir para a página Tópicos para rever os seus tópicos. Para mais informações, consulte Gerir tópicos.

Criar uma ligação da CLU no Power Apps

1. No Power Apps, se a página Ligações ainda não estiver focada, selecione Ligações no painel esquerdo.

2. Selecione Nova ligação.

3. Selecione Serviços Cognitivos do Azure para Linguagem (utilize o campo de pesquisa para restringir a lista, se necessário). É apresentada uma janela a solicitar informações de autenticação.

4. Para o tipo de autenticação, selecione Chave de API e introduza a chave de conta necessária.

5. Introduza o URL do site raiz apropriado, se existir.

6. Selecione Criar. A nova ligação, com o nome predefinido "Serviços Cognitivos do Azure para Linguagem", é apresentada na lista de ligações do seu ambiente.

7. Selecione os três pontos (⋮) ao lado desta conexão e selecione Editar.

8. Na janela exibida, substitua o nome de exibição padrão por outra coisa, para distinguir essa conexão de outras conexões CLU e selecione Atualizar.

Conteúdo relacionado

• Descrição geral da integração de compreensão da linguagem conversacional
• Registo de entidade para integração de compreensão de linguagem conversacional