Aktivieren oder Deaktivieren des semantischen Sortierers

Der semantische Sortierer ist ein Premium-Feature mit nutzungsbasierter Abrechnung. Standardmäßig ist der semantische Sortierer deaktiviert, wenn Sie einen neuen Suchdienst erstellen, aber jeder Benutzer mit der Berechtigung Mitwirkender kann ihn aktivieren. Wenn Sie vermeiden möchten, dass er versehentlich aktiviert wird, können Sie ihn über der REST-API deaktivieren.

Überprüfen der Verfügbarkeit

Informationen zum Überprüfen, ob der semantischer Sortierer in Ihrer Region verfügbar ist, finden Sie in der Liste der Azure KI-Suche-Regionen.

Aktivieren von Semantischer Sortierer

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 das Tarif auf Basic oder höher festgelegt ist.

3. Wählen Sie im linken Navigationsbereich Einstellungen>Semantischer Sortierer 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 Free-Plan erhalten Sie bei der nächsten Semantikabfrage eine Fehlermeldung mit dem Hinweis, dass Sie Ihr Kontingent aufgebraucht haben. Wenn das Kontingent erschöpft ist, müssen Sie ein Upgrade auf den Standard-Plan durchführen, um die semantische Rangfolge weiterhin verwenden zu können.

REST

Wenn Sie den semantischen Sortierer über die 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-Suche-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 des semantischen Sortierers über die REST-API

Wenn Sie die Funktion deaktivieren oder sich vor einer versehentlichen Nutzung und den entsprechenden Gebühren schützen möchten, können Sie den semantischen Sortierer deaktivieren. Verwenden Sie hierfür die API zum Erstellen oder Aktualisieren von Diensten für Ihren Suchdienst. Nachdem die Funktion 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-Suche-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"
      }
    }

Um den semantischen Sortierer erneut zu aktivieren, führen Sie die vorherige Anforderung erneut aus, und legen Sie semanticSearch entweder auf Free (Standard) oder Standard fest.

Nächster Schritt

Konfigurieren des semantischen Sortierers