SharePoint kennisbronnen geen resultaten retourneren in Copilot Studio

Overzicht

Dit artikel helpt u bij het oplossen van problemen waarbij SharePoint kennisbronnen geen resultaten retourneren in Microsoft Copilot Studio. Wanneer u een SharePoint gegevensbron configureert, kunnen verschillende factoren voorkomen dat de agent een antwoord oplevert. Deze factoren omvatten ontbrekende zoekresultaten, gebruikersmachtigingen, beveiligde inhoud, problemen met app-registratie, beperkingen van de bestandsgrootte, filtervoorwaarden of filteren van inhoudsbeheer. In dergelijke gevallen kan de agent een bericht retourneren, zoals 'Ik weet niet zeker hoe ik daarmee moet helpen. Kunt u proberen de formule te herformuleren?"

Copilot Studio biedt twee manieren om SharePoint als kennisbron te configureren. In dit artikel worden beide methoden behandeld:

• Kennisbron op agentniveau. Toevoegen vanuit het dialoogvenster Kennis toevoegen op de pagina's Overzicht, Kennis of Eigenschappen van de agent. Dit pad ondersteunt SharePoint sites (URL's) en SharePoint lijsten, het bijsnijden van vertrouwelijkheidslabels en filtervoorwaarden. Zie SharePoint toevoegen als kennisbron voor meer informatie.
• Kennisbron op onderwerpniveau. Voeg toe aan een knooppunt voor generatieve antwoorden maken in een onderwerp. Dit pad koppelt het knooppunt aan een SharePoint-URL. Zie Gebruik SharePoint inhoud voor generatieve antwoorden voor meer informatie.

Zoekresultaten ontbreken in SharePoint

Wanneer Copilot Studio zoekopdrachten SharePoint, worden alleen de drie belangrijkste zoekresultaten gebruikt om een antwoord samen te vatten en te genereren. Als er geen zoekresultaten worden geretourneerd, geeft de agent geen antwoord. Copilot Studio is afhankelijk van Microsoft Search indexering en dwingt specifieke beperkingen af voor de pagina-indelingen, onderdelen en bestandsindelingen die worden gebruikt om antwoorden te genereren.

Ontbrekende SharePoint zoekresultaten oplossen

1. Zorg ervoor dat uw SharePoint kennisbron (bron op agentniveau of knooppunt generatieve antwoorden maken) verwijst naar een SharePoint locatie met relevante inhoud.

2. Alleen documenten in ondersteunde indelingen worden gebruikt om respons te genereren.

3. Controleer of de SharePoint pagina's die u verwacht dat de agent wordt gebruikt, voldoen aan de volgende beperkingen:

   • Moderne pagina's: Alleen moderne SharePoint pagina's worden ondersteund. Moderne pagina's met SharePoint Framework (SPFx)-onderdelen worden niet ondersteund.
   • Klassieke pagina's: Inhoud van klassieke .aspx pagina's op SharePoint wordt niet gebruikt om antwoorden te genereren.
   • Zie SharePoint web-app-limieten voor een volledige lijst met technische grenzen.

4. Het is mogelijk dat documenten onlangs zijn geüpload naar SharePoint en nog niet zijn geïndexeerd. Het is ook mogelijk dat sommige instellingen voorkomen dat sommige sites worden weergegeven in zoekresultaten. Zie Ontbrekende zoekresultaten in SharePoint Online voor meer informatie.

   Hoe te verifiëren

   • Voer in de zoekbalk van de SharePoint portal een uniek trefwoord uit het doeldocument in en controleer of het bestand wordt weergegeven in de zoekresultaten. Als het bestand niet wordt weergegeven, is indexering onvolledig.

   Hoe oplossen?

   • Wacht tot de automatische indexeringscyclus is voltooid.
   • Voor urgente updates kunnen SharePoint sitebeheerders handmatig een herindex activeren. Ga in SharePoint instellingen naar Site-informatie>weergeven alle site-instellingen>Zoeken en offline beschikbaarheid>opnieuw indexeren site. Zie Verkenning en opnieuw indexeren van een site, bibliotheek of lijst handmatig aanvragen voor meer informatie.

Ontbrekende gebruikersmachtigingen voor SharePoint

