Übersicht über die Microsoft 365 Copilot Search-API (Vorschau)

Die Microsoft 365 Copilot-APIs bieten Zugriff auf Komponenten, die Copilot-Umgebungen unterstützen. Mit diesen APIs können Sie Ihre benutzerdefinierten Engine-Agents und generativen KI-Lösungen mit Copilot-Funktionen erweitern. Die Copilot-Such-API ermöglicht Entwicklern die Durchführung einer hybriden Suche (semantisch und lexikalisch) in OneDrive für Arbeits- oder Schulinhalte mithilfe von Abfragen in natürlicher Sprache, die den Kontext und die Absicht verstehen, relevante Dokumente und Dateien zurückzugeben. Andere Datenquellen wie SharePoint, Copilot-Connectors und mehr werden derzeit von der Such-API nicht unterstützt, werden aber in zukünftigen Versionen hinzugefügt. Weitere Informationen zur semantischen Indizierung finden Sie unter Microsoft 365 Copilot semantischen Index.

Die Such-API bietet eine optimierte Lösung für die semantische Dokumentermittlung, ohne Ihre Daten in einer separaten Suchinfrastruktur replizieren, indizieren oder verwalten zu müssen. Die API wendet die Verarbeitung natürlicher Sprache an, um die Abfrageabsicht zu verstehen, und führt eine intelligente Ergebnisrangfolge durch, um die relevantesten Dokumente zu liefern. Diese Relevanz zu erreichen, ist bei herkömmlichen Schlüsselwort (keyword)-basierten Suchansätzen schwieriger.

Die semantische Suche ist unerlässlich, wenn Sie intelligente Lösungen zur Wissensermittlung erstellen und Microsoft 365-Inhalte anzeigen möchten. Wenn Sie die semantische Suche implementieren, können Ihre Lösungen eine genauere, kontextbezogenere Dokumentermittlung bereitstellen, die im umfangreichen Repository Ihrer Unternehmensdaten verankert ist. Die Such-API erreicht dies, indem relevante Dateien, Dateivorschauen und Dateimetadaten aus OneDrive für Geschäfts-, Schul- oder Uniinhalte bereitgestellt werden. Die Such-API hält Ihre Daten an Ort und Stelle und gewährleistet Ihre Zugriffs- und Governancekontrollen. Die Such-API stellt sicher, dass Suchergebnisse durch die neuesten und relevantesten Inhalte informiert werden. Dieser Prozess verbessert die Zuverlässigkeit und Nützlichkeit Ihrer benutzerdefinierten KI-gestützten Suchanwendungen.

Testen Sie Ihre erste Such-API-Abfrage in Graph Explorer.

Gründe für die Verwendung der Such-API

Die Such-API bietet eine sichere und konforme Möglichkeit, die Hybridsuche (semantisch und lexikalisch) in OneDrive für Arbeits- oder Schulinhalte durchzuführen und gleichzeitig kontextbezogene Relevanz und Benutzerabsicht zu optimieren. Daher müssen Sie keine Daten ausgibt, Berechtigungen unterbrechen oder Sicherheit und Compliance kompromittieren.

Benutzerdefinierte KI-gestützte Suchanwendungen können die Such-API verwenden, um in OneDrive gespeicherte Dokumente zu ermitteln. Anstatt separate Suchindizes zu erstellen und zu verwalten, können diese Anwendungen stattdessen Hybridsuchfunktionen auf OneDrive-Inhalte anwenden, um relevante Inhalte auf die gleiche Weise wie Microsoft 365 Copilot Search anzuzeigen.

Unternehmenswissensanwendungen, die eine intelligente Dokumentermittlung erfordern, können die Filterfunktionen der API verwenden, um Suchvorgänge auf bestimmte OneDrive-Pfade oder -Ordner zu beziehen. Dieser Ansatz stellt sicher, dass die Ergebnisse nur genehmigte Quellen umfassen, während Informationsbarrieren und Zugriffskontrollen beachtet werden.

Dokumentorientierte Anwendungen können semantisches Verständnis mit pfadbasierter Filterung kombinieren, um intuitive Suchfunktionen zu schaffen, die Benutzern helfen, die richtigen Dokumente schnell auf der Grundlage von Beschreibungen natürlicher Sprache zu finden, anstatt genaue Schlüsselwort (keyword) Übereinstimmungen.

Verwalten von Compliance- und Sicherheitsrisiken

Die Such-API verwendet die integrierten Sicherheits- und Compliancefeatures in Microsoft 365, um sicherzustellen, dass Datenquellenberechtigungen und Konformitätseinstellungen beibehalten werden. Durch das Durchsuchen von Daten an Ort und Stelle verhindert es Datenlecks und stellt sicher, dass vertrauliche Informationen nur für autorisierte Benutzer zugänglich sind. Diese Funktion ist für die Einhaltung strenger Sicherheits- und Compliancestandards unerlässlich. 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 Such-API die Hybridsuche direkt auf OneDrive-Inhalten ohne Datenduplizierung durchführt, werden die Ergebnisse aktuell und relevant gehalten. Es entfällt die Notwendigkeit, separate, kostspielige Suchinfrastrukturen zu verwalten.

