Einrichten von SharePoint Embedded als Foundry-Wissensquelle

Gilt für: Entwickler

Verwenden Sie den Microsoft Foundry Agent-Dienst mit einer SharePoint-Wissensquelle, wenn Ihre App eine geerdete Agent-Erfahrung über Dateien benötigt, die in SharePoint Embedded-Containern gespeichert sind.

Für SharePoint Embedded-Containertypen basiert die Wissensquelle Antworten über die allgemein verfügbare Microsoft 365 Copilot Retrieval-API. Foundry führt die Abrufaufrufe als Teil des Agents aus, sodass die gleichen Voraussetzungen, das gleiche Indizierungsverhalten und die gleiche Abrechnung gelten. Die sharePointEmbedded von Foundry verwendete Datenquelle befindet sich in der Vorschauphase. Um stattdessen Ihren eigenen Grounding-Schritt auszuführen, rufen Sie die Retrieval-API direkt auf, wie unter Verwenden der Retrieval-API beschrieben.

Hinweis

SharePoint-Wissensquellen für SharePoint Embedded befinden sich in der Vorschauphase.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Eine SharePoint Embedded-App mit mindestens einem Container.
  • Die Containertyp-ID für die SharePoint Embedded-App.
  • Ein Microsoft Foundry Agent-Dienstprojekt.
  • Für den Containertyp konfigurierte Abrechnung mit nutzungsbasierter Bezahlung.
  • Mindestens ein Benutzer im Mandanten mit einer Microsoft 365 Copilot-Lizenz, damit der semantische Index initialisiert wird. Weitere Informationen finden Sie unter Semantikindex für Microsoft 365 Copilot.
  • Berechtigung zum Aktualisieren der Containertypregistrierung in jedem nutzenden Mandanten, in dem der Agent auf Inhalte zugreifen muss.

Benutzer, die den Agent abfragen, benötigen nicht alle eine Microsoft 365 Copilot-Lizenz. Die Nutzungsabrechnungen auf der Nachrichtenanzeige in Copilot Studio und die Gebühren folgen dem Abrechnungsmodell, das für den Containertyp konfiguriert ist. Weitere Informationen finden Sie unter Abrechnungszähler.

Konfigurieren der SharePoint-Wissensquelle

Konfigurieren Sie die SharePoint-Wissensquelle Foundry mit remoteSharePointParameters.containerTypeId Ihrer SharePoint Embedded-Containertyp-ID.

Quellspezifische Konfigurationsdetails finden Sie unter Eigenschaften der SharePoint-Wissensquelle.

Erteilen Sie Foundry-Zugriff auf den Containertyp

Gewähren Sie Microsoft Foundry Lesezugriff auf Ihren Containertyp in jedem nutzenden Mandanten. Die Foundry-Anwendungs-ID lautet 880da380-985e-4198-81b9-e05b1cc53158.

Die besitzerführende Anwendung des Containertyps muss die Registrierungs-API im nutzenden Mandanten aufrufen.

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}/applicationPermissionGrants/880da380-985e-4198-81b9-e05b1cc53158
Content-Type: application/json

{
  "delegatedPermissions": ["readContent"],
  "applicationPermissions": ["none"]
}

Ersetzen Sie {fileStorageContainerTypeId} dies durch Ihre Containertyp-ID.

Sie können diese Berechtigung auch während der anfänglichen Containertypregistrierung erteilen, indem Sie den Endpunkt Containertypregistrierung erstellen verwenden.

Validieren des Abrufs

  1. Laden Sie unterstützte Dateien in einen SharePoint Embedded-Container hoch.
  2. Warten Sie auf Abschluss der Indizierung.
  3. Melden Sie sich als ein Benutzer an, der Zugriff auf den Containerinhalt hat.
  4. Stellen Sie dem Agenten eine Frage, die die hochgeladenen Dateien beantworten können.
  5. Vergewissern Sie sich, dass die Antwort auf dem erwarteten SharePoint Embedded-Inhalt basiert.

Wenn die Antwort die erwarteten Dateien auslässt, überprüfen Sie:

  • Containertypregistrierung im nutzenden Mandanten.
  • Erteilung von Berechtigungen für Foundry-Anwendungen.
  • Semantischer Index Initialisierung im Mandanten.
  • Benutzerzugriff auf den Container und die Dateien.
  • Unterstützte Dateiformate.
  • Einstellungen für die Auffindbarkeit von Inhalten.
  • Verzögerung bei der Indizierung.

Nächste Schritte

  • Last updated on