SharePoint Wissensquellen geben keine Ergebnisse in Copilot Studio

Zusammenfassung

Dieser Artikel hilft Ihnen bei der Problembehandlung und Behebung von Problemen, bei denen SharePoint Wissensquellen keine Ergebnisse in Microsoft Copilot Studio zurückgeben. Wenn Sie eine SharePoint Datenquelle konfigurieren, können mehrere Faktoren verhindern, dass der Agent eine Antwort bereitstellt. Zu diesen Faktoren gehören fehlende Suchergebnisse, Benutzerberechtigungen, geschützte Inhalte, Probleme bei der App-Registrierung, Dateigrößenbeschränkungen, Filterbedingungen oder Inhaltsmoderationsfilterung. In solchen Fällen gibt der Agent möglicherweise eine Meldung wie "Ich bin nicht sicher, wie ich ihnen helfen kann. Können Sie versuchen, die Neuformulierung zu versuchen?"

Copilot Studio bietet zwei Möglichkeiten, SharePoint als Wissensquelle zu konfigurieren, und in diesem Artikel werden beide Methoden behandelt:

  • Wissensquelle auf Agentebene. Fügen Sie im Dialogfeld " Wissen hinzufügen " auf den Seiten "Übersicht", "Wissen" oder "Eigenschaften " des Agents hinzu. Dieser Pfad unterstützt SharePoint Websites (URLs) und SharePoint Listen, Kürzungen von Vertraulichkeitsbezeichnungen und Filterbedingungen. Weitere Informationen finden Sie unter Hinzufügen von SharePoint als Wissensquelle.
  • Wissensquelle auf Themenebene. Fügen Sie in einem Thema einen generierenden Antwortknoten hinzu. Dieser Pfad koppelt den Knoten mit einer SharePoint-URL. Weitere Informationen finden Sie unter Verwenden von SharePoint Inhalten für generative Antworten.

Note

Bevor Sie fortfahren, stellen Sie sicher, dass Sie die Setupanweisungen für den vom Agent verwendeten Konfigurationspfad befolgen: Fügen Sie SharePoint als Wissensquelle für den Pfad auf Agentebene hinzu, oder verwenden Sie SharePoint Inhalt für generative Antworten für den Knoten "generative Antworten auf Themenebene".

Um bessere Suchergebnisse zu erzielen, verwenden Sie eine Microsoft 365 Copilot Lizenz innerhalb desselben Mandanten wie Ihr Agent.

Suchergebnisse fehlen in SharePoint

Wenn Copilot Studio Suchvorgänge SharePoint, werden nur die drei wichtigsten Suchergebnisse verwendet, um eine Antwort zusammenzufassen und zu generieren. Wenn keine Suchergebnisse zurückgegeben werden, stellt der Agent keine Antwort bereit. Copilot Studio basiert auf Microsoft Search Indizierung und erzwingt bestimmte Einschränkungen für die Seitenlayouts, Komponenten und Dateiformate, die zum Generieren von Antworten verwendet werden.

Beheben fehlender SharePoint Suchergebnissen

  1. Stellen Sie sicher, dass Ihre SharePoint Wissensquelle (Quelle auf Agentebene oder Erstellen von generativen Antworten) auf einen SharePoint Speicherort mit relevanten Inhalten verweist.

  2. Zur Generierung von Antworten werden nur Dokumente in unterstützten Formaten verwendet.

  3. Stellen Sie sicher, dass die SharePoint Seiten, die der Agent verwenden soll, die folgenden Einschränkungen erfüllen:

    • Moderne Seiten: Nur moderne SharePoint Seiten werden unterstützt. Moderne Seiten, die SharePoint-Framework (SPFx)-Komponenten enthalten, werden nicht unterstützt.
    • Klassische Seiten: Inhalte von klassischen .aspx Seiten auf SharePoint werden nicht verwendet, um Antworten zu generieren.
    • Eine vollständige Liste der technischen Grenzen finden Sie unter SharePoint Web App-Grenzwerte.

  4. Es ist möglich, dass Dokumente kürzlich in SharePoint hochgeladen wurden und noch nicht indiziert wurden. Es ist auch möglich, dass einige Einstellungen verhindern, dass einige Websites in Suchergebnissen angezeigt werden. Weitere Informationen finden Sie unter Suchergebnisse fehlen in SharePoint Online.

    So überprüfen Sie dies

    • Geben Sie in der suchleiste SharePoint Portal ein eindeutiges Schlüsselwort aus dem Zieldokument ein, und stellen Sie sicher, dass die Datei in den Suchergebnissen angezeigt wird. Wenn die Datei nicht angezeigt wird, ist die Indizierung unvollständig.

    So behebt man den Fehler

