Recursos Azure para O Criador QNA

O Fabricante QnA usa várias fontes Azure, cada uma com um propósito diferente. Compreender como são usados individualmente permite-lhe planear e selecionar o nível de preços correto ou saber quando alterar o seu nível de preços. Compreender como são usados em combinação permite-lhe encontrar e corrigir problemas quando ocorrem.

Planeamento de recursos

Quando desenvolve uma base de conhecimento QnA Maker, na fase do protótipo, é comum ter um único recurso QnA Maker tanto para testes como para produção.

Quando se entra na fase de desenvolvimento do projeto, deve considerar:

  • Quantas línguas o seu sistema de base de conhecimento vai manter?
  • Em quantas regiões precisa da sua base de conhecimentos para estar disponível?
  • Quantos documentos em cada domínio o seu sistema irá conter?

Planeia ter um único recurso QnA Maker que possua todas as bases de conhecimento que tenham a mesma língua, a mesma região e a mesma combinação de domínios sujeitos.

Considerações de nível de preços

Normalmente, há três parâmetros que deve considerar:

  • A produção que precisa do serviço:

    • Selecione o Plano de Aplicações apropriado para o seu serviço de Aplicações com base nas suas necessidades. Pode escalar para cima ou para baixo na App.
    • Isto também deve influenciar a sua seleção Azure Cognitive Search SKU, ver mais detalhes aqui. Além disso, poderá ser necessário ajustar a capacidade de Pesquisa Cognitiva com réplicas.
  • Tamanho e número de bases de conhecimento: Escolha o SKU de pesquisa Azure apropriado para o seu cenário. Normalmente, você decide o número de bases de conhecimento que precisa com base no número de diferentes domínios de assunto. Uma vez que o domínio do assunto (para uma única língua) deve estar numa base de conhecimento.

O seu recurso de serviço Azure Search deve ter sido criado após janeiro de 2019 e não pode estar no nível gratuito (partilhado). Não existe suporte para configurar chaves geridas pelo cliente no portal Azure.

Importante

Pode publicar bases de conhecimento N-1 num determinado nível, onde N é o índice máximo permitido no nível. Verifique também o tamanho máximo e o número de documentos permitidos por nível.

Por exemplo, se o seu nível tiver 15 índices permitidos, pode publicar 14 bases de conhecimento (1 índice por base de conhecimentos publicados). O décimo quinto índice é utilizado para todas as bases de conhecimento para a autoria e teste.

  • Número de documentos como fontes: O SKU gratuito do serviço de gestão QnA Maker limita o número de documentos que pode gerir através do portal e das APIs a 3 (de tamanho de 1 MB cada). O SKU padrão não tem limites para o número de documentos que pode gerir. Veja mais detalhes aqui.

A tabela a seguir dá-lhe algumas diretrizes de alto nível.

Gestão do Fabricante QNA Serviço de Aplicações Azure Cognitive Search Limitações
Experimentação SKU grátis Nível Gratuito Nível Gratuito Publicar até 2 KBs, tamanho de 50 MB
Ambiente dev/Teste SKU Standard Partilhado Básica Publicar até 14 KBs, tamanho de 2 GB
Ambiente de Produção SKU Standard Básica Standard Publicar até 49 KBs, tamanho de 25 GB
QPS-alvo Serviço de Aplicações Azure Cognitive Search
3 S1, 1 Réplica S1, 1 Réplica
50 S3, 10 Réplicas S1, 12 Réplicas
80 S3, 10 Réplicas S3, 12 Réplicas
100 P3V2, 10 Réplicas S3, 12 Réplicas, 3 Divisórias
200 a 250 P3V2, 20 Réplicas S3, 12 Réplicas, 3 Divisórias

Quando alterar um nível de preços

Atualizar Razão
Upgrade Gestão do Fabricante QNA SKU Você quer ter mais pares QnA ou fontes de documento na sua base de conhecimento.
Upgrade Serviço de Aplicações SKU e verificar nível de Pesquisa Cognitiva e criar réplicas de Pesquisa Cognitiva A sua base de conhecimentos precisa de servir mais pedidos da sua aplicação de clientes, como um chat bot.
Upgrade Serviço de Pesquisa Cognitiva Azure Planeia ter muitas bases de conhecimento.

