Partilhar via


Colabore com outros autores e editores

Colabore com outros autores e editores usando o controle de acesso baseado em função do Azure (Azure RBAC) colocado em seu recurso do QnA Maker.

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.

O acesso é fornecido no recurso QnA Maker

Todas as permissões são controladas pelas permissões colocadas no recurso QnA Maker. Essas permissões se alinham para leitura, gravação, publicação e acesso total. Você pode permitir a colaboração entre vários usuários atualizando o acesso RBAC para o recurso QnA Maker.

Este recurso do Azure RBAC inclui:

  • O Microsoft Entra ID é 100% compatível com autenticação baseada em chave para proprietários e colaboradores. Os clientes podem usar a autenticação baseada em chave ou a autenticação baseada no Azure RBAC em suas solicitações.
  • Adicione rapidamente autores e editores a todas as bases de dados de conhecimento no recurso porque o controle está no nível do recurso, não no nível da base de conhecimento.

Nota

Certifique-se de adicionar um subdomínio personalizado para o recurso. Subdomínio personalizado deve estar presente por padrão, mas se não, adicione-o

O acesso é fornecido por uma função definida

As seguintes funções são fornecidas para colaboração:

Role Funcionalidades Acesso à API Permissões de API
Proprietário Todos Chave de autenticação Todos
Colaborador de Serviços Cognitivos Tudo, exceto a capacidade de adicionar novos membros às funções Chave de autenticação Tudo, exceto a capacidade de adicionar novos membros às funções
Serviços Cognitivos QnA Maker Reader
(ler)
Exportar/Descarregar
Teste
Token ao portador 1. Faça o download da API KB
2. Listar KBs para API do usuário
3. Obtenha detalhes da Base de Dados de Conhecimento
4. Alterações de Download
Gerar resposta
Serviços Cognitivos QnA Maker Editor
(leitura/gravação)
Exportar/Descarregar
Teste
Atualizar KB
Exportar KB
Importar KB
Substituir KB
Criar KB
Token ao portador 1. Criar API KB
2. Atualizar a API KB
3. Substitua a API KB
4. Substituir alterações
5. "Train API" [no novo modelo de serviço v5]
Utilizador de Serviços Cognitivos
(ler/escrever/publicar)
Todos Chave de autenticação Todo o acesso ao recurso de serviços de IA do Azure, exceto a capacidade de:
1. Adicione novos membros às funções.
2. Crie novos recursos.

Fluxo de autenticação

O diagrama a seguir mostra o fluxo, da perspetiva do autor, para entrar no portal do QnA Maker e usar as APIs de criação.

O diagrama a seguir mostra o fluxo, da perspetiva do autor, para entrar no portal do QnA Maker e usar as APIs de criação.

Passos Description
5 Portal Adquire token para o recurso QnA Maker.
2 O Portal chama a API de criação apropriada do QnA Maker (APIM) passando o token em vez de chaves.
3 A API do QnA Maker valida o token.
4 A API do QnA Maker chama o QnAMaker Service.

Se você pretende chamar as APIs de criação, saiba mais sobre como configurar a autenticação.

Autenticar pelo portal QnA Maker

Se você criar e colaborar usando o portal do QnA Maker, depois de adicionar a função apropriada ao recurso para um colaborador, o portal do QnA Maker gerenciará todas as permissões de acesso.

Autenticar por APIs e SDKs do QnA Maker

Se você criar e colaborar usando as APIs, seja por meio de REST ou SDKs, precisará criar uma entidade de serviço para gerenciar a autenticação.

Próximo passo

  • Projetar uma base de conhecimento para idiomas e aplicativos cliente