REST-API-Versionen (Azure AI Search)

In diesem Artikel werden die aktuellen und früheren Versionen der Search-REST-APIs für Azure AI Search aufgeführt.

Versionsierte API-Dokumente

REST-API-Dokumente sind jetzt versionsiert. Wenn Sie eine API-Referenzseite öffnen, wird oberhalb des Inhaltsverzeichnisses eine Versionsauswahl angezeigt. Stellen Sie sicher, dass die API-Referenz aus dem Ordner "Reference>Data Plane" stammt.

Stabile Versionen

Vorschauversionen

Vorschauversionen werden veröffentlicht, um neue Funktionen zu testen, Feedback zu sammeln und Probleme zu ermitteln und zu beheben. Vorschau-APIs sind unter Ergänzende Nutzungsbedingungen für Microsoft Azure Previewsverfügbar.

Anmerkungen zur Version

2024-07-01

Diese Version bietet allgemein verfügbare Updates für integrierte Vektorisierung (Fähigkeiten und Vektorisierer), skalare Quantisierung und binäre Quantisierung. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2024-05-01-Vorschau

Diese Vorschau bietet Unterstützung für oneLake-Indizierung, Relevanzoptimierung und tiefere Integration mit mehr Einbettungsmodellen während der Indizierung und Abfragen. Es baut auf dem 2024-03-01-previewauf, sodass es auch die skalare Quantisierung, schmale Datentypen und Speicheroptionen enthält, die in dieser Version eingeführt wurden.

Um ein Upgrade von 2024-03-01-preview oder 2023-10-01-previewdurchzuführen, aktualisieren Sie die AzureOpenAIEmbedding-Fähigkeit oder den Vektorizer, um den Modellnamen und die Dimensionen einzuschließen. Informationen zum Upgrade von 2023-07-01-preview (veraltet) oder schrittweise Anleitungen finden Sie unter Upgrade-REST-APIs.

Hier sind die Updates in dieser Vorschau. Wir empfehlen auch Neuerungen in Azure AI Search.

2024-03-01-Vorschau

Diese Vorschauversion baut auf 2023-10-01-preview auf, indem Vorschau-APIs hinzugefügt werden, die den Vektorspeicher verbessern. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2023-11-01

Diese Version bietet allgemein verfügbare Features. Weitere Informationen finden Sie unter Neuerungen in Azure AI Search.

2023-10-01-Vorschau

Diese Version enthält alle Features, die in früheren Vorschauen eingeführt wurden, sowie Ergänzungen und Änderungen an Vektorsuch-APIs. Aktualisierungen der Vektorsuch-APIs sind eine bahnbrechende Änderung von 2023-07-01-Preview. Informationen zur Migrationshilfe finden Sie unter Hinzufügen von Vektorfeldern und Erstellen einer Vektorabfrage.

Wenn Sie die neue Vorfilterfunktion verwenden möchten, müssen Sie einen Index verwenden, der nach 2023-10-01 erstellt wurde.

erstellen oder aktualisieren:

• vectorSearch enthält Definitionen für algorithms, profilesund vectorizers:

  • algorithms unterstützt weiterhin hnsw und unterstützt jetzt auch eknn, in Bezug auf hierarchische Navigable Small World (HNSW) und erschöpfende K-nächste Nachbarn (eKNN). Im Abschnitt "Algorithmus" können Sie mehrere benannte Kombinationen von HNSW- und eKNN-Parametern definieren. Dadurch wird algorithmConfigurations innerhalb der eigenschaft vectorSearch in 2023-07-01-Preview ersetzt.

  • profiles ist eine neue Definition, die die Algorithmuskonfiguration angibt. Angenommen, Sie haben Algorithmuskonfigurationen namens HNSW-1, HSNW-2, eKNN-1. Ein Profil kann HNSW-1 angeben.

  • vectorizers wird in einem Index definiert, aber zur Abfragezeit zum Einbetten einer Textabfragezeichenfolge verwendet. Ein Vektorisierer verweist auf ein Einbettungsmodell. Der Suchdienst ruft das Einbettungsmodell auf, um die Textabfragezeichenfolge zu vektorisieren, und übergibt das Ergebnis dann an die Suchmaschine für eine Vektorabfrage.