Fehlende Benutzerberechtigungen für SharePoint

Copilot Studio respektiert Microsoft 365 Security Kürzen. Mindestens muss ein Benutzer über Leseberechtigungen für die relevanten Websites und Dateien verfügen, oder es werden keine Suchergebnisse zurückgegeben.

Wenn der Benutzer Berechtigungen fehlt, gibt das System keine Ergebnisse oder Fehler oder Ausnahmen zurück. Für einen Benutzenden ohne Berechtigungen sieht es so aus, als ob keine Dokumente gefunden wurden.

Note

Wenn ein Benutzer nicht über die Berechtigung verfügt, löst das System keinen Fehler oder eine Ausnahme aus. Stattdessen verhält es sich im Hintergrund so, als ob das Dokument nicht vorhanden ist. Verlassen Sie sich nicht ausschließlich auf Vererbungsstrukturen auf Ordnerebene, um Zugriff zu gewähren.

Überprüfen SharePoint Benutzerberechtigungen

  1. Lassen Sie den betroffenen Benutzer direkt zu dem genauen SharePoint Dokumentpfad wechseln, um zu überprüfen, ob er die Datei öffnen kann.
  2. Testen Sie die Abfrage mithilfe desselben Benutzerkontos in Microsoft 365 Copilot Chat. Wenn Microsoft 365 Copilot Chat keine Antwort abrufen kann, wird eine Berechtigungs- oder Suchindizierungsbarriere bestätigt.

Beheben fehlender SharePoint Benutzerberechtigungen

Ändern Sie die Berechtigungen, damit Benutzende auf die relevanten Websites und Dateien zugreifen können. Weitere Informationen finden Sie unter Freigabe und Berechtigungen im modernen SharePoint-Erlebnis.

Inhalte werden durch Vertraulichkeitsbezeichnungen, DKE oder ein Kennwort geschützt.

Die Agentebene SharePoint Wissensquelle respektiert Vertraulichkeitsbezeichnungen für das Kürzen von Berechtigungen und zeigt nur Inhalte mit Bezeichnungsberechtigungen für den angemeldeten Benutzer an. Allerdings kann der Agent keinen Inhalt extrahieren oder erden, dessen Schutz die Datei verschlüsselt. Diese Einschränkung umfasst Sensitivitätsetiketten, die Verschlüsselung anwenden, Doppelschlüsselverschlüsselung (DKE) und passwortgeschützte Dateien.

Solche Dokumente werden möglicherweise als "Bereit" in der Wissensquellliste angezeigt und können vom Benutzer in SharePoint geöffnet werden, aber dennoch "keine Antwort" zurückgeben, wenn der Agent um seinen Inhalt gebeten wird.

Überprüfen geschützter SharePoint Inhalte

  1. Öffnen Sie die Datei direkt in SharePoint oder ihrer Desktop-App, und überprüfen Sie, ob sie zur Eingabe eines Kennworts aufgefordert wird, den DKE-Schutz angibt oder eine verschlüsselte Vertraulichkeitsbezeichnung anzeigt.
  2. Fragen Sie nach Inhalten, die bekanntermaßen nur in nicht geschützten Dateien in derselben Quelle angezeigt werden. Wenn diese Abfragen erfolgreich sind, während Abfragen, die auf geschützte Dateien festgelegt sind, keine Antwort zurückgeben, ist der Schutz die Ursache.

