SharePoint-inhoud gebruiken voor generatieve antwoorden

Generatieve antwoordknooppunten die SharePoint als kennisbron op onderwerpniveau gebruiken, werken door uw agent te koppelen aan een SharePoint-URL, zoals contoso.sharepoint. com/sites/policies. Wanneer een gebruiker een vraag stelt en agent geen onderwerp heeft om als antwoord te gebruiken, doorzoekt agent de URL en alle subpaden. Een URL zoals contoso.sharepoint.com/sites bevat bijvoorbeeld ook subpaden als contoso.sharepoint.com/sites/policies. Generatieve antwoorden vatten deze inhoud samen in een doelgericht antwoord.

Wanneer u uw agent publiceert, worden de aanroepen die generatieve antwoorden gebruiken namens de gebruiker die met de agent chat gedaan, met behulp van de verificatie-instellingen die zijn geconfigureerd in de agent. Standaard worden agents die zijn gemaakt in Copilot Studio en in Microsoft Teams geconfigureerd met de verificatieoptie Authenticate met Microsoft, die werkt in omgevingen zoals Microsoft Teams, Power Apps en Microsoft 365 Copilot.

SharePoint gebruiken in een generatief antwoordknooppunt

1. Voeg in een onderwerp een node voor generatieve antwoorden toe.

2. In de generatieve antwoorden-node van het relevante onderwerp opent u het configuratiepaneel voor gegevensbronnen vanaf een van twee plaatsen:

   1. Selecteer op het knooppunt Generatieve antwoorden maken de optie Bewerken onder Gegevensbronnen.

      

   2. Alternatief selecteert u in de knop 'Genereer generatieve antwoorden ' de drie punten (...), vervolgens Eigenschappen en selecteer Gegevensbron.

3. Selecteer Onder Kennisbronnende optie Kennis toevoegen. Zorg ervoor dat zoeken alleen geselecteerde bronnen is ingeschakeld.

4. Selecteer SharePoint in de sectie Aanbevolen.

   

5. Geef de SharePoint-URL op. Scheid meerdere URL's met handmatige regeleinden (gebruik Shift + Enter).

   Note

   Zie Limieten voor SharePoint-web-apps voor een lijst met limieten en ondersteunde SharePoint-functionaliteit.

6. Voeg een naam en een beschrijving toe. De beschrijving moet zo gedetailleerd mogelijk zijn, vooral als generatieve AI is ingeschakeld, aangezien de beschrijving generatieve indeling bevordert.

7. Selecteer Opslaan bovenaan om uw onderwerpwijzigingen op te slaan.

8. Test uw agent met zinnen waarvan u verwacht dat ze inhoud opleveren.

   Note

   Als het gebruikersaccount waarmee u zich hebt aangemeld bij copilotstudio.microsoft.com geen toegang heeft tot de SharePoint site, krijgt u geen inhoud of ziet u mogelijk een systeemfout.

Variabelen gebruiken als URL's

Gebruik variabelen in openbare website of SharePoint URL's van kennisbronnen om dynamisch het bereik van inhoud te bepalen die uw agent gebruikt.

In plaats van meerdere kennisbronnen te maken voor verschillende scenario's, definieert u één kennisbron en voegt u een variabele in de URL in. Tijdens uitvoeringstijd lost Copilot Studio de variabele op en gebruikt de resulterende URL voor verwerking.

Ondersteuning voor variabelen

Wanneer u een openbare website of SharePoint kennisbron-URL toevoegt of bewerkt, kunt u een variabele invoegen in het URL-veld.

Gebruik een variabele om:

• Een pad toevoegen aan een basis-URL

  https://www.contoso.com/{variable}

• De volledige URL vervangen

  {variable}

Tijdens runtime wordt de variabele omgezet in een tekenreekswaarde. De kennisbron is beperkt tot de opgeloste URL.

Een variabele maken en instellen

Een variabele gebruiken in een openbare website of SharePoint kennisbron:

1. Maak een tekenreeksvariabele met globaal bereik.

2. Stel de variabelewaarde in met een van de volgende opties:

   • Onderwerpinvoer
   • Eigenschappen van gebruikersprofielen, zoals taal
   • Omgevingsvariabelen
   • Agentstromen of connectors

