Colaborar com outros autores e editores

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

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 perguntas, consulte o guia de migração.

O acesso é fornecido no recurso do QnA Maker

Todas as permissões são controladas pelas permissões colocadas no recurso do QnA Maker. Essas permissões se alinham a leitura, gravação, publicação e acesso completo. Para permitir a colaboração entre vários usuários, altere o acesso de RBAC do recurso do QnA Maker.

Esse recurso do RBAC do Azure inclui:

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

Observação

Adicione um subdomínio personalizado para o recurso. O subdomínio personalizado deve estar presente por padrão, mas adicione-o caso ele não esteja

O acesso é concedido por uma função definida

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

Função	Funcionalidades	Acesso à API	Permissões de API
Proprietário	Tudo	Chave de autenticação	Tudo
Colaborador dos Serviços Cognitivos	Tudo, exceto a capacidade de adicionar novos membros a funções	Chave de autenticação	Tudo, exceto a capacidade de adicionar novos membros a funções
Leitor do QnA Maker dos Serviços Cognitivos (ler)	Exportar/baixar Teste	Token de portador	1. Baixar a API da base de dados de conhecimento 2. Listar bases de dados de conhecimento para a API do usuário 3. Obter detalhes da base de dados 4. Baixar alterações Gerar resposta
Editor do QnA Maker dos Serviços Cognitivos (ler/gravar)	Exportar/baixar Teste Atualizar base de dados de conhecimento Exportar base de dados de conhecimento Importar base de dados de conhecimento Substituir base de dados de conhecimento Criar uma base de dados de conhecimento	Token de portador	1. Criar a API da base de dados de conhecimento 2. Atualizar a API da base de dados de conhecimento 3. Substituir a API da base de dados de conhecimento 4. Substituir alterações 5. "Treinar a API" [no novo modelo de serviço v5]
Usuário dos Serviços Cognitivos (ler/gravar/publicar)	Tudo	Chave de autenticação	Todo o acesso ao recurso de serviços de IA do Azure, exceto pela capacidade de: 1. Adicionar membros novos a funções. 2. Criar recursos novos.

Fluxo de autenticação

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

Etapas	Descrição
1	O portal adquire o token do recurso do QnA Maker.
2	O portal chama a API de criação do QnA Maker apropriada (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 serviço do QnAMaker.

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

Autenticar pelo portal do QnA Maker

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

Autenticar pelas APIs e SDKs do QnA Maker

Se você cria e colabora usando as APIs, seja por REST ou pelos SDKs, precisa criar uma entidade de serviço para gerenciar a autenticação.

Próxima etapa

• Criar uma base de dados de conhecimento para linguagens e aplicativos clientes