Korrigieren von geschützten SharePoint Inhalten

  • Entfernen Sie die Verschlüsselung von Vertraulichkeitsbezeichnungen, DKE-Schutz oder Kennwort aus der Datei, wenn die Richtlinien Ihrer Organisation dies zulassen.
  • Veröffentlichen Sie eine ungeschützte Kopie der erforderlichen Inhalte an einem SharePoint Speicherort, auf den der Agent zugreifen kann.
  • Verweisen Sie die Wissensquelle auf einen SharePoint Speicherort, der keine verschlüsselten Inhalte enthält.

Wenn Sie eine SharePoint Website oder einen Ordner umbenennen, die von einer Wissensquelle auf Agentebene verwendet wird, kann die vorhandene Quellverknüpfung unterbrechen und zu einer Berechtigungslücke führen. In diesem Fall kann der Agent nicht auf die Knowledge Base zugreifen und keine Antwort zurückgeben.

  1. Bitten Sie Ihre SharePoint-Admin, die entsprechenden Berechtigungen für den umbenannten Speicherort zu erteilen und einen neuen Quelllink zu generieren.
  2. Öffnen Sie den Agent, und aktualisieren Sie die SharePoint Wissensquelle mit dem neu generierten Link.

Die App-Registrierung oder der Agent ist für SharePoint falsch konfiguriert.

Wenn Administratoren SharePoint Wissensquellen konfigurieren, müssen sie die Authentifizierung mithilfe einer Microsoft Entra ID App-Registrierung einrichten und zusätzliche Bereiche konfigurieren. Die App-Registrierung muss mindestens die Sites.Read.All Bereiche Files.Read.All angeben und diese Bereiche zusammen mit profile den Authentifizierungseinstellungen des Agents hinzufügen.openid Wenn Bereiche in der App-Registrierung oder in den Agent-Authentifizierungseinstellungen fehlen oder die Zustimmung nicht den erforderlichen Bereichen gewährt wird, gibt der Agent keine Ergebnisse oder Fehler oder Ausnahmen zurück. Für einen Benutzer sieht es so aus, als ob keine Dokumente gefunden wurden.

Important

Wenn die eingeschränkte SharePoint Suche für Ihren Mandanten aktiviert ist, wird die Verwendung von SharePoint als Wissensquelle unabhängig von der App-Registrierung oder Agentkonfiguration blockiert, und es werden keine Ergebnisse zurückgegeben. Bestätigen Sie mit Ihrem SharePoint-Admin, dass die eingeschränkte SharePoint Suche nicht aktiviert ist, oder fügen Sie die relevanten Websites zur Liste der zulässigen Websites hinzu.

Generative Antworten aus SharePoint Quellen stehen Gastbenutzern auch in SSO-fähigen Apps nicht zur Verfügung.

Beheben Sie eine falsch konfigurierte App-Registrierung oder Agent-Authentifizierung

Fügen Sie die erforderlichen Bereiche zur App-Registrierung und den Authentifizierungseinstellungen des Agents hinzu, und erteilen Sie die Zustimmung.

Das folgende Beispiel ist ein Verweis auf eine gut konfigurierte App-Registrierung:

Screenshot der Seite

Das folgende Beispiel zeigt die erforderlichen Authentifizierungseinstellungen in Copilot Studio:

Screenshot des Bereichs Copilot Studio Authentifizierung mit manuell ausgewählter Authentifizierung und den eingegebenen erforderlichen Bereichen.

Dateigrößenbeschränkungen für SharePoint generierende Antworten

