Freigeben über


Aktivieren oder Deaktivieren des semantischen Sortierers

Der semantische Sortierer ist ein Premium-Feature mit nutzungsbasierter Abrechnung. Standardmäßig ist der semantische Rangfolger für einen neuen abrechnenden Suchdienst aktiviert und für den kostenlosen Plan konfiguriert, aber jede Person mit Mitwirkendenberechtigungen kann ihn deaktivieren oder den Abrechnungsplan ändern. Wenn Sie nicht möchten, dass jemand das Feature verwendet, können Sie es mithilfe der REST-API der Verwaltung deaktivieren. Wenn Sie die semantische Rangfolge deaktivieren, deaktivieren Sie auch den agentischen Abruf.

Ü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 vom semantischen Sortierer

Der semantische Rangierer ist möglicherweise für ältere Dienste nicht aktiviert. 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.

  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>Premium"-Features aus.

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

    Screenshot: Aktivieren der semantischen Rangfolge im Azure-Portal

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, können Sie ein Upgrade auf den Standardplan durchführen, um weiterhin die semantische Rangfolge zu verwenden.

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=2025-05-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