Geringere Betriebskosten und Entwicklungsaufwand

Die Such-API entfällt die Notwendigkeit, eine sichere Datenexport- und Suchindizierungspipeline zu erstellen, die für Organisationen erhebliche Kosten verursachen kann. Die API unterstützt die folgenden erforderlichen Funktionen, einschließlich:

• Hybridsuche (semantisch und lexikalisch)
• Verarbeitung natürlicher Sprache
• Inhaltsindizierung
• Datenspeicher
• Pfadbasierte Filterung mit Keyword Query Language (KQL)
• Sicherheit und Compliance

Verwenden Sie diese integrierten Features, um Kosten und Komplexitäten zu vermeiden und strenge Zugriffskontrollen und Compliance in Microsoft 365 aufrechtzuerhalten.

Lizenzierung

Die Such-API ist für Benutzer mit einem Microsoft 365 Copilot-Lizenz-Add-On ohne zusätzliche Kosten verfügbar. Unterstützung für Benutzer ohne Microsoft 365 Copilot-Add-On-Lizenz ist derzeit nicht verfügbar.

Indem Sie auf die Microsoft 365 Copilot Search-API zugreifen oder diese verwenden, stimmen Sie den nutzungsbedingungen für Microsoft 365 Copilot APIs (Vorschau) zu.

Bewährte Methoden

Die folgenden bewährten Methoden gelten sowohl für ungefilterte Abfragen (Abfragen ohne ) filterExpressionals auch für gefilterte Abfragen (Abfragen mit einem filterExpression):

• Die Such-API gibt ergebnisse nach Relevanz sortiert zurück.
• Verwenden Sie alle von der Such-API zurückgegebenen Suchergebnisse für eine umfassende Dokumentermittlung.
• Vermeiden Sie übermäßig generische Abfragen, die für eine Vielzahl von Inhalten gelten könnten.
• Stellen Sie für ein besseres semantisches Verständnis so viel Kontext wie möglich in der Abfrage bereit.
• Erstellen Sie Ihre query beschreibende und natürliche Sprache.
• Vermeiden Sie Rechtschreibfehler in wichtigen Schlüsselwörtern, wenn Sie Ihre queryerstellen.

Wenden Sie die folgende bewährte Methode auf gefilterte Abfragen (Abfragen mit einem ) an filterExpression:

• Verwenden Sie für den path Parameter den vollständigen OneDrive-Pfad, der im Detailbereich der Datei oder des Ordners angezeigt wird (kein Freigabelink oder keine Browseradresse). Beispiel: https://contoso-my.sharepoint.com/personal/username_domain_com/Documents/Project/Report.docx.

Aktueller Bereich und Einschränkungen

Die folgenden Einschränkungen gelten derzeit für die Such-API:

• Der query Anforderungsparameter ist auf 1.500 Zeichen beschränkt.
• Nur OneDrive für Arbeit oder Schule wird als Datenquelle unterstützt.
• In werden nur path Ausdrücke unterstützt filterExpression. Weitere Keyword Query Language -Eigenschaften (KQL) werden in zukünftigen Versionen möglicherweise unterstützt.
• Der pageSize Anforderungsparameter hat einen maximalen Wert von 100.
• Bis zu 200 Anforderungen pro Benutzer und Stunde werden unterstützt.
• Die semantische Suche für nichttextuelle Inhalte, einschließlich Tabellen, Bildern und Diagrammen, wird nicht unterstützt.
• Die semantische Suche für Dateien mit .docx, .pptx und .pdf Erweiterungen, die größer als 512 MB sind, wird nicht unterstützt. Die semantische Suche für Dateien mit einer anderen Erweiterung, die größer als 150 MB ist, wird nicht unterstützt.
• Die semantische Suche ist für einen personalisierten Arbeitssatz von Daten für OneDrive-Inhalte verfügbar, der nicht alle Inhalte auf dem OneDrive des Benutzers enthält.
• Die semantische Suche ist nur für die folgenden Dateierweiterungen verfügbar: .aspx, .docx, .pptx, .pdf, .onepart, .doc, .html, .eml, .mp4, .loop, .one, .fluid, .png, .jpg, .json, .csv, .xml, .ppt.
• Die Such-API unterliegt allen Einschränkungen des Microsoft 365 Copilot semantischen Indexes.
• Wenn searchHits in der Antwortnutzlast leer ist, wurden keine relevanten Ergebnisse gefunden.

Nächster Schritt

Verwandte Inhalte

• Testen mit dem Graph-Explorer