• Bei Vektorfeldern ersetzt vectorSearchProfilevectorSearchConfiguration. Die eigenschaft vectorSearchProfile gibt an, welches Vektorsuchprofil für das Feld verwendet werden soll.

• Bei Indizes, die vor dieser API-Version erstellt wurden, müssen Sie beim Aufrufen der API 2023-10-01-Preview in Ihrer Anforderung das Feld ändern, um eine vectorSearchProfile anzugeben, solange das Profil den genauen Algorithmus angibt, der zuvor in vectorSearchConfigurationangegeben wurde. Wenn beispielsweise die vorhandene Felddefinition "vectorSearchConfiguration": "myHnsw"angibt, müssen Sie sie durch "vectorSearchProfile": "your profile name"ersetzen, und das Profil muss definiert werden, um auf dasselbe "algorithm": "myHnsw"zu verweisen.

Dokumentedurchsuchen:

• vectorQueries ersetzt vectors in 2023-07-01-Preview
• vectorQueries.vectors ersetzt vectors.values in 2023-07-01-Preview.
• Die Vektorabfrage ist jetzt eine polymorphe Struktur. kind muss angegeben werden, um den Typ der angeforderten Vektorabfrage anzugeben. "kind": "vector" bedeutet, dass die Abfrage ein Vektor ist, sodass der Aufrufer die Suchabfragezeichenfolge bereits in eine Vektoreinbettung vektorisiert haben sollte.
• "exhaustive": "true" ist eine neue Eigenschaft gibt an, ob eine vollständige (brute-force) k-nächste Nachbarsuche über alle Vektoren im Vektorindex hinweg erfolgen soll.
• vectorFilterMode ist ein neuer Parameter zum Angeben der Vorfilterung (Standard für Indizes, die nach 2023-10-01 erstellt wurden) oder das Postfiltern (Standard für vorherige Indizes) in der Abfrage.

Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2023-07-01-Vorschau

Diese Version hat die Vektorunterstützung eingeführt und eine Vektorkonfiguration verwendet, die mit neueren API-Versionen nicht kompatibel ist.

• Ein Collection(Edm.Single) Datentyp für Felder hinzugefügt, die ein Array mit Gleitkommazahlen mit einfacher Genauigkeit enthalten. Dies ist der Datentyp für Vektoren, der zum Speichern einer generierten Einbettung pro Dokumentfeld verwendet wird. Der Suchindex gibt auch Vektorkonfigurationseigenschaften an. Informationen zu diesen APIs finden Sie unter Erstellen oder Aktualisieren des Index-.
• Die Indizierung von Workloads wurde aktualisiert, um Vektordaten zu akzeptieren. Siehe Hinzufügen, Aktualisieren oder Löschen von Dokumenten.
• Abfrageparameter für die Vektorsuche hinzugefügt. Diese Parameter finden Sie unter "Dokumente durchsuchen".
• Abrufen von Dienststatistiken: Gibt das Vektorindexkontingent und die Verwendung für den Dienst zurück.
• Indexstatistik abrufen: Gibt das Vektorindexkontingent und die Verwendung für den Suchindex zurück.
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2021-04-30-Preview

Diese Vorschauversion enthält alle Features, die in 2020-06-30-Preview eingeführt wurden, sowie Ergänzungen zu den folgenden APIs:

