Solução de problemas para QnA MakerTroubleshooting for QnA Maker

A lista organizada das perguntas mais frequentes sobre o serviço de QnA Maker ajudará você a adotar o serviço mais rapidamente e com melhores resultados.The curated list of the most frequently asked questions regarding the QnA Maker service will help you adopt the service faster and with better results.

Como obter o ponto de extremidade de serviço QnAMakerHow to get the QnAMaker service endpoint

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 UserVoice.QnAMaker service endpoint is useful for debugging purposes when you contact QnAMaker Support or UserVoice. O ponto de extremidade é uma URL neste formato: https://your-resource-name.azurewebsites.net.The endpoint is a URL in this form: https://your-resource-name.azurewebsites.net.

  1. Acesse o serviço do QnAMaker (grupo de recursos) no portal do AzureGo to your QnAMaker service (resource group) in the Azure portal

    Grupo de recursos do Azure do QnAMaker no portal do Azure

  2. Selecione o serviço de aplicativo associado ao recurso de QnA Maker.Select the App Service associated with the QnA Maker resource. Normalmente, os nomes são os mesmos.Typically, the names are the same.

    Selecione o Serviço de Aplicativo do QnAMaker

  3. A URL do ponto de extremidade está disponível na seção visão geralThe endpoint URL is available in the Overview section

    Ponto de extremidade QnAMaker

Usar o bot de ajuda no portal de QnA MakerUse the Help bot in the QnA Maker portal

QnA Maker fornece um bot de ajuda dentro do portal de QnA Maker para ajudá-lo.QnA Maker provides a Help bot within the QnA Maker portal to help you. O bot da ajuda está disponível em todas as páginas da Web.The help bot is available on every web page. O bot usa QnA Maker para fornecer respostas e fornece o C# projeto de código do bot Framework ao bot para que você possa entrar em funcionamento rapidamente com seu próprio bot de resposta.The bot uses QnA Maker to provide answers and provides the C# Bot Framework code project to the bot so you can quickly get up and running with your own answer bot.

! [QnA Maker fornece um bot * * Help * * no portal QnA Maker para ajudá-lo.] (./media/qnamaker-faq/use-qna-maker-help-bot-to-learn-qna-maker-service.png)

Gerenciar a base de conhecimentoManage the knowledge base

Eu apaguei acidentalmente uma parte do meu QnA Maker, o que devo fazer?I accidentally deleted a part of my QnA Maker, what should I do?

Não exclua nenhum dos serviços do Azure criados junto com o QnA Maker recurso, como pesquisa ou aplicativo Web.Do not delete any of the Azure services created along with the QnA Maker resource such as Search or Web App. Eles são necessários para que QnA Maker funcionem, se você excluir um, QnA Maker deixará de funcionar corretamente.These are necessary for QnA Maker to work, if you delete one, QnA Maker will stop working correctly.

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.All deletes are permanent, including question and answer pairs, files, URLs, custom questions and answers, knowledge bases, or Azure resources. Certifique-se de exportar sua base de conhecimento da página Configurações antes de excluir qualquer parte de sua base de conhecimento.Make sure you export your knowledge base from the Settings page before deleting any part of your knowledge base.

Por que minhas URLs/arquivos não estão extraindo pares de pergunta-resposta?Why is my URL(s)/file(s) not extracting question-answer pairs?

É possível que o QnA Maker não possa extrair automaticamente algum conteúdo de QnA (perguntas e respostas) de URLs de perguntas frequentes válidas.It's possible that QnA Maker can't auto-extract some question-and-answer (QnA) content from valid FAQ URLs. Nesses casos, você pode colar o conteúdo de QnA em um arquivo .txt e verificar se a ferramenta pode ingeri-lo.In such cases, you can paste the QnA content in a .txt file and see if the tool can ingest it. Como alternativa, você pode adicionar conteúdo de modo editorial à sua base de dados de conhecimento no Portal do QnA Maker.Alternately, you can editorially add content to your knowledge base through the QnA Maker portal.