Copilot Studio respecteert Microsoft 365-beveiliging bijsnijden. Een gebruiker moet minimaal leesmachtigingen hebben voor de relevante sites en bestanden, of er worden geen zoekresultaten geretourneerd.

Als de gebruiker machtigingen mist, retourneert het systeem geen resultaten, noch fouten of uitzonderingen. Voor een gebruiker zonder machtigingen lijkt het alsof er geen documenten zijn gevonden.

Gebruikersmachtigingen voor SharePoint controleren

1. Laat de betrokken gebruiker rechtstreeks naar het exacte SharePoint documentpad gaan om te controleren of ze het bestand kunnen openen.
2. Test de query met hetzelfde gebruikersaccount in Microsoft 365 Copilot Chat. Als Microsoft 365 Copilot Chat een antwoord niet kan ophalen, wordt een machtigings- of zoekindexeringsbarrière bevestigd.

Ontbrekende SharePoint gebruikersmachtigingen oplossen

Wijzig de machtigingen zodat gebruikers toegang hebben tot de betreffende sites en bestanden. Zie Delen en machtigingen in de moderne SharePoint-ervaring voor meer informatie.

Inhoud wordt beveiligd door vertrouwelijkheidslabels, DKE of een wachtwoord

De SharePoint kennisbron op agentniveau respecteert vertrouwelijkheidslabels voor het bijsnijden van machtigingen en geeft alleen labelinhoud weer voor de aangemelde gebruiker. De agent kan echter geen inhoud extraheren of gronden waarvan de bescherming het bestand versleutelt. Deze beperking omvat gevoeligheidslabels die versleuteling toepassen, Double Key Encryption (DKE) en met wachtwoord beveiligde bestanden.

Dergelijke documenten kunnen worden weergegeven als Gereed in de lijst met kennisbronnen en kunnen worden geopend door de gebruiker in SharePoint, maar nog steeds 'geen antwoord' retourneren wanneer de agent wordt gevraagd om de inhoud ervan.

Beveiligde SharePoint-inhoud controleren

1. Open het bestand rechtstreeks in SharePoint of de bureaublad-app en controleer of er om een wachtwoord wordt gevraagd, DKE-beveiliging wordt aangegeven of een versleutelingslabel voor vertrouwelijkheid wordt weergegeven.
2. Vraag naar inhoud die alleen wordt weergegeven in niet-beveiligde bestanden in dezelfde bron. Als deze query's slagen terwijl query's binnen het bereik van beveiligde bestanden geen antwoord retourneren, is beveiliging de oorzaak.

Beveiligde SharePoint-inhoud herstellen

• Verwijder het versleutelingslabel, DKE-beveiliging of wachtwoord uit het bestand als het beleid van uw organisatie dit toestaat.
• Publiceer een niet-beveiligde kopie van de vereiste inhoud naar een SharePoint locatie waartoe de agent toegang heeft.
• Wijs de kennisbron naar een SharePoint locatie die geen versleutelde inhoud bevat.

De SharePoint bronkoppeling is verbroken na een naamswijziging

Als u de naam van een SharePoint site of map wijzigt die door een kennisbron op agentniveau wordt gebruikt, kan de bestaande bronkoppeling een onderbreking veroorzaken en een machtigingsverschil veroorzaken. Als dit gebeurt, heeft de agent mogelijk geen toegang tot de Knowledge Base en wordt er geen antwoord geretourneerd.

Een verbroken SharePoint bronkoppeling herstellen

1. Vraag uw SharePoint-beheerder om de juiste machtigingen te verlenen voor de hernoemde locatie en om een nieuwe bronkoppeling te genereren.
2. Open de agent en werk de SharePoint kennisbron bij met de zojuist gegenereerde koppeling.

De app-registratie of -agent is onjuist geconfigureerd voor SharePoint

Wanneer beheerders SharePoint kennisbronnen configureren, moeten ze verificatie instellen met behulp van een Microsoft Entra ID app-registratie en extra bereiken configureren. Minimaal moet de app-registratie de Sites.Read.All en bereiken opgeven en deze bereiken toevoegen aan de verificatie-instellingen van de agent en Files.Read.Allprofile .openid Als bereiken ontbreken in de app-registratie of in de verificatie-instellingen van de agent, of als er geen toestemming wordt verleend aan de vereiste bereiken, retourneert de agent geen resultaten, noch fouten of uitzonderingen. Voor een gebruiker lijkt het alsof er geen documenten zijn gevonden.

