Verwenden von SharePoint Inhalten für generative Antworten

Generative Antwortknoten, die SharePoint als Wissensquelle auf Themenebene nutzen, funktionieren, indem Ihr Agent mit einer SharePoint-URL, wie z. B. contoso.sharepoint.com/sites/policies, gekoppelt wird. Wenn ein Benutzer eine Frage stellt und die Agent kein Thema für eine Antwort hat, durchsucht die Agent die URL und alle Unterpfade. Beispielsweise enthält eine URL wie contoso.sharepoint.com/sites auch Unterpfade wie contoso.sharepoint.com/sites/policies. Generative Antworten fassen diese Inhalte zu einer zielgerichteten Antwort zusammen.

Wenn Sie Ihren Agenten veröffentlichen, werden die Anrufe mit generativen Antworten im Namen des Benutzenden getätigt, der mit dem Agenten chattet. Dabei werden die im Agenten konfigurierten Authentifizierungseinstellungen verwendet. Standardmäßig werden in Copilot Studio erstellte Agents und in Microsoft Teams mit der Authenticate with Microsoft authentication option konfiguriert, die in Umgebungen wie Microsoft Teams, Power Apps und Microsoft 365 Copilot funktioniert.

Verwenden von SharePoint in einem generierenden Antwortknoten

1. Füge in einem Thema einen generativen Antworten-Knoten hinzu.

2. Im generativen Antworten-Knoten des jeweiligen Themas öffnet man den Konfigurationsbereich der Datenquelle an einem von zwei Stellen:

   1. Wählen Sie im Knoten Generative Antworten erstellenBearbeiten unter Datenquellen aus.

      

   2. Alternativ wählen Sie im Knoten Generative Antworten erstellen die drei Punkte (...), dann wählen Sie Eigenschaften und wählen Sie Datenquelle.

3. Wählen Sie unter "Wissensquellen" die Option "Wissen hinzufügen" aus. Stellen Sie sicher, dass Nur ausgewählte Quellen durchsuchen aktiviert ist.

4. Wählen Sie im Abschnitt FeaturedSharePoint aus.

   

5. Geben Sie die SHAREPOINT-URL an. Trennen Sie mehrere URLs durch manuelle Zeilenumbrüche (verwenden Sie Umschalt + Eingabetaste).

   Note

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

6. Fügen Sie einen Namen und eine Beschreibung hinzu. Die Beschreibung sollte so detailliert wie möglich sein, insbesondere wenn generative KI aktiviert ist, da die Beschreibung die generative Orchestrierung unterstützt.

7. Wählen Sie oben Speichern aus, um die Änderungen an Ihrem Thema zu speichern.

8. Testen Sie Ihren Agent mit Sätzen, die Ihrer Meinung nach Inhalt zurückgeben werden.

   Note

   Wenn das Benutzerkonto, mit dem Sie sich bei copilotstudio.microsoft.com angemeldet haben, keinen Zugriff auf die SharePoint-Website hat, erhalten Sie keine Inhalte, oder es wird ein Systemfehler angezeigt.

Verwenden von Variablen als URLs

Verwenden Sie Variablen auf der öffentlichen Website oder SharePoint Wissensquell-URLs, um den Umfang der von Ihrem Agent verwendeten Inhalte dynamisch zu steuern.

Anstatt mehrere Wissensquellen für verschiedene Szenarien zu erstellen, definieren Sie eine einzelne Wissensquelle, und fügen Sie eine Variable in die URL ein. Zur Laufzeit löst Copilot Studio die Variable auf und verwendet die resultierende URL zur Verankerung.

Variable Unterstützung

Wenn Sie eine öffentliche Website oder SharePoint Wissensquell-URL hinzufügen oder bearbeiten, können Sie eine Variable in das URL-Feld einfügen.

Verwenden Sie eine Variable, um:

• Anfügen eines Pfads zu einer Basis-URL

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

• Ersetzen der gesamten URL

  {variable}

Zur Laufzeit wird die Variable in einen Zeichenfolgenwert aufgelöst. Die Wissensquelle ist auf die aufgelöste URL beschränkt.

Erstellen und Festlegen einer Variablen

So verwenden Sie eine Variable in einer öffentlichen Website oder SharePoint Wissensquelle:

1. Erstellen Sie eine Zeichenfolgenvariable mit globalem Bereich.

2. Legen Sie den Variablenwert mithilfe einer der folgenden Optionen fest:

   • Themeneingaben
   • Benutzerprofileigenschaften, z. B. Sprache
   • Umgebungsvariablen
   • Agentflüsse oder Verbindungen

3. Fügen Sie die Variable in das URL-Feld ein, indem Sie {x} (Variable einfügen) auswählen.