Qual o tamanho da base de dados de conhecimento que posso criar?How large a knowledge base can I create?

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.The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Leia este texto para obter mais detalhes.Read here for more details.

Por que eu não vejo nada na lista suspensa quando tento criar uma nova base de dados de conhecimento?Why can't I see anything in the drop-down when I try to create a new knowledge base?

Você ainda não criou serviços de QnA Maker no Azure.You haven't created any QnA Maker services in Azure yet. Leia este artigo para saber como fazer isso.Read here to learn how to do that.

Como posso compartilhar uma base de dados de conhecimento com outras pessoas?How do I share a knowledge base with others?

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.Sharing works at the level of a QnA Maker service, that is, all knowledge bases in the service will be shared. Leia este texto sobre como colaborar em uma base de dados de conhecimento.Read here how to collaborate on a knowledge base.

É 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?Can you share a knowledge base with a contributor that is not in the same AAD tenant, to modify a knowledge base?

O compartilhamento é baseado no RBAC (controle de acesso baseado em função) do Azure.Sharing is based on Azure role-based access control (RBAC). Se pode compartilhar qualquer recurso do Azure com outro usuário, você também pode compartilhar o QnA Maker.If you can share any resource in Azure with another user, you can also share QnA Maker.

Digamos que você tenha um Plano do Serviço de Aplicativo com 5 bases de dados de conhecimento do QnAMaker.If you have an App Service Plan with 5 QnAMaker knowledge bases. É possível atribuir direitos de leitura/gravação para 5 usuários diferentes para que cada uma deles possa acessar apenas uma base de dados de conhecimento do QnAMaker?Can you assign read/write rights to 5 different users so each of them can access only 1 QnAMaker knowledge base?

Você pode compartilhar todo o serviço do QnAMaker, não bases de dados de conhecimento individuais.You can share an entire QnAMaker service, not individual knowledge bases.

Como alterar a mensagem padrão quando nenhuma correspondência boa for encontrada?How can I change the default message when no good match is found?

A mensagem padrão faz parte das configurações em seu serviço de Aplicativo.The default message is part of the settings in your App service.

  • Vá até o recurso do seu Serviço de Aplicativo no portal do AzureGo to your App service resource in the Azure portal

qnamaker appservice

  • Clique na opção ConfiguraçõesClick on the Settings option

qnamaker appservice settings

  • Alterar o valor da configuração DefaultAnswerChange the value of the DefaultAnswer setting
  • Reinicie o serviço AplicativoRestart your App service

qnamaker appservice restart

Confira Locais da fonte de dados para obter mais informações.See Data source locations for more information.

As atualizações que eu fiz em minha base de dados de conhecimento não são refletidas na publicação.The updates that I made to my knowledge base are not reflected on publish. Por que não?Why not?

Todas as operações de edição, seja na atualização, teste ou configuração de uma tabela, precisam ser salvas antes de serem publicadas.Every edit operation, whether in a table update, test, or setting, needs to be saved before it can be published. Certifique-se de clicar no botão salvar e treinar após cada operação de edição.Be sure to click the Save and train button after every edit operation.

A base de dados de conhecimento oferece suporte a dados avançados ou multimídia?Does the knowledge base support rich data or multimedia?

A base de dados de conhecimento dá suporte ao Markdown.The knowledge base supports Markdown. No entanto, a extração automática das URLs limitou a capacidade de conversão de HTML para Markdown.However, the auto-extraction from URLs has limited HTML-to-Markdown conversion capability. Se quiser usar o Markdown completo, você poderá modificar seu conteúdo diretamente na tabela ou fazer o upload de uma base de dados de conhecimento com o conteúdo avançado.If you want to use full-fledged Markdown, you can modify your content directly in the table, or upload a knowledge base with the rich content.

Não há suporte para multimídia, como imagens e vídeos, no momento.Multimedia, such as images and videos, is not supported at this time.

O QnA Maker dá suporte para idiomas além do inglês?Does QnA Maker support non-English languages?

Veja mais detalhes sobre os idiomas com suporte.See more details about supported languages.

