Collaborare con altri autori ed editor

Collaborare con altri autori e editor usando il controllo degli accessi in base al ruolo di Azure inserito nella risorsa QnA Maker.

Nota

Il servizio QnA Maker viene ritirato il 31 marzo 2025. Una versione più recente della funzionalità di domande e risposte è ora disponibile come parte del linguaggio di intelligenza artificiale di Azure. Per le funzionalità di risposta alle domande all'interno del servizio di linguaggio, vedere La risposta alle domande. A partire dal 1° ottobre 2022 non sarà possibile creare nuove risorse di QnA Maker. Per informazioni sulla migrazione delle knowledge base di QnA Maker esistenti alla risposta alle domande, vedere la guida alla migrazione.

L'accesso viene fornito nella risorsa QnA Maker

Tutte le autorizzazioni sono controllate dalle autorizzazioni inserite nella risorsa QnA Maker. Queste autorizzazioni sono allineate a lettura, scrittura, pubblicazione e accesso completo. È possibile consentire la collaborazione tra più utenti aggiornando l'accesso controllo degli accessi in base al ruolo per la risorsa QnA Maker.

Questa funzionalità di Controllo degli accessi in base al ruolo di Azure include:

  • Microsoft Entra ID è compatibile con le versioni precedenti del 100% con l'autenticazione basata su chiave per proprietari e collaboratori. I clienti possono usare l'autenticazione basata su chiave o l'autenticazione basata sul controllo degli accessi in base al ruolo di Azure nelle richieste.
  • Aggiungere rapidamente autori e editor a tutte le knowledge base nella risorsa perché il controllo è a livello di risorsa, non a livello di knowledge base.

Nota

Assicurarsi di aggiungere un sottodominio personalizzato per la risorsa. Il sottodominio personalizzato deve essere presente per impostazione predefinita, ma in caso contrario, aggiungerlo

L'accesso viene fornito da un ruolo definito

Per la collaborazione vengono forniti i ruoli seguenti:

Ruolo Funzionalità Accesso API Autorizzazioni API
Proprietario Tutte le date Chiave di autenticazione Tutte le date
Collaboratore Servizi cognitivi Tutti tranne la possibilità di aggiungere nuovi membri ai ruoli Chiave di autenticazione Tutti tranne la possibilità di aggiungere nuovi membri ai ruoli
Lettore QnA Maker di Servizi cognitivi
(lettura)
Esportazione/download
Test
Token di connessione 1. Scaricare l'API KB
2. Elencare I KB per l'API utente
3. Ottenere i dettagli della Knowledge Base
4. Scarica modifiche
Genera risposta
Editor QnA Maker di Servizi cognitivi
(lettura/scrittura)
Esportazione/download
Test
Aggiornare la KNOWLEDGE Base
Esportare kb
ImportaRE KB
Sostituire KB
Create Knowledgebase (Creare la knowledge base)
Token di connessione 1. Creare l'API KB
2. Aggiornare l'API KB
3. Sostituire l'API KB
4. Sostituire le modifiche
5. "Train API" [in new service model v5]
Utente Servizi cognitivi
(lettura/scrittura/pubblicazione)
Tutte le date Chiave di autenticazione Tutti gli accessi alla risorsa dei servizi di intelligenza artificiale di Azure, ad eccezione della possibilità di:
1. Aggiungere nuovi membri ai ruoli.
2. Creare nuove risorse.

Flusso di autenticazione

Il diagramma seguente illustra il flusso, dal punto di vista dell'autore, per accedere al portale di QnA Maker e usando le API di creazione.

The following diagram shows the flow, from the author's perspective, for signing into the QnA Maker portal and using the authoring APIs.

Passaggi Descrizione
1 Il portale acquisisce il token per la risorsa QnA Maker.
2 Portale Chiama l'API di creazione (APIM) di QnA Maker appropriata passando il token anziché le chiavi.
3 L'API QnA Maker convalida il token.
4 L'API QnA Maker chiama il servizio QnAMaker.

Se si intende chiamare le API di creazione, vedere altre informazioni su come configurare l'autenticazione.

Eseguire l'autenticazione tramite il portale di QnA Maker

Se si crea e si collabora usando il portale di QnA Maker, dopo aver aggiunto il ruolo appropriato alla risorsa per un collaboratore, il portale di QnA Maker gestisce tutte le autorizzazioni di accesso.

Eseguire l'autenticazione da API e SDK di QnA Maker

Se si crea e si collabora usando le API, tramite REST o gli SDK, è necessario creare un'entità servizio per gestire l'autenticazione.

Passaggio successivo

  • Progettare una Knowledge Base per le lingue e per le applicazioni client