Freigeben über

Migrieren von Code für semantische Rangfolge aus früheren Versionen

  • Artikel

Wenn Ihr Code für semantische Rangfolge für frühe Vorschau-APIs geschrieben wurde, identifiziert dieser Artikel die Codeänderungen, die für die Migration zu neueren API-Versionen erforderlich sind. Breaking Changes für den semantischen Sortierer sind auf die Abfragelogik in den letzten APIs beschränkt. Wenn Ihr Code jedoch mit der ursprünglichen Vorschauversion geschrieben wurde, müssen Sie möglicherweise auch die semantische Konfiguration ändern.

Wichtige Änderungen

Es gibt zwei Breaking Changes für den semantischen Sortierer in den REST-API-Versionen:

  • searchFields wurde in 2021-04-30-preview durch semanticConfiguration ersetzt.
  • queryLanguage wurde ab 2023-07-01-preview ignoriert, wurde jedoch in 2024-11-01-preview für das Neuschreiben der Abfrage reaktiviert.

Andere versionsspezifische Updates beziehen sich auf neue Funktionen, unterbrechen jedoch keinen vorhandenen Code und sind daher keine Breaking Changes.

Wenn Sie Azure SDKs verwenden, wurden mehrere APIs im Laufe der Zeit umbenannt. Die Details sind in den SDK-Änderungsprotokollen enthalten.

API-Versionen mit semantischer Rangfolge

Überprüfen Sie Ihren Code auf die REST-API-Version oder SDK-Paketversion, um zu bestätigen, welche die semantische Rangfolge bereitstellt. Die folgenden API-Versionen verfügen über eine gewisse Unterstützung für die semantische Rangfolge.

Releasetyp REST-API-Version Aktualisierungen des semantischen Sortierers
initial 2020-06-30-preview Fügt queryType=semantic zu „Dokumente durchsuchen” hinzu
Vorschau 2021-04-30-preview Fügt semanticConfiguration zum Erstellen oder Aktualisieren des Index hinzu
Vorschau 2023-07-01-preview Aktualisiert semanticConfiguration. Ab dem 14. Juli 2023 wurden Updates für die von Microsoft gehosteten Semantikmodelle zum semantischen Sortierer sprachunabhängig gemacht, und die queryLanguage-Eigenschaft für die semantische Rangfolge wurde effektiv außer Betrieb genommen. Es gibt keinen Breaking Change im Code, die Eigenschaft wird jedoch ignoriert. Kunden wurde empfohlen, diese Eigenschaft aus dem Code zu entfernen.
Vorschau 2023-10-01-Vorschau Fügt semanticQuery hinzu, um eine Abfrage zu senden, die nur zu Neusortierungszwecken verwendet wird.
Stabil 2023-11-01 Allgemein verfügbar. Es wurden Änderungen an semanticConfiguration eingeführt, die zur stabilen Version führten. Wenn Ihr Code auf diese Version oder höher ausgerichtet ist, ist er mit neueren API-Versionen kompatibel, es sei denn, Sie übernehmen neue Previewfunktionen.
Vorschau 2024-05-01-Vorschau Keine Änderung
Stabil 2024-07-01 Keine Änderung
Vorschau 2024-09-01-preview Keine Änderung
Vorschau 2024-11-01-preview Fügt das Neuschreiben der Abfrage hinzu. Die queryLanguage-Eigenschaft ist jetzt erforderlich, wenn Sie das Neuschreiben der Abfrage (Vorschau) verwenden.

Änderungsprotokolle für Azure SDKs

Azure SDKs befinden sich in einem unabhängigen Veröffentlichungszeitplan. Überprüfen Sie die Änderungsprotokolle, um zu ermitteln, welche Pakete semantische Features bereitstellen und ob APIs umbenannt wurden.

2024-11-01-preview

  • Fügt das Neuschreiben der Abfrage zu „Dokumente durchsuchen” hinzu.
  • Erfordert queryLanguage für Workloads zum Neuschreiben der Abfrage. Eine Liste der gültigen Werte finden Sie in der REST-API.

2024-09-01-preview

Keine Änderungen an der Syntax der semantischen Rangfolge gegenüber der stabilen Version 2024-07-01.

2024-07-01

Keine Änderungen an der Syntax der semantischen Rangfolge gegenüber der Version 2024-05-01-preview.

Verwenden Sie diese API-Version nicht. Sie implementiert eine Vektorabfragesyntax, die mit einer neueren API-Version nicht kompatibel ist.

2024-05-01-Vorschau

Keine Änderungen an der Syntax der semantischen Rangfolge gegenüber der Version 2024-03-01-preview.

2024-03-01-Vorschau

Keine Änderungen an der Syntax der semantischen Rangfolge gegenüber der Version 2023-10-01-preview, aber es wurden Vektorabfragen eingeführt. Die semantische Rangfolge gilt jetzt für Antworten aus Hybrid- und Vektorabfragen. Sie können eine Neusortierung auf alle lesbaren Textfelder in der Antwort anwenden, vorausgesetzt, die Felder werden in prioritizedFields aufgeführt.

2023-11-01

  • Schließt SemanticDebug und semanticQuery aus, andernfalls identisch mit der Version 2023-10-01-preview.

2023-10-01-Vorschau

  • Fügt semanticQuery hinzu

2023-07-01-preview

  • Fügt semanticErrorHandling, semanticMaxWaitInMilliseconds hinzu.
  • Fügt der Antwort zahlreiche semantische Felder hinzu, z. B. SemanticDebug und SemanticErrorMode.
  • Ignoriert queryLanguage, wird nicht mehr in der semantischen Rangfolge verwendet.

Seit dem 14. Juli 2023 ist der semantische Sortierer sprachunabhängig. In Vorschauversionen wurde die Priorität von Ergebnissen, die nicht der von der Feldanalyse angegebenen querylanguage entsprachen, durch die semantische Rangfolge heruntergesetzt. Die queryLanguage-Eigenschaft gilt jedoch weiterhin für Rechtschreibkorrektur und die kurze Liste der Sprachen, die von diesem Feature unterstützt werden.

2021-04-30-preview

  • Die semantische Unterstützung erfolgt über die Vorschau-API-Aufrufe Dokumente durchsuchen und Erstellen oder Aktualisieren des Index.
  • Fügt semanticConfiguration zu einem Suchindex hinzu. Eine semantische Konfiguration hat einen Namen und eine priorisierte Feldliste.
  • Fügt „prioritizedFields” hinzu.

Die Eigenschaft searchFields wird nicht mehr zum Priorisieren von Feldern verwendet. Für alle zukünftigen Versionen ersetzt semanticConfiguration.prioritizedFields searchFields als Mechanismus zum Angeben, welche Felder für die L2-Rangfolge verwendet werden sollen.

2020-06-30-preview

  • Die semantische Unterstützung erfolgt über einen Vorschau-API-Aufruf Dokumente durchsuchen.
  • Fügt queryType=semantic zur Abfrageanforderung hinzu.
  • Passt searchFields so an, dass die searchFields-Eigenschaft, wenn der Abfragetyp semantisch ist, die Prioritätsreihenfolge von Feldeingaben an den semantischen Sortierer bestimmt.
  • Fügt captions, answers und highlights zur Abfrageantwort hinzu.

Nächste Schritte

Testen Sie die Migration der semantischen Konfiguration, indem Sie eine semantische Abfrage ausführen.

Erstellen einer Semantikabfrage