Se você tiver conteúdo de vários idiomas, crie um serviço separado para cada idioma.If you have content from multiple languages, be sure to create a separate service for each language.

Gerenciar serviçoManage service

Quando devo reiniciar o serviço de aplicativo?When should I restart my app service?

Quando o ícone de cuidado está ao lado do valor para a base de dados de Conhecimento na versão de atualização do serviço de aplicativo a chaves de ponto de extremidade de tabela na configurações do usuário página.Refresh your app service when the caution icon is next to the version value for the knowledge base in the Endpoint keys table on the User Settings page.

Excluí meu serviço de pesquisa existente.I deleted my existing Search service. Como posso corrigir isso?How can I fix this?

Se você excluir um índice de Pesquisa Cognitiva do Azure, a operação será final e o índice não poderá ser recuperado.If you delete an Azure Cognitive Search index, the operation is final and the index cannot be recovered.

Excluí meu índice testkb no meu serviço de pesquisa.I deleted my testkb index in my Search service. Como posso corrigir isso?How can I fix this?

Seus dados antigos não podem ser recuperados.Your old data can't be recovered. Crie um novo recurso QnA Maker e crie sua base de dados de conhecimento novamente.Create a new QnA Maker resource and create your knowledge base again.

Quando devo atualizar minhas chaves de ponto de extremidade?When should I refresh my endpoint keys?

Atualize suas chaves de ponto de extremidade se suspeitar que elas foram comprometidas.Refresh your endpoint keys if you suspect that they have been compromised.

Posso usar o mesmo recurso de Pesquisa Cognitiva do Azure para bases de dados de conhecimento usando vários idiomas?Can I use the same Azure Cognitive Search resource for knowledge bases using multiple languages?

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.To use multiple language and multiple knowledge bases, the user has to create an QnA Maker resource for each language. Isso criará um serviço do Azure Search separado por idioma.This will create a separate Azure search service per language. 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.Mixing different language knowledge bases in a single Azure search service will result in degraded relevance of results.

Como posso alterar o nome do recurso de Pesquisa Cognitiva do Azure usado pelo QnA Maker?How can I change the name of the Azure Cognitive Search resource used by QnA Maker?

O nome do recurso de Pesquisa Cognitiva do Azure é o nome do recurso de QnA Maker com algumas letras aleatórias anexadas no final.The name of the Azure Cognitive Search resource is the QnA Maker resource name with some random letters appended at the end. Isso torna difícil distinguir entre vários recursos de pesquisa do QnA Maker.This makes it hard to distinguish between multiple Search resources for QnA Maker. Crie um serviço de pesquisa separado (nomeando-o como você gostaria) e conecte-o ao serviço QnA.Create a separate search service (naming it the way you would like to) and connect it to your QnA Service. As etapas são semelhantes às etapas que você precisa fazer para atualizar uma pesquisa do Azure.The steps are similar to the steps you need to do to upgrade an Azure search.

Quando QnA Maker retorna Runtime core is not initialized, como corrigi-lo?When QnA Maker returns Runtime core is not initialized, how do I fix it?

O espaço em disco para o serviço de aplicativo pode estar cheio.The disk space for your app service might be full. Etapas para corrigir o espaço em disco:Steps to fix your disk space:

  1. Na portal do Azure, selecione o serviço de aplicativo do QnA Maker e interrompa o serviço.In the Azure portal, select your QnA Maker's App service, then stop the service.

  2. Enquanto ainda estiver no serviço de aplicativo, selecione ferramentas de desenvolvimento, depois ferramentas avançadase, em seguida, .While still on the App service, select Development Tools, then Advanced Tools, then Go. Isso abre uma nova janela do navegador.This opens a new browser window.

  3. Selecione console de depuraçãoe, em seguida, cmd para abrir uma ferramenta de linha de comando.Select Debug console, then CMD to open a command line tool.

  4. Navegue até o diretório site/wwwroot/data/QnAMaker/ .Navigate to the site/wwwroot/Data/QnAMaker/ directory.

  5. Remova todas as pastas cujo nome começa com rd.Remove all the folders whose name begins with rd.

    Não exclua o seguinte:Do not delete the following:

    • Arquivo KbIdToRankerMappings. txtKbIdToRankerMappings.txt file
    • Arquivo EndpointSettings. JSONEndpointSettings.json file
    • Pasta EndpointKeysEndpointKeys folder
  6. Inicie o serviço de aplicativo.Start the App service.

  7. Acesse sua base de dados de conhecimento para verificar se ela funciona agora.Access your knowledge base to verify it works now.

