Aktivieren oder Deaktivieren des semantischen Sortierers

Der semantische Sortierer ist ein Premium-Feature mit nutzungsbasierter Abrechnung. Standardmäßig ist der semantische Sortierer für alle Dienste deaktiviert.

Überprüfen der Verfügbarkeit

Überprüfen Sie auf der Seite Verfügbare Produkte nach Region der Azure-Website, ob Ihre Region aufgeführt ist.

Aktivieren der semantischen Rangfolge

Führen Sie die folgenden Schritte aus, um den semantischen Sortierer auf Dienstebene zu aktivieren. Nach der Aktivierung ist sie für alle Indizes verfügbar. Es ist nicht möglich, sie nur für bestimmte Indizes zu aktivieren oder zu deaktivieren.

Azure portal

1. Öffnen Sie das Azure-Portal.

2. Navigieren Sie zu Ihrem Suchdienst. Stellen Sie auf der Seite Übersicht sicher, dass der Dienst eine abrechnende Ebene, Basic oder höher ist.

3. Wählen Sie im linken Navigationsbereich die Option Semantische Rangfolge aus.

4. Wählen Sie entweder den kostenlosen Plan oder den Standardplan aus. Sie können jederzeit zwischen dem kostenlosen Plan und dem Standardplan wechseln.

   

Der kostenlose Plan ist auf 1.000 Abfragen pro Monat begrenzt. Nach den ersten 1.000 Abfragen im kostenlosen Plan werden Sie bei der nächsten Semantikabfrage per Fehlermeldung auf Ihr erschöpftes Kontingent hingewiesen. In diesem Fall müssen Sie ein Upgrade auf den Standardplan durchführen, um die semantische Rangfolge weiterhin verwenden zu können.

REST

Wenn Sie die semantische Rangfolge mithilfe der REST-API aktivieren möchten, können Sie die API zum Erstellen oder Aktualisieren von Diensten verwenden.

Aufrufe der REST-API für die Verwaltung werden über Microsoft Entra ID authentifiziert. Eine Anleitung für die Authentifizierung finden Sie unter Verwalten Ihres Azure KI Search-Diensts mit REST-APIs.

• Die Version 2023-11-01 der REST-API für die Verwaltung stellt die Konfigurationseigenschaft bereit.

• Zum Aktivieren oder Deaktivieren von Features sind Berechtigungen vom Typ „Besitzer“ oder „Mitwirkender“ erforderlich.

Hinweis

Für die Erstellung oder Aktualisierung werden zwei HTTP-Methoden unterstützt: PUT und PATCH. PUT und PATCH können zum Aktualisieren vorhandener Dienste verwendet werden, aber nur PUT kann zum Erstellen eines neuen Diensts verwendet werden. Falls PUT verwendet wird, um einen vorhandenen Dienst zu aktualisieren, werden alle Eigenschaften im Dienst durch ihre Standardwerte ersetzt, wenn sie in der Anforderung nicht angegeben sind. Falls PATCH verwendet wird, um einen vorhandenen Dienst zu aktualisieren, werden nur Eigenschaften ersetzt, die in der Anforderung angegeben sind. Wenn Sie PUT zum Aktualisieren eines vorhandenen Diensts verwenden, kann es vorkommen, dass versehentlich eine unerwartete Skalierung oder Konfigurationsänderung angewendet wird. Beim Aktivieren der semantischen Rangfolge für einen vorhandenen Dienst empfiehlt es sich, PATCH anstelle von PUT zu verwenden.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

Deaktivieren der semantischen Rangfolge mithilfe der REST-API

Wenn Sie die Aktivierung des Features rückgängig machen oder sich vor einer versehentlichen Nutzung und den entsprechenden Gebühren schützen möchten, können Sie die semantische Rangfolge deaktivieren. Verwenden Sie hierfür die API zum Erstellen oder Aktualisieren von Diensten für Ihren Suchdienst. Nachdem das Feature deaktiviert wurde, werden alle Anforderungen abgelehnt, die den Typ „Semantikabfrage“ enthalten.

Aufrufe der REST-API für die Verwaltung werden über Microsoft Entra ID authentifiziert. Eine Anleitung für die Authentifizierung finden Sie unter Verwalten Ihres Azure KI Search-Diensts mit REST-APIs.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Wenn Sie die semantische Rangfolge erneut aktivieren möchten, führen Sie die obige Anforderung erneut aus, und legen Sie „semanticSearch“ entweder auf „free“ (Standardwert) oder „standard“ fest.

Nächste Schritte

Konfigurieren Sie die semantische Rangfolge, um sie für Ihre Inhalte zu testen.