Obtenha as últimas atualizações de tempo de execução atualizando o seu Serviço de Aplicações no portal Azure.

Chaves no Fabricante QnA

O seu serviço QnA Maker trata de dois tipos de chaves: chaves de autoria e teclas de ponto final de consulta utilizadas com o tempo de execução alojado no serviço App.

Utilize estas teclas ao escrutinar os pedidos ao serviço através de APIs.

Gestão de chaves

Nome Localização Objetivo
Chave de autoria/subscrição Portal do Azure Estas chaves são utilizadas para aceder às APIs do serviço de gestão QnA Maker. Estas APIs permitem-lhe editar as perguntas e respostas na sua base de conhecimento, e publicar a sua base de conhecimentos. Estas teclas são criadas quando cria um novo serviço QnA Maker.

Encontre estas chaves no recurso Serviços Cognitivos na página Keys e Endpoint.
Chave de ponto final de consulta Portal do Criador de FAQ Estas teclas são usadas para consultar o ponto final da base de conhecimento publicado para obter uma resposta para uma questão do utilizador. Normalmente, utiliza este ponto final de consulta no seu chat bot ou no código de aplicação do cliente que se conecta ao serviço QnA Maker. Estas chaves são criadas quando publica a sua base de conhecimento qnA Maker.

Encontre estas chaves na página de definições de Serviço. Encontre esta página a partir do menu do utilizador no canto superior direito da página no menu suspenso.

Encontre chaves de autoria no portal Azure

Pode visualizar e redefinir as suas teclas de autoria a partir do portal Azure, onde criou o recurso QnA Maker.

  1. Vá ao recurso QnA Maker no portal Azure e selecione o recurso que tem o tipo de Serviços Cognitivos:

    Lista de recursos do Fabricante QnA

  2. Ir para Chaves e Endpoint:

    QnA Maker geriu (Pré-visualização) chave de subscrição

Encontre chaves de ponto final de consulta no portal QnA Maker

O ponto final está na mesma região que o recurso porque as teclas de ponto final são usadas para fazer uma chamada para a base de conhecimento.

As teclas de ponto final podem ser geridas a partir do portal QnA Maker.

  1. Inscreva-se no portal QnA Maker,vá ao seu perfil e, em seguida, selecione as definições de Serviço:

    Chave de ponto final

  2. Ver ou redefinir as suas chaves:

    Gestor chave de ponto final

    Nota

    Refresque as chaves se acha que foram comprometidas. Isto pode requerer alterações correspondentes à aplicação do seu cliente ou código bot.

Região de serviços de gestão

O serviço de gestão da QnA Maker é utilizado apenas para o portal QnA Maker e para o processamento inicial de dados. Este serviço está disponível apenas na região oeste dos EUA. Nenhum dado do cliente é armazenado neste serviço dos EUA.

Considerações de nomeação de recursos

O nome de recurso para o recurso QnA Maker, qna-westus-f0-b como, também é usado para nomear os outros recursos.

O portal Azure cria uma janela que permite criar um recurso QnA Maker e selecionar os níveis de preços para os outros recursos.

Screenshot do portal Azure para a criação de recursos da QnA Maker

Após a criação dos recursos, têm o mesmo nome, com exceção do recurso opcional Application Insights, que publica caracteres para o nome.

Screenshot da listagem de recursos do portal Azure

Dica

Crie um novo grupo de recursos quando criar um recurso QnA Maker. Isso permite-lhe ver todos os recursos associados ao recurso QnA Maker ao pesquisar por grupo de recursos.

Dica

Utilize uma convenção de nomeação para indicar os níveis de preços dentro do nome do recurso ou do grupo de recursos. Quando recebe erros de criar uma nova base de conhecimento, ou de adicionar novos documentos, o limite de preços de Pesquisa Cognitiva é uma questão comum.

Finalidades de recursos