Integrar com outros serviços, incluindo BotsIntegrate with other services including Bots

Preciso usar o Bot Framework para usar o QnA Maker?Do I need to use Bot Framework in order to use QnA Maker?

Não, você não precisa usar o bot Framework com QnA Maker.No, you do not need to use the Bot Framework with QnA Maker. No entanto, QnA Maker é oferecida como um dos vários modelos no serviço de bot do Azure.However, QnA Maker is offered as one of several templates in Azure Bot Service. 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.Bot Service enables rapid intelligent bot development through Microsoft Bot Framework, and it runs in a server-less environment.

Como posso criar um novo bot com QnA Maker?How can I create a new bot with QnA Maker?

Siga as instruções nesta documentação para criar seu Bot com Serviço de Bot do Azure.Follow the instructions in this documentation to create your Bot with Azure Bot Service.

Como fazer usar uma base de dados de conhecimento diferente com um serviço de bot do Azure existente?How do I use a different knowledge base with an existing Azure bot service?

Você precisa ter as seguintes informações sobre sua base de dados de conhecimento:You need to have the following information about your knowledge base:

  • ID da base de dados de conhecimento.Knowledge base ID.
  • Nome de subdomínio personalizado do ponto de extremidade publicado da base de dados de conhecimento, conhecido como host, encontrado na página de configurações após a publicação.Knowledge base's published endpoint custom subdomain name, known as host, found on Settings page after you publish.
  • Chave de ponto de extremidade publicada da base de dados de conhecimento-encontrada na página de configurações após a publicação.Knowledge base's published endpoint key - found on Settings page after you publish.

Com essas informações, vá para o serviço de aplicativo do bot no portal do Azure.With this information, go to your bot's app service in the Azure portal. Em configurações-> configuração – > configurações do aplicativo, altere esses valores.Under Settings -> Configuration -> Application settings, change those values.

A chave do ponto de extremidade da base de dados de conhecimento é rotulada QnAAuthkey no serviço ABS.The knowledge base's endpoint key is labeled QnAAuthkey in the ABS service.

Dois ou mais aplicativos cliente podem compartilhar uma base de dados de conhecimento?Can two or more client applications share a knowledge base?

Sim, a base de dados de conhecimento pode ser consultada de qualquer número de clientes.Yes, the knowledge base can be queried from any number of clients. Se a resposta da base de dados de conhecimento parecer ser lenta ou atingir o tempo limite, considere atualizar a camada de serviço para o serviço de aplicativo associado à base de dados de conhecimento.If the response from the knowledge base appears to be slow or time out, consider upgrading the service tier for the app service associated with the knowledge base.

Como posso inserir o serviço QnA Maker no meu site?How do I embed the QnA Maker service in my website?

Execute as etapas para inserir o serviço QnA Maker como um controle de webchat em seu site:Follow these steps to embed the QnA Maker service as a web-chat control in your website:

  1. Crie seu bot de perguntas frequentes seguindo as instruções aqui.Create your FAQ bot by following the instructions here.
  2. Habilite o chat da Web executando estas etapasEnable the web chat by following the steps here

Armazenamento de dadosData storage

Quais dados são armazenados e onde ele é armazenado?What data is stored and where is it stored?

Quando você cria seu serviço QnA Maker, você selecionou uma região do Azure.When you create your QnA Maker service, you selected an Azure region. Suas bases de conhecimento e arquivos de log são armazenados nessa região.Your knowledge bases and log files are stored in this region.