Aggiungere un'origine dati di SharePoint protetta alla knowledge base

Aggiungere origini dati di SharePoint basate sul cloud protette alla knowledge base per arricchirla con domande e risposte che possono essere protette con Active Directory.

Quando si aggiunge un documento di SharePoint protetto alla knowledge base, come gestore di QnA Maker, è necessario richiedere l'autorizzazione di Active Directory per QnA Maker. Quando questa autorizzazione viene concessa dal gestore di Active Directory a QnA Maker per l'accesso a SharePoint, non deve essere concessa di nuovo. Ogni documento successivo aggiunto alla knowledge base non richiederà l'autorizzazione se si trova nella stessa risorsa di SharePoint.

Se il gestore della knowledge base di QnA Maker non è il gestore di Active Directory, sarà necessario comunicare con il gestore di Active Directory per completare questo processo.

Prerequisiti

• SharePoint basato sul cloud - QnA Maker usa Microsoft Graph per le autorizzazioni. Se SharePoint è in locale, non sarà possibile eseguire estrazioni da SharePoint perché Microsoft Graph non sarà in grado di determinare le autorizzazioni.
• Formato URL - QnA Maker supporta solo gli URL di SharePoint generati per la condivisione e nel formato https://\*.sharepoint.com

Aggiungere tipi di file supportati alla knowledge base

È possibile aggiungere tutti i tipi di file supportati da QnA Maker da un sito di SharePoint alla knowledge base. Potrebbe essere necessario concedere le autorizzazioni se la risorsa di file è protetta.

1. Dalla raccolta con il sito di SharePoint selezionare il menu con i puntini di sospensione del file, ....

2. Copiare l'URL del file.

   

3. Nella pagina Impostazioni del portale di QnA Maker aggiungere l'URL alla knowledge base.

Immagini con file di SharePoint

Se i file includono immagini, queste non vengono estratte. È possibile aggiungere l'immagine, dal portale di QnA Maker, dopo l'estrazione del file in coppie di domande e risposte.

Aggiungere l'immagine con la sintassi markdown seguente:

![Explanation or description of image](URL of public image)

Il testo tra parentesi quadre, [], spiega l'immagine. L'URL tra parentesi, (), è il collegamento diretto all'immagine.

Quando si testa la coppia di domanda e risposta nel pannello di test interattivo nel portale di QnA Maker, viene visualizzata l'immagine anziché il testo markdown. Si ottiene così la convalida che l'immagine può essere recuperata pubblicamente dall'applicazione client.

Autorizzazioni

La concessione delle autorizzazioni si verifica quando un file protetto da un server che esegue SharePoint viene aggiunto a una knowledge base. A seconda della configurazione di SharePoint e delle autorizzazioni dell'utente che aggiunge il file, potrebbe essere necessario:

• nessun passaggio aggiuntivo - la persona che aggiunge il file ha tutte le autorizzazioni necessarie.
• l'intervento sia del gestore della knowledge base che del gestore di Active Directory.

Vedere i passaggi elencati di seguito.

Gestore della knowledge base: aggiungere l'origine dati di SharePoint nel portale di QnA Maker

Quando il gestore di QnA Maker aggiunge un documento di SharePoint protetto a una knowledge base, il gestore della knowledge base avvia una richiesta di autorizzazione che deve essere completata dal gestore di Active Directory.

La richiesta inizia con un popup per l'autenticazione in un account Active Directory.

Dopo che il gestore di QnA Maker seleziona l'account, l'amministratore di Microsoft Entra riceverà un avviso indicante che è necessario consentire all'app QnA Maker (non al gestore di QnA Maker) di accedere alla risorsa di SharePoint. Il gestore di Microsoft Entra dovrà eseguire questa operazione per ogni risorsa di SharePoint, ma non per ogni documento in tale risorsa.

Gestore di Active Directory: concedere l'accesso in lettura ai file a QnA Maker

Il gestore di Active Directory (non il gestore di QnA Maker) deve concedere l'accesso a QnA Maker per accedere alla risorsa di SharePoint selezionando questo collegamento per assegnare autorizzazioni d lettura per i file all'app aziendale di SharePoint del portale di QnA Maker.

Concedere l'accesso dall'interfaccia di amministrazione di Microsoft Entra

1. Accedere al portale di Azure.

2. Passare a Microsoft Entra ID>Applicazioni aziendali.

3. Cercare QnAMakerPortalSharePoint per selezionare l'app QnA Maker.

   

4. In Sicurezza passare ad Autorizzazioni. Selezionare Concedi consenso amministratore per Organizzazione.

   

5. Selezionare un account di accesso con autorizzazioni per concedere le autorizzazioni per Active Directory.

Aggiungere un'origine dati di SharePoint con le API

Esiste una soluzione alternativa per aggiungere il contenuto di SharePoint più recente tramite l'API usando Archiviazione BLOB di Azure. Ecco i passaggi:

1. Scaricare i file di SharePoint in locale. L'utente che chiama l'API deve avere accesso a SharePoint.
2. Caricarli in Archiviazione BLOB di Azure. Verrà creato un accesso condiviso sicuro usando il token di firma di accesso condiviso.
3. Passare l'URL del BLOB generato con il token di firma di accesso condiviso all'API di QnA Maker. Per consentire l'estrazione delle risposte alle domande dai file, è necessario aggiungere il suffisso del tipo di file "&ext=pdf" o "&ext=doc' alla fine dell'URL prima di passarlo all'API di QnA Maker.

Passaggi successivi

Collaborare alla knowledge base