Een beveiligde SharePoint-gegevensbron toevoegen aan uw knowledge base
Voeg beveiligde SharePoint-gegevensbronnen in de cloud toe aan uw knowledge base om de knowledge base te verrijken met vragen en antwoorden die mogelijk worden beveiligd met Active Directory.
Wanneer u een beveiligd SharePoint-document aan uw Knowledge Base toevoegt, moet u als QnA Maker-beheerder Active Directory-machtigingen aanvragen voor QnA Maker. Zodra deze machtiging is verleend vanuit Active Directory-beheer om QnA Maker toegang tot SharePoint te krijgen, hoeft deze niet opnieuw te worden gegeven. Voor elk volgend document dat aan de Knowledge Base wordt toevoegingen, is geen autorisatie vereist als het zich in dezelfde SharePoint-resource.
Als de QnA Maker knowledge base manager niet de Active Directory-manager is, moet u communiceren met de Active Directory-manager om dit proces te voltooien.
Vereisten
- SharePoint in de cloud: QnA Maker gebruikt Microsoft Graph voor machtigingen. Als uw SharePoint on-premises is, kunt u geen gegevens extraheren uit SharePoint omdat Microsoft Graph machtigingen niet kunnen bepalen.
- URL-indeling: QnA Maker alleen SharePoint-URL's ondersteund die worden gegenereerd voor delen en een indeling hebben
https://\*.sharepoint.com
Ondersteunde bestandstypen toevoegen aan knowledge base
U kunt alle door QnA Maker ondersteunde bestandstypen van een SharePoint-site toevoegen aan uw Knowledge Base. Mogelijk moet u machtigingen verlenen als de bestandsresource is beveiligd.
Selecteer in de bibliotheek met de SharePoint-site het beletseltekenmenu van het bestand,
....Kopieer de URL van het bestand.
Voeg in QnA Maker portal op de pagina Instellingen de URL toe aan de knowledge base.
Afbeeldingen met SharePoint-bestanden
Als bestanden afbeeldingen bevatten, worden deze niet geëxtraheerd. U kunt de afbeelding toevoegen vanuit QnA Maker portal nadat het bestand is uitgepakt in QnA-paren.
Voeg de afbeelding toe met de volgende markdown-syntaxis:
De tekst tussen de vierkante haken, [] , verklaart de afbeelding. De URL tussen haakjes, () , is de directe koppeling naar de afbeelding.
Wanneer u het QnA-paar test in het interactieve testvenster, wordt in de QnA Maker-portal de afbeelding weergegeven in plaats van de markdowntekst. Hiermee wordt gevalideerd of de afbeelding openbaar kan worden opgehaald uit uw clienttoepassing.
Machtigingen
Het verlenen van machtigingen vindt plaats wanneer een beveiligd bestand van een server met SharePoint wordt toegevoegd aan een Knowledge Base. Afhankelijk van de manier waarop SharePoint is ingesteld en de machtigingen van de persoon die het bestand toevoegt, kan dit het volgende vereisen:
- geen extra stappen: de persoon die het bestand toevoegt, beschikt over alle benodigde machtigingen.
- stappen door zowel Knowledge Base Manager als Active Directory Manager.
Zie de onderstaande stappen.
Knowledge base manager: SharePoint-gegevensbron toevoegen in QnA Maker portal
Wanneer de QnA Maker manager een beveiligd SharePoint-document toevoegt aan een knowledge base, initieert de Knowledge Base-manager een machtigingsaanvraag die de Active Directory-manager moet voltooien.
De aanvraag begint met een pop-up om te verifiëren bij een Active Directory-account.
Zodra de QnA Maker manager het account selecteert, ontvangt de Azure Active Directory-beheerder een melding dat de QnA Maker-app (niet de QnA Maker manager) toegang moet hebben tot de SharePoint-resource. De Azure Active Directory manager moet dit doen voor elke SharePoint-resource, maar niet voor elk document in die resource.
Active Directory-beheer: leestoegang tot bestanden verlenen QnA Maker
De Active Directory-beheerder (niet de QnA Maker-manager) moet toegang verlenen tot QnA Maker om toegang te krijgen tot de SharePoint-resource door deze koppeling te selecteren om de SharePoint Enterprise-app van de QnA Maker-portal toestemming te geven bestanden te lezen.
Toegang verlenen vanuit het Azure Active Directory-beheercentrum
De Active Directory-beheerder meldt zich aan bij de Azure Portal en opent Bedrijfstoepassingen.
Zoek naar
QnAMakerPortalSharePointde selecteer de QnA Maker app.
Ga onder Beveiliging naar Machtigingen. Selecteer Beheerdersmachtiging verlenen voor Organisatie.
Selecteer een Sign-On account met machtigingen om machtigingen te verlenen voor de Active Directory.
SharePoint-gegevensbron toevoegen met API's
Er is een tijdelijke oplossing voor het toevoegen van de meest recente SharePoint-inhoud via API met behulp van Azure Blob Storage. Hieronder volgen de stappen:
- Download de SharePoint-bestanden lokaal. De gebruiker die de API aanroept, moet toegang hebben tot SharePoint.
- Upload ze naar de Azure Blob-opslag. Hiermee maakt u een beveiligde gedeelde toegang met behulp van een SAS-token.
- Geef de blob-URL die is gegenereerd met het SAS-token door aan QnA Maker API. Als u de extractie van vragen uit de bestanden wilt toestaan, moet u het bestandstype van het achtervoegsel toevoegen als '&ext=pdf' of '&ext=doc' aan het einde van de URL voordat u dit door geeft aan QnA Maker API.