Solução de problemas do QnA Maker
A lista das perguntas mais frequentes sobre o serviço do QnA Maker ajudará você a adotar o serviço com mais rapidez e com melhores resultados.
Observação
O serviço de QnA Maker está sendo desativado no dia 31 de março de 2025. Uma versão mais recente da funcionalidade de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para saber mais sobre o recurso de respostas às perguntas no Serviço de Linguagem, confira respostas às perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos de QnA Maker. Para obter informações sobre como migrar bases de dados de conhecimento do QnA Maker existentes para responder perguntas, consulte o guia de migração.
Gerenciar previsões
Como posso melhorar o desempenho da taxa de transferência para previsões de consulta?
Resposta: problemas de desempenho de taxa de transferência indicam que você precisa escalar verticalmente tanto o serviço de aplicativo quanto o Cognitive Search. Considere adicionar uma réplica ao Cognitive Search para aprimorar o desempenho.
Saiba mais sobre os tipos de preço.
Como obter o ponto de extremidade de serviço do QnAMaker
Resposta: o ponto de extremidade de serviço do QnAMaker será útil para finalidades de depuração quando você contatar o Suporte do QnAMaker ou UserVoice. O ponto de extremidade é uma URL neste formato: https://your-resource-name.azurewebsites.net.
Acesse o serviço do QnAMaker (grupo de recursos) no portal do Azure
Selecione o Serviço de Aplicativo associado ao recurso do QnA Maker. Normalmente, os nomes são os mesmos.
A URL do ponto de extremidade está disponível na seção Visão Geral
Gerenciar a base de conhecimento
Apaguei acidentalmente uma parte do meu QnA Maker, o que devo fazer?
Resposta: não exclua nenhum dos serviços do Azure criados com o recurso do QnA Maker, como pesquisa ou aplicativo Web. Eles são necessários para o funcionamento do QnA Maker. Se você excluir um deles, o QnA Maker deixará de funcionar corretamente.
Todas as exclusões são permanentes, incluindo pares de perguntas e respostas, arquivos, URLs, perguntas e respostas personalizadas, bases de conhecimento ou recursos do Azure. Certifique-se de exportar sua base de conhecimento da página Configurações antes de excluir qualquer parte de sua base de conhecimento.
Por que minhas URLs/arquivos não estão extraindo pares de pergunta-resposta?
Resposta: é possível que o QnA Maker não possa extrair automaticamente algum conteúdo de QnA (perguntas e respostas) de URLs válidas de perguntas frequentes. Nesses casos, você pode colar o conteúdo de QnA em um arquivo .txt e verificar se a ferramenta pode ingeri-lo. Como alternativa, você pode adicionar conteúdo de modo editorial à sua base de dados de conhecimento no Portal do QnA Maker.
Qual o tamanho da base de dados de conhecimento que posso criar?
Resposta: o tamanho da base de dados de conhecimento depende do SKU da pesquisa do Azure que você escolhe ao criar o serviço QnA Maker. Leia este texto para obter mais detalhes.
Por que não vejo nada na lista suspensa quando tento criar uma nova base de dados de conhecimento?
Resposta: você ainda não criou serviços do QnA Maker no Azure. Leia este artigo para saber como fazer isso.
Como posso compartilhar uma base de dados de conhecimento com outras pessoas?
Resposta: o compartilhamento funciona no nível do serviço QnA Maker, ou seja, todas as bases de dados de conhecimento nos serviços serão compartilhadas. Leia este texto sobre como colaborar em uma base de dados de conhecimento.
É possível compartilhar uma base de conhecimento com um colaborador que não está no mesmo locatário do AAD, para modificar uma base de Conhecimento?
Resposta: o compartilhamento é baseado no controle de acesso baseado em função do Azure. Se pode compartilhar qualquer recurso do Azure com outro usuário, você também pode compartilhar o QnA Maker.
Se você tiver um plano do Serviço de Aplicativo com cinco bases de dados de conhecimento do QnAMaker, poderá atribuir direitos de leitura/gravação a cinco usuários diferentes para que cada um deles possa acessar apenas uma base de dados de conhecimento do QnAMaker?
Resposta: você pode compartilhar todo o serviço do QnAMaker, não bases de dados de conhecimento individuais.
Como alterar a mensagem padrão quando nenhuma correspondência boa for encontrada?
Resposta: a mensagem padrão faz parte das configurações no Serviço de Aplicativo.
- Vá até o recurso do seu Serviço de Aplicativo no portal do Azure
- Selecione a opção Configurações
- Alterar o valor da configuração DefaultAnswer
- Reinicie o serviço Aplicativo
Por que meu link do SharePoint não está sendo extraído?
Resposta: confira mais informações em Locais da fonte de dados.
As atualizações que eu fiz em minha base de dados de conhecimento não são refletidas na publicação. Por que não?
Resposta: para publicar uma operação de edição, seja em uma atualização de tabela, teste ou configuração, é preciso antes salvá-la. Selecione o botão Salvar e treinar após cada operação de edição.
A base de dados de conhecimento dá suporte a dados avançados ou multimídia?
Resposta:
Extração automática de multimídia para arquivos e URLs
- URLS – funcionalidade limitada de conversão de HTML para Markdown.
- Arquivos – sem suporte
Texto de resposta em Markdown
Quando os pares de QnA estão na base de dados de conhecimento, você pode editar o texto de uma resposta em Markdown para incluir links para mídia disponível em URLs públicas.
O QnA Maker dá suporte para idiomas além do inglês?
Resposta: veja mais detalhes sobre os idiomas com suporte.
Se você tiver conteúdo de vários idiomas, crie um serviço separado para cada idioma.
Gerenciar serviço
Quando devo reiniciar o serviço de aplicativo?
Resposta: atualize o serviço de aplicativo quando o ícone de cuidado estiver ao lado do valor da versão da base de dados de conhecimento na tabela Chaves de ponto de extremidade da páginaConfigurações do Usuário.
Excluí meu serviço Pesquisa. Como posso corrigir isso?
Resposta: se você excluir uma Pesquisa de IA do Azure, a operação será final e o índice não poderá ser recuperado.
Excluí meu índice 'testkb' em meu serviço Pesquisa. Como posso corrigir isso?
Resposta: caso você tenha excluído o índice testkbem seu serviço Pesquisa, você poderá restaurar os dados da última base de dados de conhecimento publicada. Use a ferramenta de recuperação RestoreTestKBIndex disponível no GitHub.
Estou recebendo o seguinte erro: Verifique se as configurações de CORS do Serviço de aplicativo QnA Maker permitem https://www.qnamaker.ai ou se há restrições de rede específicas da organização. Como posso resolver isso??
Resposta: na seção API do painel do Serviço de aplicativo, atualize a configuração de CORS para * ou "https://www.qnamaker.ai". Se isso não resolver o problema, verifique se há restrições específicas da organização.
Quando devo atualizar minhas chaves de ponto de extremidade?
Resposta: atualize suas chaves de ponto de extremidade se suspeitar que elas foram comprometidas.
Posso usar o mesmo recurso de Pesquisa de IA do Azure para bases de dados de conhecimento que usam vários idiomas?
Resposta: para usar vários idiomas e várias bases de dados de conhecimento, o usuário precisa criar um recurso do QnA Maker para cada idioma. Isso criará serviços separados do Azure Search para cada idioma. Misturar bases de dados de conhecimento de idiomas diferentes em um único serviço de pesquisa do Azure resultará em resultados com relevância degradada.
Como alterar o nome do recurso de Pesquisa de IA do Azure usado pelo QnA Maker?
Resposta: o nome do recurso de Pesquisa de IA do Azure é o nome do recurso do QnA Maker com algumas letras aleatórias acrescentadas ao final. Isso torna difícil distinguir entre vários recursos de pesquisa do QnA Maker. Crie outro serviço de pesquisa separado (com o nome que você deseja) e conecte-o ao serviço QnA. As etapas são semelhantes às etapas que você precisa fazer para atualizar uma pesquisa do Azure.
Quando QnA Maker retorna 'O núcleo de runtime não está inicializado', como faço para corrigir isso?
Resposta: talvez o espaço em disco do serviço de aplicativo esteja cheio. Etapas para corrigir o espaço em disco:
No portal do Azure, selecione o serviço de aplicativo do QnA Maker e interrompa o serviço.
Ainda no serviço de aplicativo, selecione Ferramentas de Desenvolvimento, depois Ferramentas Avançadas e Ir. Uma nova janela do navegador é aberta.
Selecione Console de depuração e, depois, CMD para abrir uma ferramenta de linha de comando.
Acesse o diretório site/wwwroot/Data/QnAMaker/ .
Remova todas as pastas cujo nome começa com
rd.Não exclua estes itens:
- Arquivo KbIdToRankerMappings.txt
- Arquivo EndpointSettings.json
- Pasta EndpointKeys
Inicie o Serviço de Aplicativo.
Acesse a base de dados de conhecimento para confirmar que ela funciona agora.
Por que meu Application Insights não está funcionando?
Resposta: verifique e atualize as etapas abaixo para corrigir o problema:
Em Serviço de Aplicativo – >grupo Configurações –> seção Configuração – >Configurações do Aplicativo – >os parâmetros de nome "UserAppInsightsKey" devem estar devidamente configurados e definidos como a GUID da guia Visão geral ("Chave de Instrumentação") do respectivo Application Insights.
Em Serviço de Aplicativo – >grupo Configurações – >seção "Application Insights" –> Application Insights precisa estar habilitado e conectado ao respectivo recurso.
Meu Application Insights está habilitado. Por que ele não está funcionando corretamente?
Resposta: siga as etapas abaixo:
Copie o valor do nome "APPINSIGHTS_INSTRUMENTATIONKEY" para o nome "UserAppInsightsKey", substituindo se já houver algum valor presente.
Se a chave "UserAppInsightsKey" não existir nas configurações do aplicativo, adicione uma nova chave com esse nome e copie o valor.
Salve a chave, e o serviço de aplicativo será reiniciado automaticamente. Isso deve resolver o problema.
Integrar com outros serviços, incluindo Bots
Preciso usar o Bot Framework para usar o QnA Maker?
Resposta: não, você não precisa usar o Bot Framework com o QnA Maker. No entanto, o QnA Maker é oferecido como um de vários modelos no Serviço de Bot da IA do Azure. O Serviço de Bot permite o desenvolvimento rápido de bots inteligentes por meio da Estrutura de Bot da Microsoft e é executado em um ambiente sem servidor.
Como criar um bot com o QnA Maker?
Resposta: siga as instruções nessa documentação para criar um Bot com o Serviço de Bot da IA do Azure.
Como posso utilizar uma base de conhecimento diferente com um serviço de Bot da IA do Azure?
Resposta: você precisa ter as seguintes informações sobre a base de dados de conhecimento:
- ID da base de dados de conhecimento.
- O nome de subdomínio personalizado do ponto de extremidade publicado da base de dados de conhecimento, chamado de
host, que é exibido na página Configurações após a publicação. - A chave de ponto de extremidade publicada da base de dados de conhecimento, que é exibida na página Configurações após a publicação.
Com essas informações, acesse o serviço de aplicativo do bot no portal do Azure. Em Configurações -> Configuração -> Configurações de aplicativo, altere esses valores.
A chave de ponto de extremidade da base de dados de conhecimento é rotulada QnAAuthkey no serviço ABS.
Dois ou mais aplicativos clientes podem compartilhar uma base de dados de conhecimento?
Resposta: sim, qualquer número de clientes pode consultar a base de dados de conhecimento. Se a resposta da base de dados de conhecimento estiver lenta ou atingir o tempo limite, considere alterar a camada de serviço de aplicativo associado à base de dados de conhecimento.
Como posso inserir o serviço QnA Maker no meu site?
Resposta: execute as etapas para inserir o serviço QnA Maker como um controle de webchat em seu site:
Armazenamento de dados
Quais dados são armazenados e em que local eles são armazenados?
Resposta:
Quando você cria seu serviço QnA Maker, você selecionou uma região do Azure. Suas bases de conhecimento e arquivos de log são armazenados nessa região.