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.

Wie Agents in SharePoint Embedded eingesetzt werden

SharePoint Embedded erdet KI-Agenten für Unternehmensinhalte, während diese Inhalte und die Compliancekontrollen innerhalb des Microsoft 365-Mandanten des Kunden bleiben. Sie kopieren keine Inhalte in eine externe Vektordatenbank. Die wichtigsten Fakten:

• Die Auffindbarkeit von Inhalten ist eine Einstellung für den Containertyp, die bestimmt, ob Microsoft 365 Copilot den Inhalt anzeigen kann. Die Mandantengovernance steuert diese Einstellung, sodass eine App keine Inhalte durch Ändern der eigenen Konfiguration verfügbar machen kann.
• Rufen Sie Inhalte mit der Microsoft Search-API ab, eingegrenzt durch die Containertyp-ID (ContainerTypeId), oder mit einer Foundry SharePoint-Wissensquelle.
• Inhalte verbleiben im Microsoft 365-Mandanten des Kunden, sodass Microsoft Purview Data Loss Prevention (DLP), Aufbewahrung und eDiscovery gelten.
• Nichts wird automatisch verfügbar gemacht. SharePoint Embedded-Inhalte sind für Copilot erst verfügbar, wenn die Auffindbarkeit für den Containertyp aktiviert ist.

Informationen zum Entscheidungskontext finden Sie unter Boden-KI ohne externe Vektordatenbank.

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.

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

• Einrichten von SharePoint Embedded als Foundry-Wissensquelle
• Abrechnungszähler
• Abrechnungsmodell auswählen