Início Rápido: Adicionar perguntas e respostas com o portal do QnA MakerQuickstart: Add questions and answer with QnA Maker portal

Após uma base de dados de conhecimento ser criada, adicione conjuntos de perguntas e respostas com metadados para que os usuários possam encontrar a resposta certa para sua pergunta.Once a knowledge base is created, add question and answer sets with metadata so your users can find the right answer to their question.

A resposta certa é apenas uma, mas pode haver muitas maneiras de um cliente fazer a pergunta que leva a essa única resposta.The right answer is a single answer but there can be many ways a customer could ask the question that leads to that single answer.

Por exemplo, as perguntas na tabela a seguir são sobre os limites de serviço do Azure, mas cada uma tem a ver com um serviço do Azure diferente.For example, the questions in the following table are about Azure service limits, but each has to do with a different Azure service.

DefinirSet PerguntasQuestions RespostaAnswer MetadadosMetadata
Nº 1#1 How large a knowledge base can I create?

What is the max size of a knowledge base?

How many GB of data can a knowledge base hold?
The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](https://docs.microsoft.com/azure/cognitive-services/qnamaker/tutorials/choosing-capacity-qnamaker-deployment) for more details. service=qna_maker
link_in_answer=true
Nº 2#2 How many knowledge bases can I have for my QnA Maker service?

I selected a Azure Cognitive Search tier that holds 15 knowledge bases, but I can only create 14 - what is going on?

What is the connection between the number of knowledge bases in my QnA Maker service and the Azure Cognitive Search service size?
Each knowledge base uses 1 index, and all the knowledge bases share a test index. You can have N-1 knowledge bases where N is the number of indexes your Azure Cognitive Search tier supports. service=search
link_in_answer=false

Após os metadados serem adicionados a um conjunto de perguntas e respostas, o aplicativo cliente pode:Once metadata is added to a question-and-answer set, the client application can:

  • Solicitar respostas que correspondam apenas a determinados metadados.Request answers that only match certain metadata.
  • Receber todas as respostas, mas pós-processá-las dependendo dos metadados de cada resposta.Receive all answers but post-process the answers depending on the metadata for each answer.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

PrerequisitesPrerequisites

  • Um serviço do QnA MakerA QnA Maker service
  • Uma base de dados de conhecimento criada nesse serviço do QnA MakerA Knowledge base created in that QnA Maker service

Ambos foram criados no primeiro início rápido.Both were created in the first quickstart.

Entrar no portal do QnA MakerSign in to the QnA Maker portal

  1. Entre no portal do QnA Maker.Sign in to the QnA Maker portal.

  2. Selecione sua base de dados de conhecimento existente.Select your existing knowledge base. Se você não tiver uma base de dados de conhecimento, volte para o início rápido anterior e conclua as etapas para criar sua base de dados de conhecimento.If you don't have a knowledge base, return to the previous quickstart and finish the steps to create your knowledge base.

Adicionar outras perguntas com elaboração alternativaAdd additional alternatively-phrased questions

A base de dados de conhecimento atual, do início rápido anterior, tem os conjuntos de perguntas e respostas de solução de problemas do QnA Maker.The current knowledge base, from the previous quickstart, has the QnA Maker troubleshooting question and answer sets. Esses conjuntos foram criados quando a URL foi adicionada à base de dados de conhecimento durante o processo de criação.These sets were created when the URL was added to the knowledge base during the creation process.

Quando essa URL foi importada, apenas uma pergunta com uma resposta foi criada.When this URL was imported, only one question with one answer was created.

Neste procedimento, adicione outras perguntas.In this procedure, add additional questions.

  1. Na página Editar, use a caixa de texto de pesquisa acima dos conjuntos de perguntas e respostas para encontrar a pergunta How large a knowledge base can I create?From the Edit page, use the search textbox above the question and answer sets, to find the question How large a knowledge base can I create?

  2. Na coluna Pergunta, selecione + Adicionar frase alternativa e adicione cada frase alternativa fornecida na tabela a seguir.In the Question column, select + Add alternative phrasing then add each new phrasing, provided in the following table.

    Frase alternativaAlternative phrasing
    What is the max size of a knowledge base?
    How many GB of data can a knowledge base hold?
  3. Selecione Salvar e treinar para treinar a base de dados de conhecimento novamente.Select Save and train to retrain the knowledge base.

  4. Selecione Testar e, em seguida, insira uma pergunta que seja semelhante a uma das novas frases alternativas, mas não exatamente igual:Select Test, then enter a question that is close to one of the new alternative phrasings but isn't exactly the same wording:

    What GB size can a knowledge base be?

    A resposta correta é retornada no formato de markdown: The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](https://docs.microsoft.com/azure/cognitive-services/qnamaker/tutorials/choosing-capacity-qnamaker-deployment) for more details.The correct answer is returned in markdown format: The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](https://docs.microsoft.com/azure/cognitive-services/qnamaker/tutorials/choosing-capacity-qnamaker-deployment) for more details.

    Se selecionar Inspecionar sob a resposta retornada, você poderá ver mais respostas que correspondem à pergunta, mas não com o mesmo nível elevado de confiança.If you select Inspect under the returned answer, you can see more answers met the question but not with the same high level of confidence.

    Não adicione todas as combinações possíveis de frases alternativas.Do not add every possible combination of alternative phrasing. Acione o aprendizado ativo do QnA Maker, que encontra as frases alternativas que mais ajudarão sua base de dados de conhecimento a atender às necessidades de seus usuários.Turn on QnA Maker's active learning, this finds the alternative phrasings that will best help your knowledge base meet your users' needs.

  5. Selecione Testar novamente para fechar a janela de teste.Select Test again to close the test window.

Adicionar metadados para filtrar as respostasAdd metadata to filter the answers

Adicionar metadados a um conjunto de perguntas e respostas permite que o aplicativo cliente solicite respostas filtradas.Adding metadata to a question and answer set allows your client application to request filtered answers. Esse filtro é aplicado antes que o primeiro e o segundo classificadores sejam aplicados.This filter is applied before the first and second rankers are applied.

  1. Adicione o segundo conjunto de perguntas e respostas, sem os metadados, da primeira tabela neste início rápido e continue com as etapas a seguir.Add the second question and answer set, without the metadata, from the first table in this quickstart, then continue with the following steps.

  2. Selecione Opções de exibição e, em seguida, selecione Mostrar metadados.Select View options, then select Show metadata.

  3. Para o conjunto de perguntas e respostas que você acabou de adicionar, selecione Adicionar marcas de metadados e, em seguida, adicione o nome service e o valor de search, service:search.For the question and answer set you just added, select Add metadata tags, then add name of service and value of search, service:search.

  4. Adicione outras marcas de metadados com o nome link_in_answer e o valor de false, link_in_answer:false.Add another metadata tags with name of link_in_answer and value of false, link_in_answer:false.

  5. Pesquise a primeira resposta na tabela, How large a knowledge base can I create?.Search for the first answer in the table, How large a knowledge base can I create?.

  6. Adicione pares de metadados para as mesmas duas marcas de metadados:Add metadata pairs for the same two metadata tags:

    link_in_answer : truelink_in_answer : true
    server: qna_makerserver: qna_maker

    Agora, você tem duas perguntas com as mesmas marcas de metadados com valores diferentes.You now have two questions with the same metadata tags with different values.

  7. Selecione Salvar e treinar para treinar a base de dados de conhecimento novamente.Select Save and train to retrain the knowledge base.

  8. Selecione Publicar no menu superior para ir para a página de publicação.Select Publish in the top menu to go to the publish page.

  9. Selecione o botão Publicar para publicar a base de dados de conhecimento atual em um ponto de extremidade passível de consulta.Select the Publish button to publish the current knowledge base to a queryable endpoint.

  10. Após a base de dados de conhecimento ser publicada, selecione a guia Ondulação para ver um exemplo de comando cURL usado para gerar uma resposta da base de dados de conhecimento.After the knowledge base is published, select the Curl tab to see an example cURL command used to generate an answer from the knowledge base.

  11. Copie o comando para um bloco de notas ou outro ambiente editável para que você possa editá-lo.Copy the command to a note pad or other editable environment so you can edit the command. Edite para inserir seu próprio nome de recurso, ID da base de dados de conhecimento e chave do ponto de extremidade:Edit for your own resource name, knowledge base ID and endpoint key:

    SubstituaReplace
    your-resource-name
    your-knowledge-base-id
    your-endpoint-key
    curl -X POST https://your-resource-name.azurewebsites.net/qnamaker/knowledgebases/your-knowledge-base-id/generateAnswer -H "Authorization: EndpointKey your-endpoint-key" -H "Content-type: application/json" -d "{'top':30, 'question':'size','strictFilters': [{'name':'service','value':'qna_maker'}]}"
    

    Observe que a pergunta é apenas uma única palavra, size, que pode retornar qualquer conjunto de perguntas e respostas.Notice the question is just a single word, size, which can return either question and answer set. A matriz strictFilters instrui a resposta a reduzir para apenas as respostas qna_maker.The strictFilters array tells the response to reduce to just the qna_maker answers.

    Dica

    Adicione a propriedade debug para ver informações de depuração referentes à solicitação e à resposta.Add debug property to see debug information for the request and response. Exemplo: { 'question':'this is my question', 'top':30, 'strictFilters': [{'name':'service','value':'qna_maker'}], 'Debug': { 'Enable': true}}Example: { 'question':'this is my question', 'top':30, 'strictFilters': [{'name':'service','value':'qna_maker'}],'Debug' : { 'Enable' : true}}

  12. A resposta inclui apenas a resposta que atende aos critérios de filtro.The response includes only the answer that meets the filter criteria.

    A seguinte resposta cURL foi formatada para facilitar a leitura:The following cURL response has been formatted for readability:

    {
        "answers": [
            {
                "questions": [
                    "How large a knowledge base can I create?",
                    "What is the max size of a knowledge base?",
                    "How many GB of data can a knowledge base hold?"
                ],
                "answer": "The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Read [here](https://docs.microsoft.com/azure/cognitive-services/qnamaker/tutorials/choosing-capacity-qnamaker-deployment)for more details.",
                "score": 68.76,
                "id": 3,
                "source": "https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting",
                "metadata": [
                    {
                        "name": "link_in_answer",
                        "value": "true"
                    },
                    {
                        "name": "service",
                        "value": "qna_maker"
                    }
                ],
                "context": {
                    "isContextOnly": false,
                    "prompts": []
                }
            }
        ],
        "debugInfo": null
    }
    

    Se houver um conjunto de perguntas e respostas que não correspondeu ao termo de pesquisa, mas que correspondeu ao filtro, ele não será retornado.If there is a question and answer set that didn't meet the search term but did meet the filter, it would not be returned. Em vez disso, a resposta geral No good match found in KB. será retornada.Instead, the general answer No good match found in KB. is returned.

    Certifique-se de manter seus pares de nome e valor de metadados dentro dos limites necessários.Make sure to keep your metadata name and value pairs within the required limits.

Limpar os recursosClean up resources

Se quiser limpar e remover uma assinatura dos Serviços Cognitivos, você poderá excluir o recurso ou grupo de recursos.If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Excluir o grupo de recursos também exclui todos os recursos associados a ele.Deleting the resource group also deletes any other resources associated with it.

Próximas etapasNext steps