Hinzufügen von Microsoft 365 Copilot- und Agent-Erfahrungen

Gilt für: Entwickler

Mit SharePoint Embedded-Agent-Erfahrungen kann Ihre App Fragen zu Dateien beantworten, die in SharePoint Embedded-Containern gespeichert sind. Zwei getrennte Produkte basieren diese Erfahrungen auf Containerinhalten:

  • Microsoft Foundry Agent-Dienst mit einer SharePoint-Wissensquelle – für Agenten, die Sie auf Foundry aufbauen. Foundry führt den Abruf für Sie als Teil des Agenten durch. Setupschritte finden Sie unter Einrichten von SharePoint Embedded als Foundry-Wissensquelle.
  • Microsoft 365 Copilot Retrieval-API – für benutzerdefinierte Agents und Apps, die ihren eigenen Grounding-Schritt ausführen. Rufen Sie sie in einer beliebigen App auf, einschließlich eines Foundry-Agents, der die SharePoint-Wissensquelle nicht verwendet.

Wählen Sie die Wissensquelle aus, wenn Foundry den Abruf und die Orchestrierung der Agenten verwalten soll. Wählen Sie die Retrieval-API aus, wenn Sie den Grounding-Schritt, die Eingabeaufforderung und das Modell selbst steuern möchten.

Achtung

Das frühere SharePoint Embedded Agent SDK (das React-SteuerelementChatEmbedded) wurde im März 2026 verworfen und durch den Microsoft Foundry Agent-Dienst mit einer SharePoint-Wissensquelle (Vorschau) ersetzt, die für SharePoint Embedded konfiguriert ist. Verwenden Sie eine der beiden Optionen in diesem Artikel für neue Arbeiten.

Verwenden der Retrieval-API

Die Microsoft 365 Copilot Retrieval-API gibt relevante Textauszüge zurück, die Ihre App als Grounding-Daten an ihr eigenes Modell übergibt. Festgelegt dataSource auf sharePointEmbedded Abrufen aus SharePoint Embedded-Inhalten.

Hinweis

Die Unterstützung für die Abruf-API für die Datenquelle befindet sich in der sharePointEmbedded Vorschau.

Voraussetzungen für die Abruf-API

  • Eine SharePoint Embedded-App mit mindestens einem Container und der Containertyp-ID.
  • 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.

Die sharePointEmbedded Datenquelle rechnet nutzungsbasierte Zahlungen ab, sodass jeder Benutzer, der die Retrieval-API abfragt, keine individuelle Microsoft 365 Copilot Lizenz benötigt.

Abrufen von Inhalten aus einem Containertyp

Anruf POST /copilot/retrieval mit delegiertem Token. Legen Sie dataSource Ihre Containertyp-ID fest sharePointEmbeddeddataSourceConfigurationund übergeben Sie sie. Die Anforderung benötigt die FileStorageContainer.Selected delegierte Berechtigung, und der Dienst kürzt die Ergebnisse auf Inhalte, auf die der angemeldete Benutzer zugreifen kann.

POST https://graph.microsoft.com/v1.0/copilot/retrieval
Content-Type: application/json

{
  "queryString": "What are the terms of the Contoso agreement?",
  "dataSource": "sharePointEmbedded",
  "dataSourceConfiguration": {
    "sharePointEmbedded": {
      "containerTypeId": "{containerTypeId}"
    }
  }
}

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

Die Antwort gibt eine retrievalHits Auflistung zurück. Jeder Treffer identifiziert eine Quelldatei und webUrl enthält eine oder mehrere extracts, geordnet nach relevanceScore.

{
  "retrievalHits": [
    {
      "webUrl": "https://contoso.com/spe/file",
      "extracts": [
        {
          "text": "The agreement renews annually unless either party gives 30 days' notice.",
          "relevanceScore": 0.8421
        }
      ]
    }
  ]
}

Die Form von webUrl hängt von der Einstellung des Containertyps urlTemplate ab. Behandeln Sie ihn daher als nicht transparenten Link, anstatt ihn zu analysieren. Zum Auflösen von Dateidetails rufen Sie Get a driveItem auf. Weitere Informationen zu urlTemplatefinden Sie unter Erstellen und Konfigurieren eines Containertyps.

Wenn Sie zusätzliche Felder zurückgeben möchten, z. B title . oder author mit jedem Treffer, fügen Sie der Anforderung eine resourceMetadata Sammlung hinzu. Fordern Sie nur die Felder an, die von Ihrer App verwendet werden, da jedes Feld zur Antwortnutzlast beiträgt.

Übergeben Sie die Extrakte an Ihr eigenes Modell oder Ihren eigenen Antwortgenerierungsschritt als Grundlagendaten. Dieser Codeausschnitt sendet die Abfrage und liest den obersten Extrakt aus jedem Treffer:

const response = await fetch("https://graph.microsoft.com/v1.0/copilot/retrieval", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`
  },
  body: JSON.stringify({
    queryString: query,
    dataSource: "sharePointEmbedded",
    dataSourceConfiguration: {
      sharePointEmbedded: { containerTypeId: containerTypeId }
    }
  })
});

const data = await response.json();
const grounding = (data.retrievalHits ?? []).map(hit => ({
  url: hit.webUrl,
  text: hit.extracts?.[0]?.text?.trim(),
  score: hit.extracts?.[0]?.relevanceScore
}));

Der Abruf deckt jeden Container des Containertyps ab, auf den der angemeldete Benutzer zugreifen kann. Wenn eine Anforderung keine Treffer zurückgibt, vergewissern Sie sich, dass der semantische Index initialisiert wurde, dass die Indizierung abgeschlossen wurde und dass der Benutzer Zugriff auf den Inhalt hat.

Abruf-API-Abrechnung

Abrufen von API-Anforderungen, die die sharePointEmbedded Datenquellenrechnung auf der Copilot Studio-Nachrichtenanzeige verwenden. Die Gebühren richten sich nach dem Abrechnungsmodell, das für den Containertyp konfiguriert ist. Bei der Standard-Abrechnung wird das Azure-Abonnement des besitzenden Mandanten belastet, und bei der Pass-Through-Abrechnung wird das Abonnement des verbrauchenden Mandanten belastet.

Details zu Verbrauchseinheiten finden Sie unter Abrechnung von Verbrauchssteuern. Informationen zum Vergleichen von Modellen finden Sie unter Auswählen eines Abrechnungsmodells.

Testen der Benutzererfahrung

Melden Sie sich mit einem Benutzer an, der auf den Containerinhalt zugreifen kann. Laden Sie unterstützte Dateien in einen Container hoch, warten Sie auf die Indizierung, öffnen Sie den Chat, und stellen Sie Fragen, die der Dateiinhalt beantworten kann. Wenn die Antworten die erwarteten Dateien auslassen, überprüfe:

  • Erkennbarkeit.
  • Unterstützte Dateiformate.
  • App-Zugriff.
  • Benutzerzugriff.
  • Bereichsauswahl.
  • Verzögerung bei der Indizierung.

Nächste Schritte

  • Last updated on