Bei SharePoint-Quellen können generative Antworten nur Dateien mit einer Größe von bis zu 7 MB verarbeiten, wenn Sie im selben Mandanten wie Ihr Agent nicht über eine Microsoft 365 Copilot-Lizenz verfügen. Sie müssen auch das Mandantendiagramm-Erding mit der Semantik-Sucheinstellung deaktivieren.

Wenn Sie über eine Microsoft 365 Copilot-Lizenz im selben Mandanten wie Ihr Agent verfügen, beträgt die maximale Dateigröße 200 MB. Sie müssen auch das Mandantendiagramm-Erding mit semantischer Sucheinstellung aktivieren.

Größere Dateien können in SharePoint gespeichert werden und werden von einer Microsoft Graph-Suche zurückgegeben, aber nicht von generativen Antworten verarbeitet. Alternativ können Sie Ihre eigenen Dateien hochladen, die bis zu 512 MB groß sein können.

Eine Liste der Grenzwerte und unterstützten SharePoint-Funktionen finden Sie unter SharePoint-Web-App-Grenzwerte.

Behebung von Problemen mit der Dateigröße bei generativen Antworten in SharePoint

Wenn die für Ihr KI-Erlebnis relevanten Dateien die Größenbeschränkung überschreiten, möchten Sie möglicherweise alternative Architekturen in Betracht ziehen, z. B. die semantische Microsoft 365-Indizierung verwenden oder Ihre Daten mit Azure OpenAI verbinden, um generative Antworten zu erhalten.

SharePoint-Liste Quelle gibt keine Ergebnisse zurück.

Bei Wissensquellen auf Agentebene, die SharePoint Listen verwenden, können mehrere listenspezifische Faktoren dazu führen, dass der Agent keine Antwort zurückgibt, obwohl die Liste relevante Daten enthält.

  • Die Dataverse-Suche ist erforderlich. Copilot Studio Agents erfordern die Dataverse-Suche, um eine SharePoint-Liste als Wissensquelle zu verwenden. Wenn die Dataverse-Suche in der Umgebung deaktiviert ist, kann die Liste nicht abgefragt werden, und es werden keine Ergebnisse zurückgegeben. Weitere Informationen zum Aktivieren der Dataverse-Suche finden Sie unter Konfigurieren der Dataverse-Suche für Ihre Umgebung.
  • Die Listengröße wirkt sich auf Qualität und Latenz aus. Listen, die mehr als 35.000 Zeilen enthalten, können die Qualität der Ergebnisse beeinträchtigen und die Latenz erhöhen, die als keine Antwort für andernfalls gültige Abfragen vorhanden sein kann.
  • Zu viele Listen auf einem Agent. Sie können jeweils bis zu 10 Listen auswählen und für die besten Ergebnisse maximal 10 Listen pro Agent verwenden. Das Hinzufügen weiterer Listen erhöht die Wahrscheinlichung, dass relevante Inhalte nicht angezeigt werden.
  • Die Liste wird in den zuletzt verwendeten Listen nicht angezeigt. Wenn ein SharePoint-Liste mit freigegebenem Zugriff nicht in "Meine Listen" oder "Zuletzt verwendete Listen" im Browser angezeigt wird, öffnen Sie die Liste in SharePoint einmal, sodass sie in "Zuletzt verwendete Listen" angezeigt wird, oder fügen Sie die Listen-URL direkt in die URL-Auswahl ein, wenn Sie die Quelle hinzufügen.

Beheben SharePoint-Liste Quellprobleme

  1. Bitten Sie Ihren Administrator, die Dataverse-Suche in der Umgebung zu aktivieren, in der der Agent ausgeführt wird.
  2. Verringern Sie die Anzahl der Zeilen in der Liste, oder teilen Sie große Listen in kleinere, fokussierte Listen auf.
  3. Verringern Sie die Anzahl der Listen, die dem Agent zugeordnet sind, auf 10 oder weniger, und behalten Sie nur die Listen, die für die Themen relevant sind, die der Agent unterstützt.
  4. Fügen Sie Listen erneut hinzu, indem Sie ihre URL einfügen, wenn sie nicht automatisch in zuletzt verwendeten Listen angezeigt werden.