3. Voeg de variabele in het URL-veld in door {x} (variabele invoegen) te selecteren.

4. Test de agent om te bevestigen dat de variabele leidt naar de verwachte URL.

Voorbeeld: Bereik per product

U kunt kennis op verschillende productgebieden toepassen op basis van de query van de gebruiker.

1. Gebruik een onderwerpinvoer om de productnaam vast te leggen als een variabele met de naam Product.

2. Voeg een waardeknooppunt voor variabelen instellen toe na het knooppunt Trigger en maak een nieuwe variabele met de naam ProductTable.

3. Gebruik een Power Fx-formule om de productnamen te definiëren en toe te wijzen aan URL-paden.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Voeg nog een waardeknooppunt voor variabelen instellen toe en gebruik dit om een nieuwe globale variabele van het tekenreekstype met de naam GlobalProductURLte maken.

5. Selecteer in de instelling Naar-waardede optie Formule en gebruik een Power Fx-functie om een zoekopdracht uit te voeren in de tabel op basis van de waarde van Product de invoervariabele, Topic.Productals volgt:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Gebruik de variabele in de URL van de kennisbron:

   https://www.microsoft.com/en-us/{GlobalProductURL}

De agent voert tijdens de uitvoertijd alleen query's uit op het specifieke gedeelte van de website.

Algemene scenario's

Variabelen gebruiken in kennisbronnen van openbare websites voor:

• Routering op basis van product: Query's beperken tot specifieke documentatie van producten.

• Regio- of taalfilters: toewijzen User.Language aan gelokaliseerde URL's (bijvoorbeeld en-us, it-it).

• Omgevingsspecifieke URL's: Schakelen tussen ontwikkel-, test- en productiesites.

Overwegingen

• Kennisbronnen van openbare websites maken gebruik van Bing Zoeken en zijn afhankelijk van geïndexeerde inhoud.
• Url-dieptelimieten zijn nog steeds van toepassing wanneer u variabelen gebruikt.
• Variabelen wijzigen alleen de doel-URL. Ze hebben geen invloed op de wijze waarop inhoud wordt geïndexeerd of opgehaald.

Geavanceerde authenticatiescenario's

Standaard configureert Copilot Studio agents vooraf om gebruikers te verifiëren met behulp van Microsoft-verificatie voor toegang tot SharePoint bronnen wanneer ze verbinding maken met een agent via Microsoft Teams, Power Apps of Microsoft 365 Copilot. Als u echter handmatig verificatie moet configureren, zijn de volgende stappen vereist voor generatieve antwoorden om met SharePoint gegevensbronnen te werken.

• Generatieve antwoorden van SharePoint-bronnen zijn niet beschikbaar voor guest gebruikers in apps met SSO.

• Als u uw agent wilt verifiëren, raadpleegt u Verificatie.

• Zie Gebruikersverificatie configureren met Microsoft Entra ID voor instructies over het maken van de benodigde Microsoft Entra ID-toepassingsregistratie. Wanneer u deze registratie maakt, moet u of uw beheerder de Sites.Read.All en Files.Read.All scopes opgeven in de Microsoft Entra ID-app-registratie.

• Als u No-verificatie selecteert, geeft u aan dat uw agent geen gegevens ophaalt uit SharePoint.

• Wanneer u authenticatie configureert, bepalen scope-instellingen de toegang van de gebruikers. Geef Sites.Read.All en Files.Read.All op in het bereikveld bij de bestaande waarden profile en openid in Copilot Studio. Deze bevoegdheden geven gebruikers geen verhoogde machtigingen wanneer ze de agent gebruiken, maar staan toe dat hun toegestane inhoud van de SharePoint-site wordt gebruikt zoals geconfigureerd voor gegenereerde antwoorden.

• SharePoint ondersteunt de instelling Authenticate handmatig met de volgende verificatieserviceproviders:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 met gefedereerde inloggegevens
  • Microsoft Entra ID V2 met certificaten
  • Microsoft Entra ID V2 met clientgeheimen

• SharePoint biedt geen ondersteuning voor handmatige verificatie met behulp van Generic OAuth.

• Deze configuratie is alleen van toepassing op generatieve antwoorden, niet op Power Platform-connectors.