Solução de problemas do QnA Maker
A lista selecionada das perguntas mais frequentes sobre o serviço QnA Maker irá ajudá-lo a adotar o serviço mais rapidamente e com melhores resultados.
Nota
O serviço QnA Maker será desativado no dia 31 de março de 2025. Uma versão mais recente do recurso de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para obter os recursos de resposta a perguntas no Serviço Linguístico, consulte Resposta a perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos do QnA Maker. Para obter informações sobre como migrar bases de conhecimento existentes do QnA Maker para responder a 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 aumentar a escala para o serviço de aplicativo e a Pesquisa cognitiva. Considere adicionar uma réplica à sua Pesquisa Cognitiva para melhorar o desempenho.
Saiba mais sobre os níveis de preços.
Como obter o ponto de extremidade do serviço QnAMaker
Resposta: O ponto de extremidade do serviço QnAMaker é útil para fins de depuração quando você entra em contato com o Suporte do QnAMaker ou com o UserVoice. O ponto de extremidade é um URL neste formato: https://your-resource-name.azurewebsites.net.
Vá para o serviço QnAMaker (grupo de recursos) no portal do Azure
Selecione o Serviço de Aplicativo associado ao recurso QnA Maker. Normalmente, os nomes são os mesmos.
O URL do ponto de extremidade está disponível na seção Visão geral
Gerenciar a base de dados de conhecimento
Eu apaguei acidentalmente uma parte do meu QnA Maker, o que devo fazer?
Resposta: Não exclua nenhum dos serviços do Azure criados junto com o recurso QnA Maker, como Pesquisa ou Aplicativo Web. Estes são necessários para que o QnA Maker funcione, se você excluir um, 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 dados de conhecimento ou recursos do Azure. Certifique-se de exportar sua base de dados de conhecimento da página Configurações antes de excluir qualquer parte da base de dados de conhecimento.
Porque é que o(s) meu(s) URL(s)/ficheiro(s) não extrai pares pergunta-resposta?
Resposta: É possível que o QnA Maker não consiga extrair automaticamente algum conteúdo de perguntas e respostas (QnA) de URLs de perguntas frequentes válidas. Nesses casos, você pode colar o conteúdo do QnA em um arquivo .txt e ver se a ferramenta pode ingeri-lo. Como alternativa, você pode adicionar conteúdo editorialmente à sua base de conhecimento por meio do portal QnA Maker.
Quão grande é a base de dados de conhecimento que posso criar?
Resposta: O tamanho da base de dados de conhecimento depende da SKU da pesquisa do Azure escolhida ao criar o serviço QnA Maker. Leia aqui para mais detalhes.
Porque não consigo ver nada no menu pendente quando tento criar uma nova base de dados de conhecimento?
Resposta: Você ainda não criou nenhum serviço do QnA Maker no Azure. Leia aqui para saber como fazer isso.
Como partilho uma base de dados de conhecimento com outros?
Resposta: A partilha funciona ao nível de um serviço QnA Maker, ou seja, todas as bases de conhecimento no serviço serão partilhadas. Leia aqui como colaborar numa base de conhecimento.
Você pode compartilhar uma base de dados de conhecimento com um colaborador que não esteja no mesmo locatário do AAD para modificar uma base de dados de conhecimento?
Resposta: O compartilhamento é baseado no controle de acesso baseado em função do Azure. Se você puder compartilhar qualquer recurso no Azure com outro usuário, também poderá compartilhar o QnA Maker.
Se você tiver um Plano do Serviço de Aplicativo com 5 bases de conhecimento do QnAMaker. Você pode atribuir direitos de leitura/gravação a 5 usuários diferentes para que cada um deles possa acessar apenas 1 base de conhecimento do QnAMaker?
Resposta: Você pode compartilhar um serviço QnAMaker inteiro, não bases de conhecimento individuais.
Como posso alterar a mensagem padrão quando nenhuma boa correspondência é encontrada?
Resposta: A mensagem padrão faz parte das configurações do seu Serviço de aplicativo.
- Vá para o recurso do 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 de aplicativo
Por que meu link do SharePoint não está sendo extraído?
Resposta: Consulte Locais de fontes de dados para obter mais informações.
As atualizações que fiz na minha base de dados de conhecimento não são refletidas na publicação. Porque não?
Resposta: Toda operação de edição, seja em uma atualização de tabela, teste ou configuração, precisa ser salva antes de ser publicada. Certifique-se de selecionar o botão Salvar e treinar após cada operação de edição.
A base de dados de conhecimento suporta dados avançados ou multimédia?
Resposta:
Extração automática de multimédia para ficheiros e URLs
- URLS - capacidade limitada de conversão de HTML para Markdown.
- Ficheiros - não suportados
Texto da resposta em markdown
Quando os pares QnA estiverem na base de conhecimento, você poderá editar o texto de marcação de uma resposta para incluir links para mídia disponível em URLs públicas.
O QnA Maker suporta idiomas diferentes do inglês?
Resposta: Veja mais detalhes sobre os idiomas suportados.
Se tiver conteúdo em vários idiomas, certifique-se de que cria um serviço separado para cada idioma.
Gerir serviço
Quando devo reiniciar meu 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 do ponto de extremidade na página Configurações do usuário.
Eliminei o meu serviço de Pesquisa existente. Como posso corrigir isso?
Resposta: Se você excluir um índice do Azure AI Search, a operação será final e o índice não poderá ser recuperado.
Eliminei o meu índice 'testkb' no meu serviço de pesquisa. Como posso corrigir isso?
Resposta: Caso tenha eliminado o testkb índice no seu serviço de Pesquisa, pode restaurar os dados do último KB publicado. 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 QnA Maker App permitem https://www.qnamaker.ai ou se há alguma restrição de rede específica da organização. Como posso resolver isso?
Resposta: Na seção API do painel Serviço de aplicativo, atualize a configuração CORS para * ou "https://www.qnamaker.ai". Se isto não resolver o problema, verifique se existem restrições específicas da organização.
Quando devo atualizar minhas chaves de ponto final?
Resposta: Atualize suas chaves de ponto de extremidade se suspeitar que elas foram comprometidas.
Posso usar o mesmo recurso do Azure AI Search para bases de dados de conhecimento usando vários idiomas?
Resposta: Para usar vários idiomas e várias bases de conhecimento, o usuário tem que criar um recurso do QnA Maker para cada idioma. Será, assim, criado um serviço de pesquisa do Azure separado por idioma. Misturar diferentes bases de conhecimento de idiomas em um único serviço de pesquisa do Azure resultará em relevância degradada dos resultados.
Como posso alterar o nome do recurso Azure AI Search usado pelo QnA Maker?
Resposta: O nome do recurso Azure AI Search é o nome do recurso QnA Maker com algumas letras aleatórias anexadas no final. Isso dificulta a distinção entre vários recursos de pesquisa para o QnA Maker. Crie um serviço de pesquisa separado (nomeando-o da maneira que você gostaria) e conecte-o ao seu Serviço QnA. As etapas são semelhantes às etapas que você precisa fazer para atualizar uma pesquisa do Azure.
Quando o QnA Maker retorna 'O núcleo de tempo de execução não foi inicializado', como faço para corrigi-lo?
Resposta: O espaço em disco para o serviço de aplicativo pode estar cheio. Passos 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, Ferramentas Avançadas e Ir. Esta ação abre uma nova janela do browser.
Selecione Depurar console e, em seguida , CMD para abrir uma ferramenta de linha de comando.
Navegue até o diretório site/wwwroot/Data/QnAMaker/ .
Remova todas as pastas cujo nome começa com
rd.Não exclua o seguinte:
- Ficheiro KbIdToRankerMappings.txt
- Ficheiro EndpointSettings.jsno
- Pasta EndpointKeys
Inicie o Serviço de aplicativo.
Aceda à sua base de dados de conhecimento para verificar se funciona agora.
Por que meu Application Insights não está funcionando?
Resposta: Por favor, verifique e atualize as etapas abaixo para corrigir o problema:
No Serviço de Aplicativo -> grupo Configurações -> seção Configuração - Configurações do> Aplicativo -> Nome Os parâmetros "UserAppInsightsKey" são configurados corretamente e definidos para a respetiva guia Visão Geral dos insights do aplicativo ("Chave de Instrumentação") Guid.
No Serviço de Aplicativo -> Grupo Configurações -> seção "Informações do Aplicativo" -> Verifique se o App Insights está habilitado e conectado ao respetivo recurso do Application Insights.
Meu Application Insights está habilitado, mas por que ele não está funcionando corretamente?
Resposta: Por favor, siga os passos abaixo:
Copie o valor de '"APPINSIGHTS_INSTRUMENTATIONKEY" name' para o nome 'UserAppInsightsKey' substituindo se houver algum valor já presente lá.
Se a chave 'UserAppInsightsKey' não existir nas configurações do aplicativo, adicione uma nova chave com esse nome e copie o valor.
Salve-o e isso reiniciará automaticamente o serviço do aplicativo. Este processo deve resolver o problema.
Integre 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 dos vários modelos no Azure AI Bot Service. O Serviço de Bot permite o desenvolvimento rápido de bots inteligentes por meio do Microsoft Bot Framework e é executado em um ambiente sem servidor.
Como posso criar um novo bot com o QnA Maker?
Resposta: Siga as instruções nesta documentação para criar seu Bot com o Serviço de Bot do Azure AI.
Como posso usar uma base de dados de conhecimento diferente com um Serviço de Bot de IA do Azure existente?
Resposta: Você precisa ter as seguintes informações sobre sua base 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, conhecido como
host, foi encontrado na página Configurações após a publicação. - Chave de ponto de extremidade publicada da Base de dados de conhecimento - encontrada na página Configurações após a publicação.
Com essas informações, vá para o serviço de aplicativo do seu bot no portal do Azure. Em Configurações -> Configuração - Configurações do> 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 cliente podem compartilhar uma base de dados de conhecimento?
Resposta: Sim, a base de conhecimento pode ser consultada a partir de qualquer número de clientes. Se a resposta da base de dados de conhecimento parecer lenta ou com o tempo limite, considere atualizar a camada de serviço para o serviço de aplicativo associado à base de dados de conhecimento.
Como faço para incorporar o serviço QnA Maker no meu site?
Resposta: Siga estas etapas para incorporar o serviço QnA Maker como um controle de bate-papo da Web em seu site:
Armazenamento de dados
Que dados são armazenados e onde são armazenados?
Resposta:
Ao criar seu serviço QnA Maker, você selecionou uma região do Azure. Suas bases de conhecimento e arquivos de log são armazenados nesta região.