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 dienstweit mithilfe der Verwaltungs-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.
Öffnen Sie das Azure-Portal.
Navigieren Sie zu Ihrem Suchdienst. Stellen Sie auf der Seite Übersicht sicher, dass das Tarif auf Basic oder höher festgelegt ist.
Wählen Sie im linken Navigationsbereich Einstellungen>Semantischer Sortierer aus.
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.
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.