Filterbedingungen schließen den erwarteten Inhalt aus

Mit beiden Konfigurationspfaden können Sie einschränken, welche SharePoint Inhalte der Agent verwenden kann. Wenn diese Filter zu restriktiv oder falsch konfiguriert sind, gibt der Agent auch dann keine Antwort zurück, wenn übereinstimmende Inhalte vorhanden sind.

  • Quelle auf Agentebene, Filter für erweiterte Einstellungen. In einer Agentebene SharePoint Wissensquelle können Filter, die auf Titel, Autor, Geändert von oder Geändert basieren, den Inhalt ausschließen, den der Benutzer fragt. Filter, die an eine benutzerdefinierte Variable, Systemvariable oder Umgebungsvariable gebunden sind, können zur Laufzeit zu einem unbeabsichtigten Wert aufgelöst werden.
  • Knoten für generative Antworten auf Themenebene, nur ausgewählte Quellen durchsuchen. Wenn "Nur ausgewählte Quellen suchen " für einen Knoten "Generative Antworten erstellen " aktiviert ist, werden nur die in diesem Knoten ausgewählten Quellen verwendet. Wenn die erwartete SharePoint Quelle nicht in der Auswahl enthalten ist, gibt der Agent keine Antwort zurück, anstatt auf andere Wissensquellen zurückzufallen.

Überprüfen von Filterbedingungen

  1. Wählen Sie auf der Seite "Wissen" Ihre SharePoint Quelle aus, und wählen Sie dann"Erweiterte Einstellungen>" aus, um alle aktiven Filterbedingungen und die Werte zu überprüfen, in die sie aufgelöst werden.
  2. Öffnen Sie im Thema, in dem der Knoten "Generative Antworten erstellen" gehostet wird, dieEigenschaftendatenquelle> des Knotens, und bestätigen Sie sowohl die Einstellung "Nur ausgewählte Quellen suchen" als auch die ausgewählten Quellen.

Korrigieren von Filterbedingungen

  • Entspannen oder entfernen Sie Filterbedingungen, die den erwarteten Inhalt ausschließen.
  • Wenn ein Filter eine Variable verwendet, fügen Sie einen Debugschritt in der Unterhaltung hinzu, um zu bestätigen, dass die Variable zu dem Wert aufgelöst wird, den Sie zur Laufzeit erwarten.
  • Fügen Sie auf dem Knoten auf Themenebene entweder die erwartete SharePoint Quelle zu den ausgewählten Quellen hinzu, oder deaktivieren Sie die Suche nur ausgewählte Quellen, sodass auch Wissensquellen auf Agentebene abgefragt werden.

Durch Inhaltsmoderation in Copilot Studio blockierter Inhalt

Wenn sie Antworten generieren, moderieren Copilot Studio-Agents Inhalte, die unter die Schadenkategorien fallen. Wenn Inhalte moderiert werden, liefern generative Antworten keine Antwort oder einen Hinweis darauf, dass Inhalte moderiert wurden. Moderationsereignisse werden jedoch protokolliert, wenn der Agent so konfiguriert ist, dass Telemetriedaten an Azure Applications Insights gesendet werden.

Nachdem Sie Ihren Agenten mit Azure-App Insights verbunden haben, können Sie die folgende Abfrage in Kusto-Abfragesprache (KQL) verwenden, um herauszufinden, ob Inhalte gefiltert wurden:

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

Im folgenden Beispiel hebt die KQL-Abfrage einen Versuch hervor, generative Antworten zu verwenden, die durch Inhaltsmoderation gefiltert werden:

Screenshot eines Application Insights-Abfrageergebnisses mit einem generativen Antwortereignis mit dem Ergebnis

Blockierung generativer Antworten durch Inhaltsmoderation beheben

Verwandte Inhalte

  • Last updated on