• Indexalias fügt einen sekundären Namen hinzu, der für das Verweisen auf Indizes in Abfrage- und Indizierungsanforderungen verwendet wird. Aliasvorgänge umfassen "Erstellen", "Aktualisieren", "Löschen", "Abrufen" und "Liste".
• Verwaltete Identitäten für ausgehende Verbindungen. Neue Werte für Verbindungszeichenfolgen in Erstellen oder Aktualisieren der Datenquelle Verbindungen mithilfe der Microsoft Entra ID-Authentifizierung und -Rollen anstelle von hartcodierten Datenbankanmeldeinformationen oder Schlüsseln unterstützen.
• Die Unterstützung für verwaltete Identitäten wird auch für Schlüsseltresorverbindungen unterstützt, für Suchlösungen, die die Standardverschlüsselung mit vom Kunden verwalteten Verschlüsselungergänzen.
• Weitere Sprachen für die kognitive Fähigkeit zur Textübersetzung.
• Weitere queryLanguages for semantic search and speller in Search Documents (preview).
• Ein Captions-Parameter zum optionalen Anfordern von Beschriftungen aus der semantischen Suche in Suchdokumente (Vorschau).
• Semantikkonfigurationen werden in Create or Update Indexangegeben. Eine semantische Konfiguration bestimmt, welche Felder für semantische Rangfolge, Beschriftungen, Hervorhebungen und Antworten verwendet werden sollen.
• Ein semanticConfiguration-Parameter, der für semantische Abfragen in Suchdokumente (Vorschau)erforderlich ist.
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2020-06-30

Diese Version bietet allgemein verfügbare Features, einschließlich:

• Azure-rollenbasierte Zugriffssteuerung für Datenebenenvorgänge
• Relevanzbewertung (BM25)
• Wissensspeicher
• Indexer-Datenquelle für Azure Data Lake Storage (ADLS) Gen2
• Benutzerdefinierte Entitäts-Nachschlagefähigkeit
• Indexer, die unter einem System oder einer vom Benutzer verwalteten Identität über die Microsoft Entra-ID ausgeführt werden
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2020-06-30-Preview

Diese Vorschauversion enthält alle Features, die in 2019-05-06-Preview eingeführt wurden, sowie die folgenden Ergänzungen:

• Semantische Suche, ein Premium-Feature, das auf Standardebenendiensten ausgeführt wird und die semantische Rangfolge aufruft.
• Indexer-Datenquelle für Power Query-Connectors
• Indexer-Datenquelle für MySQL
• Indexer-Datenquelle für Cosmos DB Gremlin-API
• Indexer-Datenquelle für SharePoint Online
• Normalizer-Eigenschaft für die Textnormalisierung, für Filterung, Faceting und Sortierung zwischen Groß- und Kleinschreibung
• Zurücksetzen von Dokumenten für indexerbasierte Indizierung, um bestimmte Dokumente anhand der ID speziell zu aktualisieren
• Entity Linking cognitive skill (v3)
• Kognitive Fähigkeiten der Entitätserkennung (v3)
• Kognitive Fähigkeiten der Stimmungsanalyse (v3)
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

2019-05-06-Preview

• Unterstützung der Indexer-Datenquelle für Cosmos DB MongoDB-API
• Indexer-Datenquelle für vorläufiges Löschen im Blob Storage
• featuresMode-Parameter, der detaillierte Informationen zu einer Relevanzbewertung zurückgibt
• Kognitive Fähigkeiten von Azure Machine Learning (AML)
• Erkennung kognitiver Fähigkeiten
• Zwischenspeichern von erweiterten Dokumenten zum Beibehalten und Wiederverwenden der Bildverarbeitung (und anderer KI-Anreicherungen)
• Ab dem 29. März 2024 geben GET-Antworten keine Verbindungszeichenfolgen oder Schlüssel mehr zurück. Weitere Informationen finden Sie unter Grundlegende Änderung für Clientcode, der Verbindungsinformationen liest.

Siehe auch

• Erstellen eines Suchdiensts
• Schnellstart: Erstellen eines Azure AI Search-Index mithilfe von REST-APIs