Introdução à integração de compreensão da linguagem coloquial

Este artigo orienta sobre 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 todos os tópicos personalizados que você deseja criar
• A chave e a URL de previsão para o modelo implantado
• O nome do projeto da CLU e o nome da implantação
• Uma chave de conta para os Serviços Cognitivos
• Uma URL do site para a Linguagem de IA do Azure
• Uma conta do Copilot Studio
• Um agente do Copilot Studio configurado para usar a orquestração clássica
• Um conector de linguagem do Copilot Studio configurado para usar credenciais fornecidas pelo criador

Prepare seu projeto da CLU

1. Se você não tiver uma assinatura do Azure, crie uma conta gratuita.

2. Crie um recurso de linguagem no Language Studio, com o recurso compreensão da linguagem coloquial ativado.

   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 todos os tópicos personalizados que você adicionar ao agente.

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

4. Treine e implante o projeto da CLU na mesma região que o agente do Copilot Studio.

Preparar seu agente

1. Acesse a página Configurações de seu agente. As configurações para a categoria IA Generativa são exibidas.

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

3. Selecione Reconhecimento vocal no painel lateral.

4. Selecione Utilizar NLU predefinido do Azure.

5. Se o ambiente ainda não estiver conectado à Linguagem de IA do Azure ou se você quiser usar uma nova conexão, selecione Gerenciar conexões, acesse o Power Apps e crie uma conexão CLU.

6. Selecione a conexão CLU desejada.

7. Clique em Salvar. 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, exclua minhas frases de gatilho e selecione Continuar.

10. Insira as informações de implantação de nome e modelo para o projeto de linguagem de IA do Azure apropriado e selecione Salvar. Depois que 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.

    Nota

    Alterar a configuração de reconhecimento de linguagem do agente de volta para o Microsoft Copilot Studio 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.

Mapear intenções e entidades de CLU

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

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

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

2. Selecione o tópico desejado.

3. No nó de Gatilho, 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ó de Gatilho na seção Intenção externa.

   Nota

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

5. Clique em Salvar.

6. Repita estas etapas para qualquer tópico restante que você deseja mapear para uma intenção de CLU externa.

Mapear entidades manualmente

1. Acesse a página Configurações de seu agente.

2. Selecione Entidades.

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

4. No painel aberto, insira o nome desejado e uma descrição (opcional).

5. Para Tipo de Dados, selecione De dados de exemplo.

6. Selecione Obter esquema no JSON de exemplo, insira um snippet de código JSON para sua entidade CLU e selecione Confirmar. Encontre exemplos de trechos de código JSON no registro de entidade para integração de compreensão de linguagem natural em conversação.

7. Selecione Salvar e feche o painel.

8. Repita estas etapas para qualquer entidade restante que você deseja mapear para uma entidade CLU externa.

Executar mapeamento em massa

1. Acesse a página Configurações de seu agente.

2. Selecione Reconhecimento vocal.

3. Selecione Adicionar tópicos e entidades de dados de modelo. A ferramenta Adicionar intenções e entidades aparece.

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

   Os dados do modelo são exibidos no painel Visualização .

5. Selecione Próximo. A tela Tópicos existentes do Mapa é exibida.

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

7. Examine suas seleções e selecione Avançar. A tela Criar novos tópicos é exibida, mostrando intenções que não sã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.

   Nota

   O assistente ignora todos os campos que você deixa em branco.

9. Selecione Próximo. 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. Examine os mapeamentos nos tópicos existentes, novos tópicos e guia Novas entidades e selecione Salvar.

12. Examine as informações na tela Êxito e selecione Concluído.

Depois de concluir este procedimento, você poderá ir até a página Tópicos para examinar seus tópicos. Para obter mais informações, consulte Gerenciar tópicos.

Criar uma conexão de CLU no Power Apps

1. No Power Apps, se a página Conexões ainda não estiver em foco, selecione Conexões no painel esquerdo.

2. Selecione Nova conexão.

3. Selecione Serviço Cognitivo do Azure para Linguagem (use o campo de pesquisa para restringir a lista, se necessário). Uma janela será exibida solicitando informações de autenticação.

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

5. Insira a URL do site raiz apropriada, se houver.

6. Selecione Criar. A nova conexão, com o nome padrão "Serviço Cognitivo do Azure para Linguagem", será exibida na lista de conexões do seu ambiente.

7. Selecione os três pontos (⋮) ao lado dessa 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

• Visão geral da integração de compreensão da linguagem coloquial
• Registro de entidade para integração de compreensão da linguagem coloquial