Cada recurso Azure criado com a QnA Maker tem um propósito específico:

  • Recurso do Fabricante QnA
  • Recurso de Pesquisa Cognitiva
  • Serviço de Aplicações
  • Serviço de Plano de Aplicações
  • Serviço de Insights de Aplicações

Recurso do Fabricante QnA

O recurso QnA Maker fornece acesso às APIs de autoria e publicação, bem como à camada de segunda classificação baseada em linguagem natural (NLP) (ranker #2) dos pares QnA em tempo de execução.

O segundo ranking aplica filtros inteligentes que podem incluir metadados e pedidos de seguimento.

Definições de configuração de recursos do QnA Maker

Quando cria uma nova base de conhecimento no portal QnA Maker,a definição de idioma é a única definição que é aplicada ao nível dos recursos. Selecione o idioma quando criar a primeira base de conhecimento para o recurso.

Recurso de Pesquisa Cognitiva

O recurso de Pesquisa Cognitiva é utilizado para:

  • Armazenar os pares QnA
  • Fornecer o ranking inicial (ranking #1) dos pares QnA em tempo de execução

Utilização de índices

O recurso mantém um índice para funcionar como o índice de teste e os índices restantes correlacionam-se com uma base de conhecimento publicada cada.

Um recurso com preços a preços de 15 índices, terá 14 bases de conhecimento publicadas, e um índice é usado para testar todas as bases de conhecimento. Este índice de ensaio é dividido pela base de conhecimento de modo a que uma consulta utilizando o painel de ensaio interativo utilize o índice de teste, mas apenas os resultados de retorno da partição específica associada à base de conhecimento específica.

Uso da linguagem

A primeira base de conhecimento criada no recurso QnA Maker é usada para determinar o conjunto de linguagens únicas para o recurso De Pesquisa Cognitiva e todos os seus índices. Só pode ter um conjunto de idiomas para um serviço QnA Maker.

Usando um único serviço de Pesquisa Cognitiva

Se criar um serviço QnA e as suas dependências (como procurar) através do portal, é criado um serviço de Pesquisa para si e ligado ao serviço QnA Maker. Após a criação destes recursos, pode atualizar a definição de Serviço de Aplicações para utilizar um serviço de Pesquisa anteriormente existente e remover o que acabou de criar.

Aprenda a configurar o QnA Maker para usar um recurso de Serviço Cognitivo diferente daquele criado como parte do processo de criação de recursos do QnA Maker.

Serviço de aplicações e plano de serviço de aplicações

O serviço App é utilizado pela aplicação do seu cliente para aceder às bases de conhecimento publicadas através do ponto final de tempo de execução.

Para consultar a base de conhecimentos publicada, todas as bases de conhecimento publicadas utilizam o mesmo ponto final URL, mas especificam o ID da base de conhecimento dentro da rota.

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application Insights

Application Insights é usado para recolher registos de chat e telemetria. Reveja as consultas comuns de Kusto para obter informações sobre o seu serviço.

Partilhar serviços com a QnA Maker

A QnA Maker cria vários recursos Azure. Para reduzir a gestão e beneficiar da partilha de custos, use a seguinte tabela para entender o que pode e não pode partilhar:

Serviço Partilhar Razão
Serviços Cognitivos X Não é possível por design
Plano do Serviço de Aplicações Espaço fixo em disco atribuído para um plano de Serviço de Aplicações. Se outras aplicações que partilham o mesmo plano de Serviço de Aplicações utilizarem espaço significativo em disco, a instância do Serviço de Aplicações QnAMaker irá encontrar problemas.
Serviço de Aplicações X Não é possível por design
Application Insights Pode ser partilhado
Serviço de pesquisa 1. testkb é um nome reservado para o serviço QnAMaker; não pode ser utilizado por outros.
2. O mapa synonym com o nome synonym-map está reservado para o serviço QnAMaker.
3. O número de bases de conhecimento publicadas é limitado pelo nível de serviço de pesquisa. Se houver índices gratuitos disponíveis, outros serviços podem usá-los.

Passos seguintes