Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Microsoft 365 Copilot-APIs bieten Zugriff auf Komponenten, die Copilot-Umgebungen unterstützen, und ermöglichen die Verbesserung Ihrer benutzerdefinierten Engine-Agents und generativen KI-Lösungen mit Microsoft 365 Copilot Funktionen. Mit der Microsoft 365 Copilot Retrieval-API können Sie Ihre generativen KI-Lösungen mit Ihrem Microsoft 365- und Nicht-Microsoft-Wissen erden, indem Sie relevante Textblöcke aus dem Hybridindex zurückgeben, der Microsoft 365 Copilot unterstützt.
Die Abruf-API bietet eine optimierte Lösung für Retrieval Augmented Generation (RAG) ohne die Notwendigkeit, Ihre Daten in einem separaten Index zu replizieren, zu indizieren, zu segmentieren und zu schützen. Die API versteht den Kontext und die Absicht des Benutzers und führt Abfragetransformationen durch, um die relevantesten Ergebnisse zu liefern, was mit lexikalischer Suche oder sogar grundlegenden RAG-Werten aus alternativen Quellen schwieriger zu erreichen ist.
RAG ist unerlässlich, wenn Sie generative KI-Lösungen erstellen und Microsoft 365-Wissen nutzen möchten. Wenn Sie RAG implementieren, können Ihre Lösungen genauere, kontextbezogenere Antworten liefern, die auf dem umfangreichen Repository Ihrer Organisationsdaten begründet sind. Die Abruf-API erreicht rag, indem aktuelle und relevante Textausschnitte aus SharePoint- und Copilot-Connectors extrahiert werden. Die Abruf-API hält Ihre Daten an Ort und Stelle und gewährleistet Ihre Zugriffs- und Governancekontrollen. Die Abruf-API stellt sicher, dass synthetisierte Antworten durch die neuesten und relevantesten Daten informiert werden. Dieser Prozess verbessert die Zuverlässigkeit und Nützlichkeit Ihrer generativen KI-Lösungen.
Probieren Sie Ihre erste Abfrage der Abruf-API in Graph Explorer aus.
Gründe für die Verwendung der Abruf-API
Die Abruf-API bietet eine sichere und konforme Möglichkeit, relevante Textblöcke von SharePoint- und Copilot-Connectors abzurufen und gleichzeitig die Kontextrückrufe zu optimieren. Daher müssen Sie keine Daten ausgibt, Berechtigungen unterbrechen oder Sicherheits- und Compliance-Kompromisse eingehen.
Benutzerdefinierte Wissensanwendungen können die Abruf-API verwenden, um Antworten auf organization spezifischen Informationen zu erstellen, die in SharePoint- und Copilot-Connectors gespeichert sind. Anstatt separate Vektorindizes zu erstellen und zu verwalten, können diese Anwendungen stattdessen relevanten Kontext aus Microsoft 365-Datenquellen abrufen, um LLM-Antworten (Large Language Model) auf die gleiche Weise wie Microsoft 365 Copilot zu grounden.
Finanz- und Rechtsanwendungen, die eine hohe Genauigkeit beim Abrufen von Informationen erfordern, können die Filterfunktionen der API verwenden, um Suchvorgänge auf bestimmte Dokumentbibliotheken oder Inhaltstypen zu beschränken, wobei sichergestellt wird, dass Antworten nur genehmigte Quellen enthalten, während Informationsbarrieren und Zugriffssteuerungen beachtet werden.
Anwendungen mit mehreren Quellen können SharePoint-Inhalte mit Informationen aus Microsoft 365 Copilot Connectors (früher Microsoft Graph-Connectors) kombinieren und so eine einheitliche Wissensdatenbank erstellen, die sowohl Microsoft 365- als auch Drittanbieterrepositorys umfasst, während konsistente Sicherheits- und Compliancekontrollen beibehalten werden.
Stellen Sie sich ein Beratungsunternehmen vor, das sich auf die Bereitstellung maßgeschneiderter Lösungen für seine Kunden spezialisiert hat, wobei sich ein erheblicher Teil seiner Arbeit auf in SharePoint gespeicherte Daten konzentriert. Das Unternehmen entwickelt einen benutzerdefinierten Engine-Agent, um seine Berater bei der Vorbereitung wichtiger Kundenbesprechungen zu unterstützen. Dieser Agent muss auf genaue und aktuelle Informationen aus SharePoint zugreifen und diese abrufen. Die Firma arbeitet mit zwei großen Kunden zusammen, die direkte Wettbewerber auf dem Markt sind. Daher hat das Unternehmen eine wichtige Notwendigkeit, strenge Sicherheits- und Compliancestandards einzuhalten, um sicherzustellen, dass die Dokumente und Daten eines Kunden niemals für den anderen zugänglich sind. Die Abruf-API hilft dem Unternehmen, Compliance- und Sicherheitsrisiken zu verwalten und sicherzustellen, dass die Daten relevant und aktuell sind, was wiederum den gesamten Entwicklungsaufwand vereinfacht.
Verwalten von Compliance- und Sicherheitsrisiken
Die Abruf-API verwendet die integrierten Sicherheits- und Compliancefeatures in Microsoft 365, um sicherzustellen, dass Datenquellenberechtigungen und Konformitätseinstellungen beibehalten werden. Durch das Abrufen von Daten an Ort und Stelle verhindert es Datenlecks und stellt sicher, dass vertrauliche Informationen von einem Client niemals für einen anderen zugänglich sind, was für die Einhaltung strenger Sicherheits- und Compliancestandards unerlässlich ist. Innerhalb eines organization stellt das Berechtigungsmodell von Microsoft 365 sicher, dass Personen nur Ergebnisse aus den Inhalten erhalten können, auf die sie zugreifen dürfen.
Lösung für Relevanz und Aktualität
Da die Abruf-API relevante Kontexte ohne Datenduplizierung abruft, werden die Ergebnisse aktuell und relevant gehalten, und es entfällt die Notwendigkeit, separate, kostspielige Datenpipelines zu verwalten.
Geringere Betriebskosten und Entwicklungsaufwand
Die Abruf-API entfällt die Notwendigkeit, eine sichere Datenexport- und Indizierungspipeline zu erstellen, die für Organisationen erhebliche Kosten verursachen kann. Die API enthält alle erforderlichen Funktionen, einschließlich:
- Suchanbieterverwaltung
- Kriechtiere
- Datenconnectors
- Datenspeicher
- Inhaltsparser
- Indizierung
- Sicherheit
Organisationen können diese integrierten Features verwenden, um Kosten und Komplexitäten zu vermeiden und strenge Zugriffskontrollen und Compliance in Microsoft 365 aufrechtzuerhalten.
Funktionen der Abruf-API
Mit der Abruf-API können Sie derzeit Daten aus den folgenden Datenquellen abrufen:
- SharePoint
- Copilot-Connectors
Die API unterstützt Abfragen in natürlicher Sprache und verwendet den Microsoft 365 Copilot-Stapel, um den relevanten Erdungskontext innerhalb der Microsoft 365-Vertrauensgrenze abzurufen. Sie können die API verwenden, um Ihren Abruf mithilfe der Schlüsselwortabfragesprache (Keyword Query Language, KQL) einzugrenzen, um aus den wichtigsten Inhalten für Ihren Anwendungsfall abzurufen. Mit KQL können Sie nach URLs, Datumsbereichen, Dateitypen und mehr filtern.
Lizenzierung
Die Abruf-API ist für Benutzer mit einer Microsoft 365 Copilot-Lizenz ohne zusätzliche Kosten verfügbar. Unterstützung für Benutzer ohne Microsoft 365 Copilot-Lizenz ist derzeit nicht verfügbar.
Bewährte Methoden
Die folgenden bewährten Methoden gelten sowohl für ungefilterte Abfragen (Abfragen ohne filterExpression) als auch für gefilterte Abfragen (Abfragen mit filterExpression):
- Die von der Abruf-API zurückgegebenen Ergebnisse und Extrakte sind ungeordnet. Aus diesem Grund wird empfohlen, die maximumNumberOfResults nicht einzuschränken, es sei denn, Sie haben strenge Anforderungen für die Anzahl der Token, die Ihre LLM nutzen kann.
- Senden Sie alle von der Abruf-API zurückgegebenen Extrakte zur Antwortgenerierung an Ihren LLM/Orchestrator.
- Vermeiden Sie generische Abfragen, die für eine Vielzahl von Inhalten gelten könnten.
- Geben Sie in der Abfrage so viel Kontext wie möglich an.
- QueryString sollte ein einzelner Satz sein.
- Vermeiden Sie Rechtschreibfehler in kontextreichen Schlüsselwörtern, wenn Sie Ihre queryString erstellen.
Wenden Sie die folgende bewährte Methode auf gefilterte Abfragen (Abfragen mit filterExpression) an:
- Wenn Sie in SharePoint mithilfe des path-Parameters filtern möchten, verwenden Sie keinen Freigabelink, und kopieren Sie die URL nicht aus der Adressleiste. Wechseln Sie stattdessen zum Speicherort des Ordners oder der Datei in SharePoint, und wählen Sie die drei Punkte aus, um Weitere Aktionen zu öffnen. Scrollen Sie im Bereich nach unten, und wählen Sie Details aus. Von dort aus können Sie auf der rechten Schiene nach unten scrollen, um die zu finden und den Pfad zu kopieren.
Bekannte Einschränkungen
Im Folgenden finden Sie die aktuelle Drosselung und andere Einschränkungen für die Abruf-API:
- Sie benötigen die Berechtigungen Files.Read.All und Sites.Read.All , um SharePoint-Inhalte mithilfe der Abruf-API abzurufen.
- Sie benötigen die Berechtigung ExternalItem.Read.All , um Inhalte von Copilot-Connectors mithilfe der Abruf-API abzurufen.
- Die Abruf-API ist für kontextbezogene Rückrufe optimiert.
- Der queryString-Anforderungsparameter ist auf 1.500 Zeichen beschränkt.
- Sie müssen jeweils aus einer Datenquelle abrufen, indem Sie den dataSource-Anforderungsparameter verwenden. Verschachtelte Ergebnisse werden nicht unterstützt.
- Wenn der filterExpression-Anforderungsparameter eine falsche KQL-Syntax aufweist, wird die Abfrage ohne Bereichsdefinition erfolgreich ausgeführt.
- Nicht alle SharePoint-Eigenschaften werden in filterExpression unterstützt. Die vollständige Liste der unterstützten Eigenschaften finden Sie in der API-Referenz .
- Der anforderungsparameter maximumNumberOfResults hat einen maximalen Wert von 25.
- Bis zu 200 Anforderungen pro Benutzer und Stunde werden unterstützt.
- Das Abrufen von nichttextuellen Inhalten, einschließlich Tabellen, Bildern und Diagrammen, wird nicht unterstützt.
- Ergebnisse aus Dateien mit .docx, .pptx und .pdf Erweiterungen, die größer als 512 MB sind, werden nicht unterstützt. Ergebnisse von Dateien mit einer anderen Erweiterung, die größer als 150 MB sind, werden nicht unterstützt.
- Wenn retrievalHits in der Antwortnutzlast leer ist, wurden keine relevanten Ergebnisse gefunden.