Verkeerd geconfigureerde app-registratie of agentauthenticatie herstellen

Voeg de benodigde bereiken toe aan de app-registratie en de verificatie-instellingen van de agent en verken toestemming.

Het volgende voorbeeld is een verwijzing naar een goed geconfigureerde app-registratie:

In het volgende voorbeeld worden de vereiste verificatie-instellingen in Copilot Studio weergegeven:

Bestandsgroottelimieten voor SharePoint generatieve antwoorden

Voor SharePoint-bronnen geldt dat als u geen Microsoft 365 Copilot-licentie hebt in dezelfde tenant als uw agent, generatieve antwoorden alleen bestanden tot 7 MB kunnen verwerken. U moet ook de grond voor tenantgrafieken uitschakelen met een semantische zoekinstelling .

Als u een Microsoft 365 Copilot-licentie hebt in dezelfde tenant als uw agent, is de maximale bestandsgrootte 200 MB. U moet ook de grond voor tenantgrafieken inschakelen met een semantische zoekinstelling .

Grotere bestanden kunnen worden opgeslagen in SharePoint en worden geretourneerd door een Microsoft Graph-zoekopdracht, maar worden niet verwerkt door generatieve antwoorden. Als alternatief kunt u ook uw eigen bestanden uploaden. Deze bestanden mogen maximaal 512 MB groot zijn.

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

Problemen met de bestandsgrootte voor SharePoint generatieve antwoorden oplossen

Als bestanden die relevant zijn voor uw conversationele AI-ervaring de maximale grootte overschrijden, kunt u alternatieve architecturen verkennen, zoals het gebruik van Microsoft 365 semantische indexering of het verbinden van uw gegevens met Azure OpenAI voor generatieve antwoorden.

SharePoint list bron retourneert geen resultaten

Voor kennisbronnen op agentniveau die gebruikmaken van SharePoint lijsten, kunnen verschillende lijstspecifieke factoren ertoe leiden dat de agent geen antwoord retourneert, ook al bevat de lijst relevante gegevens.

• Dataverse-zoekopdracht is vereist. Copilot Studio agents vereisen dat Dataverse-zoekopdrachten een SharePoint list als kennisbron gebruiken. Als Dataverse-zoekopdracht is uitgeschakeld in de omgeving, kan de lijst niet worden opgevraagd en worden er geen resultaten geretourneerd. Zie Dataverse configureren voor uw omgeving voor meer informatie over het inschakelen van Dataverse-zoekopdrachten.
• Lijstgrootte is van invloed op kwaliteit en latentie. Lijsten die meer dan 35.000 rijen bevatten, kunnen de kwaliteit van de resultaten verminderen en latentie verhogen, wat kan worden weergegeven als geen antwoord voor anderszins geldige query's.
• Te veel lijsten op één agent. U kunt maximaal 10 lijsten tegelijk selecteren en voor de beste resultaten niet meer dan 10 lijsten per agent gebruiken. Door meer lijsten toe te voegen, wordt de kans groter dat relevante inhoud niet wordt weergegeven.
• De lijst wordt niet weergegeven in recente lijsten. Als een SharePoint list met gedeelde toegang niet wordt weergegeven in Mijn lijsten of Recente lijsten in de browser, opent u de lijst eenmaal in SharePoint zodat deze wordt weergegeven in Recente lijsten of plakt u de lijst-URL rechtstreeks in de URL-selectie wanneer u de bron toevoegt.

Problemen met SharePoint list bron oplossen

1. Vraag uw beheerder om Dataverse-zoekopdracht in te schakelen in de omgeving waarin de agent wordt uitgevoerd.
2. Verminder het aantal rijen in de lijst of splitst grote lijsten in kleinere lijsten met prioriteit.
3. Verminder het aantal lijsten dat aan de agent is gekoppeld tot 10 of minder, zodat alleen de lijsten die relevant zijn voor de onderwerpen die de agent ondersteunt, behouden blijven.
4. Voeg lijsten opnieuw toe door hun URL te plakken wanneer ze niet automatisch worden weergegeven in recente lijsten.