4. Testen Sie den Agent, um zu bestätigen, dass die Variable in die erwartete URL aufgelöst wird.

Beispiel: Bereich nach Produkt

Sie können das Wissen auf verschiedene Produktbereiche basierend auf der Abfrage des Benutzers einschränken.

1. Verwenden Sie eine Themeneingabe, um den Produktnamen als Variable mit dem Namen Productzu erfassen.

2. Fügen Sie nach dem Triggerknoten einen Variablenwertknoten "Set" hinzu, und erstellen Sie eine neue Variable mit dem Namen ProductTable.

3. Verwenden Sie eine Power Fx-Formel, um die Produktnamen zu URL-Pfaden zu definieren und zuzuordnen.

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

4. Fügen Sie einen weiteren Variablenwertknoten "Set" hinzu, und verwenden Sie ihn, um eine neue globale Zeichenfolgentypvariable namens GlobalProductURLzu erstellen.

5. Wählen Sie in der Einstellung "An Wert" die Option "Formel" aus, und verwenden Sie eine Power Fx-Funktion, um einen Nachschlagevorgang in der Tabelle basierend auf dem Wert der Product Eingabevariablen, Topic.Product, wie folgt auszuführen:

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

6. Verwenden Sie die Variable in der Wissensquell-URL:

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

Der Agent durchsucht zur Laufzeit nur den speziell definierten Abschnitt der Website.

Häufige Szenarien

Verwenden Sie Variablen in wissensquellen der öffentlichen Website für:

• Produktbasiertes Routing: Abfragen auf bestimmte Produktdokumentationen eingrenzen.

• Regional- oder Sprachfilter: Zuordnung von User.Language zu lokalisierten URLs (z. B. en-us, it-it).

• Umgebungsspezifische URLs: Wechseln zwischen Entwicklungs-, Test- und Produktionswebsites.

Überlegungen

• Wissensquellen der öffentlichen Website verwenden die Bing-Suche und basieren auf indizierten Inhalten.
• Die Grenzwerte für die URL-Tiefe gelten weiterhin, wenn Sie Variablen verwenden.
• Variablen ändern nur die Ziel-URL. Sie wirken sich nicht darauf aus, wie Inhalte indiziert oder abgerufen werden.

Erweiterte Authentifizierungsszenarien

Standardmäßig konfiguriert Copilot Studio Agents vor, um Benutzer mithilfe der Microsoft-Authentifizierung für den Zugriff auf SharePoint Quellen zu authentifizieren, wenn sie über Microsoft Teams, Power Apps oder Microsoft 365 Copilot eine Verbindung mit einem Agent herstellen. Wenn Sie die Authentifizierung jedoch manuell konfigurieren müssen, sind die folgenden Schritte erforderlich, um generierende Antworten für die Arbeit mit SharePoint Datenquellen zu erhalten.

• Generative Antworten aus SharePoint Quellen sind für guest Benutzer in SSO-fähigen Apps nicht verfügbar.

• Informationen zum Authentifizieren Ihrer Agent finden Sie unter Authentifizierung.

• Anweisungen zum Erstellen der erforderlichen Microsoft Entra ID Anwendungsregistrierung finden Sie unter Configure-Benutzerauthentifizierung mit Microsoft Entra ID. Beim Erstellen dieser Registrierung müssen Sie oder Ihr Administrator die Bereiche Sites.Read.All und Files.Read.All in der Microsoft Entra ID-App-Registrierung angeben.

• Wenn Sie Keine Authentifizierung auswählen, gibt das an, dass Ihr Agent keine Informationen aus SharePoint abruft.

• Wenn Sie die Authentifizierung konfigurieren, steuern Gültigkeitsbereiche den Benutzerzugriff. Geben Sie Sites.Read.All und Files.Read.All im Bereichsfeld in der Nähe der vorhandenen Werte profile und openid in Copilot Studio an. Diese Berechtigungsbereiche gewähren den Benutzern keine erhöhten Berechtigungen beim Verwenden des Agenten, erlauben jedoch, dass ihre berechtigten Inhalte von der SharePoint-Website so konfiguriert sind, dass sie für generative Antworten verwendet werden.

• SharePoint unterstützt die Einstellung Authenticate manuell mit den folgenden Authentifizierungsdienstanbietern:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 mit Verbundidentität
  • Microsoft Entra ID V2 mit Zertifikaten
  • Microsoft Entra ID V2 mit geheimen Clientschlüsseln

• SharePoint unterstützt keine manuelle Authentifizierung mit generischem OAuth.

• Diese Konfiguration gilt nur für generative Antworten und nicht für Power Platform-Connectors.