Recursos do Azure para QnA Maker
O QnA Maker usa várias fontes do Azure, cada uma com uma finalidade diferente. Entender como eles são usados individualmente permite que você planeje e selecione o tipo de preço correto ou saiba quando alterar o tipo de preço. Entender como eles são usados em combinação permite localizar e corrigir problemas quando eles ocorrem.
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 à pergunta, consulte o Guia de migração.
Planejamento de recursos
Ao desenvolver pela primeira vez uma base de dados de conhecimento do QnA Maker, na fase de protótipo, é comum ter um só recurso do QnA Maker para teste e produção.
Ao passar para a fase de desenvolvimento do projeto, você deve considerar:
- Quantos idiomas seu sistema de base de dados de conhecimento manterá?
- De quantas regiões você precisa que sua base de dados de conhecimento esteja disponível?
- Quantos documentos em cada domínio seu sistema manterá?
Planeje que um só recurso do QnA Maker contenha todas as bases de dados de conhecimento que têm o mesmo idioma, a mesma região e a mesma combinação de domínio de assunto.
Considerações sobre o tipo de preço
Normalmente, há três parâmetros que você precisa considerar:
A taxa de transferência que você precisa do serviço:
- selecione o Plano de aplicativo apropriado para o serviço de aplicativo com base em suas necessidades. Você pode escalar verticalmente ou reduzir verticalmente o Aplicativo.
- Isso também deve influenciar a seleção da SKU do Azure Cognitive Search, veja mais detalhes aqui. Além disso, talvez seja necessário ajustar a capacidade do Cognitive Search com réplicas.
Tamanho e o número de bases de dados de conhecimento: escolha a SKU de pesquisa do Azure apropriada para seu cenário. Normalmente, você decide o número de bases de dados de conhecimento de que precisa com base no número de domínios de assunto diferentes. Um domínio de assunto (para um só idioma) deve estar em uma base de dados de conhecimento.
O recurso de serviço Azure Search precisa ter sido criado após janeiro de 2019 e não pode estar na camada gratuita (compartilhada). Não há suporte para configurar chaves gerenciadas pelo cliente no portal do Azure.
Importante
Você pode publicar as bases de dados de conhecimento N-1 em uma camada específica, onde N representa os índices máximos permitidos na camada. Verifique também o tamanho máximo e o número de documentos permitidas por camada.
Por exemplo, se a camada tiver 15 índices permitidos, você poderá publicar 14 bases de dados de conhecimento (um índice por base de dados de conhecimento publicada). O décimo quinto índice é usado para todas as bases de dados de conhecimento para criação e teste.
- Número de documentos como fontes: a SKU gratuita do serviço de gerenciamento do QnA Maker limita o número de documentos que você pode gerenciar por meio do portal e as APIs a três (cada uma com 1 MB de tamanho). O padrão de SKU não tem limites para o número de documentos que você pode gerenciar. Veja mais detalhes aqui.
A tabela a seguir fornece algumas diretrizes de alto nível.
| Gerenciamento do QnA Maker | Serviço de Aplicativo | Pesquisa de IA do Azure | Limitações | |
|---|---|---|---|---|
| Experimentação | SKU gratuito | Camada Gratuita | Camada Gratuita | Publicar até 2 KB/s, tamanho de 50 MB |
| Ambiente de Desenvolvimento/Teste | SKU Standard | Compartilhado | Basic | Publicar até 14 KBs, com tamanho de 2 GB |
| Ambiente de Produção | SKU Standard | Basic | Standard | Publicar até 49 KBs, tamanho de 25 GB |
Configurações recomendadas
| QPS de destino | Serviço de Aplicativo | Pesquisa de IA do Azure |
|---|---|---|
| 3 | S1, uma réplica | S1, uma 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 partições |
| 200 a 250 | P3V2, 20 réplicas | S3, 12 réplicas, 3 partições |
Quando alterar um tipo de preço
| Atualizar | Motivo |
|---|---|
| Atualizar a SKU de gerenciamento do QnA Maker | Você quer ter mais pares de perguntas e respostas ou fontes de documentos na sua base de dados de conhecimento. |
| Atualizar a SKU do Serviço de Aplicativo e verificar a camada da Pesquisa de IA do Azure e criar réplicas do Cognitive Search | Sua base de dados de conhecimento precisa atender a mais solicitações do aplicativo cliente, como um chatbot. |
| Atualizar o serviço Pesquisa de IA do Azure | Você planeja ter muitas bases de dados de conhecimento. |
Obtenha as atualizações do runtime mais recentes atualizando seu Serviço de Aplicativo no portal do Azure.
Chaves no QnA Maker
Seu serviço do QnA Maker lida com dois tipos de chaves: chaves de criação e chaves de ponto de extremidade de consulta usadas com o runtime hospedado no Serviço de Aplicativo.
Use essas chaves ao fazer solicitações ao serviço por meio de APIs.
| Nome | Localização | Finalidade |
|---|---|---|
| Chave de criação/assinatura | Portal do Azure | essas chaves são usadas para acessar as APIs do serviço de gerenciamento do QnA Maker. Essas APIs permitem que você edite as perguntas e respostas em sua base de dados de conhecimento e publique sua base de dados de conhecimento. Essas chaves são criadas quando você cria um serviço do QnA Maker. Localize essas chaves no recurso dos serviços de IA do Azure na página Chaves e Ponto de Extremidade. |
| Chave de ponto de extremidade de consulta | Portal do QnA Maker | Essas chaves são usadas para consultar o ponto de extremidade da base de dados de conhecimento publicado para obter uma resposta para uma pergunta do usuário. Normalmente, você usaria esse ponto de extremidade de consulta no seu chatbot ou código de aplicativo cliente que se conecta ao serviço do QnA Maker. Essas chaves são criadas quando você publica sua base de dados de conhecimento do QnA Maker. Localize essas chaves na página Configurações de serviço. Localize essa página no menu do usuário no canto superior direito da página no menu suspenso. |
Localizar chaves de criação no portal do Azure
Você pode ver e redefinir suas chaves de criação no portal do Azure onde você criou o recurso do QnA Maker.
Vá para o recurso do QnA Maker no portal do Azure e selecione o recurso que tiver o tipo serviços de IA do Azure:
Acessar as Chaves e o Ponto de Extremidade:
Localizar chaves de ponto de extremidade de consulta no portal do QnA Maker
O ponto de extremidade está na mesma região que o recurso porque as chaves de ponto de extremidade são usadas para fazer uma chamada para a base de dados de conhecimento.
As chaves de ponto de extremidade podem ser gerenciadas a partir do portal do QnA Maker.
Entre no Portal do QnA Maker, vá até seu perfil e selecione Configurações de serviço:
Ver ou redefinir suas chaves:
Observação
Atualize as chaves se você achar que elas estão comprometidas. Isso pode exigir que sejam feitas as alterações correspondentes no seu aplicativo cliente ou código bot.
Região do serviço de gerenciamento
O serviço de gerenciamento do QnA Maker é usado somente para o portal de QnA Maker e para o processamento de dados inicial. Esse serviço está disponível apenas na região Oeste dos EUA. Nenhum dado do cliente é armazenado nesse serviço do Oeste dos EUA.
Considerações sobre nomenclatura de recursos
O nome do recurso para o recurso do QnA Maker, como qna-westus-f0-b, também é usado para nomear os outros recursos.
A janela Criar do portal do Azure permite que você crie um recurso do QnA Maker e selecione os tipos de preço para outros recursos.
Depois que os recursos são criados, eles têm o mesmo nome, exceto para o recurso do Application Insights opcional, que adiciona caracteres ao final do nome.
Dica
Crie um grupo de recursos ao criar um recurso do QnA Maker. Isso permite que você veja todos os recursos associados ao recurso do QnA Maker ao pesquisar por grupo de recursos.
Dica
Use uma convenção de nomenclatura para indicar os tipos de preço dentro do nome do recurso ou do grupo de recursos. Quando você recebe erros da criação de uma base de dados de conhecimento ou da adição de novos documentos, o limite do tipo de preço do Cognitive Search é um problema comum.
Finalidades do recurso
Cada recurso do Azure criado com o QnA Maker tem uma finalidade específica:
- Recurso do QnA Maker
- Recurso do Cognitive Search
- Serviço de Aplicativo
- Plano do Serviço de Aplicativo
- Serviço do Application Insights
Recurso do QnA Maker
O recurso do QnA Maker fornece acesso às APIs de criação e de publicação.
Configurações do recurso do QnA Maker
Quando você cria uma base de dados de conhecimento no portal do QnA Maker, a configuração de Idioma é a única que é aplicada no nível do recurso. Você seleciona o idioma ao criar a primeira base de dados de conhecimento para o recurso.
Recurso do Cognitive Search
O recurso do Cognitive Search é usado para:
- Armazenar os pares de perguntas e respostas
- Forneça a classificação inicial (classificador nº 1) dos pares de perguntas e respostas no runtime
Uso do índice
O recurso mantém um índice para atuar como o índice de teste e cada um dos índices restantes se correlacionam a uma base de dados de conhecimento publicada.
Um recurso com preço para manter 15 índices, manterá 14 bases de dados de conhecimento publicadas e um índice é usado para testar todas as bases de dados de conhecimento. Esse índice de teste é particionado pela base de dados de conhecimento para que uma consulta usando o painel de teste interativo use o índice de teste, mas retorne resultados apenas da partição específica associada à base de dados de conhecimento específica.
Uso do idioma
A primeira base de dados de conhecimento criada no recurso do QnA Maker é usada para determinar único conjunto de idiomas para o recurso do Cognitive Search e todos os seus índices. Você pode ter apenas um conjunto de idiomas para um serviço do QnA Maker.
Usando um serviço Cognitive Search
Se você criar um serviço QnA e suas dependências (como Pesquisa) por meio do portal, um serviço Pesquisa será criado para você e vinculado ao serviço do QnA Maker. Depois que esses recursos forem criados, você poderá atualizar a configuração do Serviço de Aplicativo para usar um serviço Pesquisa já existente e remover o que acabou de criar.
Saiba como configurar o QnA Maker para usar um recurso dos serviços de IA do Azure diferente do que foi criado como parte do processo de criação de recursos do QnA Maker.
Serviço de Aplicativo e Plano do Serviço de Aplicativo
O Serviço de Aplicativo é usado pelo aplicativo cliente para acessar as bases de dados de conhecimento publicadas por meio do ponto de extremidade de runtime. O serviço de aplicativo inclui a camada de segunda classificação (classificação nº 2) baseada em NLP (processamento em idioma natural) dos pares de perguntas e respostas em runtime. A segunda classificação aplica filtros inteligentes que podem incluir metadados e prompts de acompanhamento.
Para consultar a base de dados de conhecimento publicada, todas as bases de conhecimento publicadas usam o mesmo ponto de extremidade de URL, mas especificam a ID da base de dados de conhecimento dentro da rota.
{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer
Application Insights
O Application Insights é usado para coletar logs de chat e telemetria. Examine as consultas comuns do Kusto para obter informações sobre o seu serviço.
Compartilhar serviços com o QnA Maker
O QnA Maker cria vários recursos do Azure. Para reduzir o gerenciamento e beneficiar-se do compartilhamento de custos, use a segunite tabela para entender o que você pode e não pode compartilhar:
| Serviço | Compartilhar | Motivo |
|---|---|---|
| Serviços de IA do Azure | X | Não é possível por design |
| Plano do Serviço de Aplicativo | ✔ | Espaço em disco fixo alocado para um Plano do Serviço de Aplicativo. Se outros aplicativos que compartilham o mesmo Plano do Serviço de Aplicativo usarem um espaço em disco significativo, a instância do Serviço de Aplicativo do QnAMaker encontrará problemas. |
| Serviço de Aplicativo | X | Não é possível por design |
| Application Insights | ✔ | Pode ser compartilhada |
| Serviço Search | ✔ | 1. testkb é um nome reservado para o serviço do QnAMaker. Ele não pode ser usado por outros.2. O mapa de sinônimos pelo nome synonym-map é reservado para o serviço QnAMaker.3. O número de bases de dados de conhecimento publicadas é limitado pela camada de serviço Pesquisa. Se houver índices livres disponíveis, outros serviços poderão usá-los. |
Próximas etapas
- Saber mais sobre a base de dados de conhecimento do QnA Maker
- Entender um ciclo de vida da base de dados de conhecimento
- Examinar os limites do serviço de revisão e da base de dados de conhecimento