Filtervoorwaarden sluiten de verwachte inhoud uit

Met beide configuratiepaden kunt u beperken welke SharePoint inhoud die de agent kan gebruiken. Als deze filters te beperkend of onjuist zijn geconfigureerd, retourneert de agent geen antwoord, zelfs wanneer overeenkomende inhoud bestaat.

• Bron op agentniveau, geavanceerde instellingenfilters. In een SharePoint kennisbron op agentniveau kunnen filters op basis van Titel, Auteur, Gewijzigd door of Gewijzigd op de inhoud uitsluiten waar de gebruiker om vraagt. Filters die zijn gebonden aan een aangepaste variabele, systeemvariabele of omgevingsvariabele, kunnen tijdens runtime worden omgezet in een onbedoelde waarde.
• Knooppunt voor generatieve antwoorden op onderwerpniveau, alleen geselecteerde bronnen zoeken. Wanneer zoeken alleen geselecteerde bronnen is ingeschakeld voor een knooppunt voor generatieve antwoorden maken , worden alleen de bronnen die op dat knooppunt zijn geselecteerd, gebruikt. Als de verwachte SharePoint bron zich niet in de selectie bevindt, retourneert de agent geen antwoord in plaats van terug te vallen op andere kennisbronnen.

Filtervoorwaarden controleren

1. Selecteer op de kennispagina uw SharePoint bron en selecteervervolgens Geavanceerde instellingen> om actieve filtervoorwaarden en de waarden die ze oplossen te controleren.
2. Open in het onderwerp dat als host fungeert voor het knooppunt Generatieve antwoorden maken de gegevensbron Eigenschappen> van het knooppunt en bevestig de instelling Alleen geselecteerde bronnen zoeken en de geselecteerde specifieke bronnen.

Filtervoorwaarden oplossen

• Ontspan of verwijder filtervoorwaarden die de verwachte inhoud uitsluiten.
• Als een filter gebruikmaakt van een variabele, voegt u een foutopsporingsstap in het gesprek toe om te bevestigen dat de variabele wordt omgezet in de waarde die u tijdens runtime verwacht.
• Voeg op het knooppunt op onderwerpniveau de verwachte SharePoint bron toe aan de geselecteerde bronnen of schakel Alleen geselecteerde bronnen zoeken uit, zodat er ook query's worden uitgevoerd op kennisbronnen op agentniveau.

Inhoud geblokkeerd door inhoudsbeheer in Copilot Studio

Wanneer ze antwoorden genereren, modereren Copilot Studio-agents inhoud die onder de schadecategorieën valt. Wanneer inhoud wordt gemodereerd, bieden generatieve antwoorden geen antwoord of een indicatie dat inhoud is gemodereerd. Er worden echter moderatiegebeurtenissen geregistreerd wanneer de agent is geconfigureerd voor het verzenden van telemetriegegevens naar Azure Applications Insights.

Nadat u uw agent hebt gekoppeld aan Azure-app Insights, kunt u de volgende Kusto Query Language (KQL)-query gebruiken om erachter te komen of de inhoud is gefilterd:

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

In het volgende voorbeeld benadrukt de KQL-query een poging om generatieve antwoorden te gebruiken, gefilterd door inhoudsmoderatie:

Oplossing voor inhoudsbeheer voor het blokkeren van generatieve antwoorden

• Probeer de inhoudsmoderatie aan te passen, maar houd er rekening mee dat een lager niveau van inhoudsmoderatie kan resulteren in antwoorden die minder nauwkeurig of relevant zijn.

• Als u denkt dat uw inhoud niet mag worden beheerd, neemt u contact op met Microsoft klantondersteuning.

Verwante onderwerpen

• SharePoint toevoegen als kennisbron
• SharePoint-inhoud gebruiken voor generatieve antwoorden
• Generatieve antwoorden instellen op SharePoint
• limieten voor SharePoint web-apps
• Delen en machtigingen in de SharePoint moderne ervaring
• Fouten met verantwoordelijke AI-inhoudsfilters oplossen