Medienempfehlungen hervorheben und unterdrücken

Auf dieser Seite wird erläutert, wie Sie die Rankingposition der vom Modell zurückgegebenen Medienempfehlungen mithilfe von Einstellungen für die optimierte Auslieferung ändern.

Mit einer Boost-Steuerung wird die Reihenfolge der Empfehlungen geändert, nachdem diese vom Modell zurückgegeben wurden. Sie wenden einen Filterausdruck auf die Ergebnisse an, um festzulegen, welche Empfehlungen Sie hervorheben oder unterdrücken möchten, und wenden dann einen Wert zwischen -1 und +1 an. Mit einem Wert von +1 wird einer Empfehlung der größte Höhepunkt verliehen, sodass sie an erster Stelle der zurückgegebenen Empfehlungen steht. Bei einem Wert von -1 wird die Empfehlung unten in der Liste der zurückgegebenen Empfehlungen angezeigt.

„Boost“ ist eine Steuerung für die Auslieferungszeit. Zuerst gibt das Empfehlungsmodell eine Liste mit Empfehlungen zurück. Mithilfe einer Bereitstellungskonfiguration wird die Funktion „Optimierung“ dann auf diese Liste angewendet, um das Ranking der Empfehlungen anzupassen. Mit der Funktion „Optimieren“ werden keine Empfehlungen hinzugefügt oder gelöscht. Sie steuert jedoch die Reihenfolge, in der die Empfehlungen dem Nutzer präsentiert werden.

Empfehlungen für die Steigerung der Sichtbarkeit im Vergleich zu Empfehlungen für die Filterung

„Sättigung“ ist ein weicher Filter. Der reguläre Filter für Empfehlungen, der unter Empfehlungen filtern beschrieben wird, ist ein strenger Filter.

Wenn Sie einen strikten Filter auf Empfehlungen anwenden, werden die herausgefilterten Dokumente nie angezeigt. Bei einem weichen Filter werden Dokumente jedoch nicht aus der Liste der Empfehlungen entfernt. Stattdessen wird mit dem Filter festgelegt, welche Dokumente in der Liste der zurückgegebenen Empfehlungen höher oder niedriger eingestuft werden sollen.

Vermeiden Sie eine Überlastung des Empfehlungsmodells

Wenn Sie einen Boost- oder Ausblendfilter anwenden, werden kleine Werte nahe Null empfohlen. Werte nahe +1 oder -1 überlasten das Empfehlungsmodell wahrscheinlich, sodass die vom Modell angewendete Empfehlungsrangfolge nicht in der Reihenfolge widergespiegelt wird, in der die Empfehlungen dem Nutzer angezeigt werden.

Wenn Sie beispielsweise animierte Filme um + 1 steigern, sehen Nutzer nur animierte Filme oben in der Empfehlungsliste. Nicht animierte Filme, die vom Modell stark empfohlen wurden, werden ans Ende der Liste verschoben, wo sie vom Nutzer möglicherweise nicht gesehen werden.

Herabstufung und Verstecken von Inhalten

Wenn Sie Empfehlungen herabstufen oder verstecken, werden sie in der Liste der zurückgegebenen Empfehlungen an eine niedrigere Position verschoben.

Die Herabstufung hängt jedoch davon ab, wie alt die Inhalte sind oder ob sich der Nutzer bereits einige davon angesehen hat. Weitere Informationen zur Herabstufung finden Sie unter Medienempfehlungen herabstufen.

Das Unterdrücken gilt für Inhalte, die durch einen Filter identifiziert wurden. Der Filter kann jedes Datenfeld sein, das im Schema als filterbar gekennzeichnet ist. Allgemeine Informationen zu Empfehlungsfiltern, einschließlich der Möglichkeit, ein Feld als filterbar zu kennzeichnen, finden Sie unter Filterempfehlungen.

Steuerelemente für die Anzeigenauslieferung und Bereitstellungskonfigurationen

Jede Auslieferungssteuerung für die Anzeigenauslieferung mit Anzeigen-Optimierung besteht aus einem Filter und einem Wert für die Anzeigenauslieferung mit Anzeigen-Optimierung. Mit einer solchen Einstellung werden beispielsweise Filme mit dem Begriff „Weihnachten“ im Titel mit einem Wert von 0.1 hervorgehoben und Horrorfilme mit einem Wert von -0.2 unterdrückt.

Nachdem Sie ein oder mehrere Steuerelemente für die Leistungssteigerung erstellt haben, hängen Sie sie an eine Bereitstellungskonfiguration an. Wenn eine Vertex AI Search App erstellt wird, wird automatisch auch eine Standardbereitstellungskonfiguration erstellt. Die Bereitstellungskonfiguration wird zum Zeitpunkt der Bereitstellung verwendet, um zu bestimmen, welche Ergebnisse die App generiert. Neben den Steuerelementen für die Anzeigenauslieferung kann die Bereitstellungskonfiguration auch andere Arten von Steuerelementen enthalten, z. B. Diversifizierungs- und Degradierungssteuerungen.

Die Bereitstellungskonfiguration kann angewendet werden, wenn Sie die Methode „recommend“ aufrufen. Alle Steuerelemente in der Bereitstellungskonfiguration werden dann auf die Empfehlungen angewendet, die vom Methodenaufruf zurückgegeben werden.

Außerdem können Sie Ihrer App mehrere Bereitstellungskonfigurationen zuordnen. So können Sie unter verschiedenen Umständen unterschiedliche Steuerelemente anwenden. Wenn die Empfehlungsanfrage beispielsweise von einem Kinderkonto stammt, sollten Filme in Kategorien, die für Kinder geeignet sind, hervorgehoben und ungeeignete Filme ausgeblendet werden. Wenn die Anfrage von einem Konto stammt, das als „nicht jugendfrei“ gekennzeichnet ist, sollten Sie Titel oder Kategorien bewerben, die bei Erwachsenen beliebt sind. Alternativ können Sie unterschiedliche Bereitstellungskonfigurationen für verschiedene Regionen festlegen und Inhalte entsprechend der regionalen Beliebtheit verstärken. Weitere Informationen zu Bereitstellungskonfigurationen findest du unter Bereitstellungskonfigurationen für Medien erstellen und verwalten.

Die Werte für die Steigerung sind additiv.

Wenn Sie einer Bereitstellungskonfiguration mehrere Bereitstellungssteuerungen hinzugefügt haben, werden die Steigerungen und Unterdrückungen addiert.

Wenn Sie beispielsweise animierte Kinderfilme um 0,3 und animierte Abenteuerfilme um 0,4 steigern, wird ein Film, der als animiertes Kinderabenteuer klassifiziert ist, um 0,7 erhöht.

Wenn ein Horrorfilm in derselben Auslieferungskonfiguration durch ein Steuerelement um 0,2 gesteigert und durch ein anderes um −0,3 herabgestuft wird, wird er insgesamt um −0,1 herabgestuft.

Die Summe der Steigerungen kann über +1 liegen. Wenn die Einstellungen beispielsweise animierte Kinderfilme um 0,6 und animierte Abenteuerfilme um 0,5 steigern, wird ein animierter Kinderabenteuerfilm um 1,1 gesteigert.

Beispiele für Filter

Im Folgenden finden Sie einige Beispiele für Filter für Medienempfehlungen.

Filter für häufig verwendete Schlüsseleigenschaften

Beispiele für Filter für gängige Schlüsselstring-Properties (category, image_name, image_uri, language, title und uri)

  • Animationen für Kinder:
    "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

  • Gruselige Medien:
    "filter": "categories: ANY(\"horror\", \"thriller\", \"crime\")

  • Medien mit dem Titel „Weihnachten“:
    "filter": "title: ANY(\"Christmas\")"

  • Medien, bei denen das erste Element im Array images den name „Strandball“ hat:
    "filter": "images[0].name: ANY(\"beach ball\")"

Filter nach Medienschlüsseleigenschaften

Beispiele für Filter für wichtige Medieneigenschaften Media-Schlüsseleigenschaften beginnen mit media_. In der Filtersyntax wird der Feldname mit media_key_properties. eingeleitet. Eine Liste der Media-Key-Eigenschaften findest du unter Vordefiniertes Google-Schema im Vergleich zum benutzerdefinierten Schema.

  • Medien vom Typ audio:
    "filter": "media_key_properties.media_type: ANY(\"audio\")"

  • Medien, in denen das Array „hash_tags“ den String #winter:
    enthält "filter": "media_key_properties.hash_tags: ANY(\"#winter\")"

  • Medien, bei denen das erste Element des Hashtags-Arrays der String #winter:
    ist "filter": "media_key_properties.hash_tags[0]: ANY(\"#winter\")"

Benutzerdefinierte Felder

Beispiele für Filter für benutzerdefinierte Felder Stellen Sie bei benutzerdefinierten Attributen dem Feldnamen das Präfix attributes. voran.

  • Sie haben in Ihrem Schema ein benutzerdefiniertes Stringfeld festival, das angibt, auf welchem Filmfestival ein Film seine Premiere hatte. So filtern Sie nur nach Filmen, die in Cannes ihre Premiere hatten:
    "filter": "attributes.festival: ANY(\"Cannes\")

  • Sie haben ein benutzerdefiniertes boolesches Feld audio_desc, das wahr ist, wenn die Medien eine Audiobeschreibung für sehbehinderte Zuschauer enthalten. So filtern Sie nach Medien mit Audiobeschreibung:
    "filter": "attributes.audio_desc: ANY(true)"

Einschränkungen bei filterbaren Feldern

Für die Einstellungen für die optimierte Auslieferung gelten die folgenden Einschränkungen:

  • Nur Property-Felder vom Typ „String“ und „Boolescher Wert“ können in Filterausdrücken für die Steigerung verwendet werden.

  • Sie können nicht nach Feldern filtern, die mehr als eine Ebene verschachtelt sind. Sie können beispielsweise nach persons.name filtern, aber nicht nach einem Feld persons.name.stage, auch wenn dieses Feld vorhanden ist.

  • Filter müssen genau übereinstimmen. Das bedeutet, dass in den Beispielen ein Film mit dem Titel „Christmas Story“ oder „CHRISTMAS“ nicht optimiert wird.

Hinweise

  • Sie müssen eine Anwendung für Medienempfehlungen und einen Datenspeicher erstellt haben. Weitere Informationen finden Sie unter App und Datenspeicher für Medienempfehlungen erstellen.

  • Optional: Wenn Sie die Standardbereitstellungskonfiguration nicht verwenden möchten, erstellen Sie eine neue Bereitstellungskonfiguration. Folgen Sie dazu den Schritten 1 bis 5 und 7 unter Bereitstellungskonfiguration erstellen. Wenn Ihre App in der Produktion ist, empfiehlt Google, eine separate Bereitstellungskonfiguration zum Testen der Boost-Steuerungen zu erstellen, bevor Sie die Steuerelemente auf Ihre Produktionsbereitstellungskonfiguration anwenden.

  • Achten Sie darauf, dass alle Felder, die Sie in der Boost-Steuerung verwenden möchten, im Schema als Filterbar gekennzeichnet sind. Weitere Informationen finden Sie unter Feldeinstellungen konfigurieren. Siehe auch Filtereinschränkungen.

Empfehlungen hervorheben oder unterdrücken

In diesem Verfahren wird beschrieben, wie Sie Boost-Steuerungen erstellen und an eine Bereitstellungskonfiguration anhängen.

Nachdem die Steuerelemente der Bereitstellungskonfiguration hinzugefügt wurden, können Sie die Bereitstellungskonfiguration beim Aufrufen der Methode servingConfigs.recommend angeben. Mit dem Steuerelement für die Steigerung wird dann die Reihenfolge der zurückgegebenen Empfehlungen beeinflusst.

REST

So erstellst du Steuerelemente für die optimierte Auslieferung und hängst sie an eine Bereitstellungskonfiguration an:

  1. Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.

  2. Suchen Sie die Datenspeicher-ID. Wenn Sie die Datenspeicher-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf und klicken Sie im Navigationsmenü auf Datenspeicher.

      Zur Seite „Datenspeicher“

    2. Klicken Sie auf den Namen des Datenspeichers.

    3. Rufen Sie auf der Datenseite Ihres Datenspeichers die Datenspeicher-ID ab.

  3. So erstellst du ein Boost-Steuerelement:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
-d '{
      "displayName": "CONTROL_DISPLAY_NAME",
          "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
          "boostAction": {
               "dataStore": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/dataStores/DATA_STORE_ID",
               "boost" :  BOOST_VALUE,
               "filter": "FILTER"
          }
    }'

    • PROJECT_NUMBER: die Nummer Ihres Google Cloud-Projekts.

    • CONTROL_DISPLAY_NAME: Ein menschenlesbarer Name, der das Steuerelement identifiziert. Muss ein UTF-8-String mit einer maximalen Länge von 128 Zeichen sein.

    • CONTROL_ID: Eine eindeutige Kennung (innerhalb eines Datenspeichers) für das Steuerelement. Die ID kann Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • DATA_STORE_ID: die ID des Vertex AI Search-Datenspeichers.

    • BOOST_VALUE: eine Gleitkommazahl im Bereich [−1,1]. Wenn der Wert negativ ist, werden Empfehlungen weiter unten in den Ergebnissen angezeigt. Ist der Wert positiv, werden Empfehlungen hervorgehoben (sie werden weiter oben in den Ergebnissen angezeigt).

    • FILTER: Der Filterausdruck, der beschreibt, welche Dokumente hervorgehoben oder verborgen werden sollen. Ausführliche Informationen zum Formulieren des Filterausdrucks finden Sie unter Filterausdrücke.

  4. Wiederholen Sie Schritt 3 für jedes Steuerelement für die Steigerung, das Sie auf Ihre Empfehlungen anwenden möchten. Beispielsweise können Sie ein Steuerelement für die Aufwertung von Filmen für Kinder, boost-kids, und ein zweites Steuerelement für die Unterdrückung von Horrorfilmen, bury-horror, verwenden.

  5. Suchen Sie die ID der Bereitstellungskonfiguration. Wenn Sie bereits eine ID für die Bereitstellungskonfiguration haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

      Zu Apps wechseln

    2. Klicken Sie auf der Seite Apps auf den Namen Ihrer App.

    3. Rufen Sie die Seite Konfigurationen auf und klicken Sie auf den Tab Bereitstellung.

    4. Rufen Sie die Bereitstellungskonfigurations-ID aus der Spalte ID ab.

  6. Hängen Sie die neue Steuerung für die optimierte Auslieferung mit einer Aktualisierungsanfrage mit der Methode engines.servingConfigs.patch an die Bereitstellungskonfiguration an.

    curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
-d '{
  "boostControlIds": ["CONTROL_ID"]
}'

    Ersetzen Sie Folgendes:

    • CONFIG_ID: Die ID der Auslieferungskonfiguration, der Sie die Boost-Steuerungen zuordnen möchten, z. B. my_app-1234567_id. Siehe vorherigen Schritt.

    • CONTROL_ID: Enthält die IDs einer oder mehrerer Boost-Auslieferungssteuerungen, die Sie der Auslieferungskonfiguration zuordnen möchten, z. B. "boost-kids", "bury-horror". Dies ist ein Array von Strings. Wenn Sie mehr als eine ID haben, vergessen Sie nicht, Anführungszeichen und Kommas als Trennzeichen zu verwenden.

  7. Warten Sie einige Minuten, bis die Änderungen wirksam werden.

  8. Sie können sich die Auswirkungen der Leistungssteuerung in der Vorschau ansehen. Weitere Informationen finden Sie unter Medienempfehlungen erhalten.

Boost-Steuerung aktualisieren

In diesem Verfahren wird beschrieben, wie Sie eine vorhandene Boost-Steuerung aktualisieren, um den Wert des Boosts oder des Filters zu ändern.

Nachdem Sie die Boost-Steuerung getestet haben, möchten Sie den Boost möglicherweise stärker oder schwächer machen. Alternativ können Sie auch den Filterstring ändern.

Wenn Sie einen Wert oder Filter für die Steigerung aktualisieren möchten, rufen Sie die Methode engines.controls.patch auf.

Bei der Patch-Methode werden die Werte von boost und filter durch die von Ihnen angegebenen neuen Werte ersetzt. In dieser Anleitung wird gezeigt, wie Sie den Wert für boost (Schritt 3) und den Wert für filter (Schritt 4) separat bearbeiten. Wenn Sie jedoch beide bearbeiten möchten, können Sie dies mit einem einzigen Curl-Befehl tun.

REST

So ändern Sie den Wert für den Filter für eine vorhandene Steuerung:

  1. Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.

  2. Ermitteln Sie mit der Methode engines.servingConfigs.get die ID der Leistungssteuerung, die Sie aktualisieren möchten. Wenn Sie die ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls"

    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

  3. Bearbeiten Sie den Boost-Wert für das Steuerelement:

    curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID?update_mask=boost_action.boost" \
-d '{
    "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID",
    "boostAction": {
      "boost": BOOST_VALUE
    }
}'

    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • CONTROL_ID: Die eindeutige Kennung für die zu bearbeitende Boost-Steuerung. Dies ist der letzte Teil des name-Felds, das durch den Befehl GET in Schritt 2 ausgegeben wird. Beispiel: boost-kids.

    • BOOST_VALUE: eine Gleitkommazahl im Bereich [−1,1]. Ist der Wert negativ, werden Empfehlungen weiter unten in den Ergebnissen angezeigt. Ist der Wert positiv, werden Empfehlungen hervorgehoben (sie werden weiter oben in den Ergebnissen angezeigt).

  4. Filter für die Boost-Steuerung bearbeiten:

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID?update_mask=boost_action.filter" \
-d '{
    "name": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID",
    "boostAction": {
      "filter": "FILTER"
    }
}'

    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • CONTROL_ID: Die eindeutige Kennung für die zu bearbeitende Boost-Steuerung. Dies ist der letzte Teil des name-Felds, das durch den Befehl GET in Schritt 2 ausgegeben wird.

    • FILTER: Der Filterausdruck, der beschreibt, welche Dokumente hervorgehoben oder verborgen werden sollen. Ausführliche Informationen zum Formulieren des Filterausdrucks finden Sie unter Filterausdrücke.

Steuerelement für die Leistungssteigerung löschen

In diesem Verfahren wird beschrieben, wie Sie ein Steuerelement für die Leistungssteigerung löschen. Wenn Sie eine Leistungssteigerungssteuerung nicht verwenden, sollten Sie sie löschen, damit Sie das Kontingent für die zulässige Anzahl von Steuerelementen nicht erreichen oder überschreiten.

Wenn Sie eine Boost-Steuerung löschen möchten, rufen Sie die Methode engines.controls.delete auf.

Steuerelemente für die Anzeigenauslieferung, die mit einer Bereitstellungskonfiguration verknüpft sind, können nicht gelöscht werden. Wenn Sie versuchen, eine Leistungssteigerung zu löschen, wird in einer Fehlermeldung der Name der Bereitstellungskonfiguration angezeigt. Sie müssen diese Bereitstellungskonfiguration dann löschen oder die Steuerung von der Bereitstellungskonfiguration trennen.

REST

So löschen Sie eine Leistungssteuerung:

  1. Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.

  2. Ermitteln Sie mit der Methode engines.servingConfigs.get die ID der Leistungssteuerung, die Sie löschen möchten. Wenn Sie die ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls"

    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

  3. Sehen Sie sich die Ausgabe an. Wenn die Optimierungssteuerung mit einer Bereitstellungskonfiguration verknüpft ist, aktualisieren Sie die Bereitstellungskonfiguration, um das Element zu entfernen, das Sie löschen möchten. Weitere Informationen finden Sie unter Auslieferungskonfiguration aktualisieren, um eine Boost-Steuerung zu entfernen.

  4. Führen Sie den folgenden curl-Befehl aus, um eine Leistungssteuerung zu löschen:

    curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls/CONTROL_ID"

    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • CONTROL_ID: Die eindeutige Kennung für die zu löschende Leistungssteuerung. Das ist der letzte Teil des name-Felds, das durch den Befehl GET in Schritt 2 ausgegeben wird.

    Wenn Sie eine Fehlermeldung erhalten, dass das Steuerelement von mindestens einer Auslieferungskonfiguration aktiv referenziert wird, lesen Sie den Hilfeartikel Auslieferungskonfiguration aktualisieren, um ein Steuerelement für die Leistungssteigerung zu entfernen.

Bereitstellungskonfiguration aktualisieren, um ein Steuerelement für die Steigerung zu entfernen

Bevor Sie ein Steuerelement für die Leistungssteigerung löschen können, müssen Sie es von allen Steuerelementen für die Bereitstellung trennen. Dazu müssen Sie die Bereitstellungssteuerungen patchen, um die ID der Boost-Steuerung zu entfernen.

So trennen Sie die Boost-Steuerungen von einer Bereitstellungskonfiguration:

  1. Welche Leistungssteigerungssteuerungen an die Bereitstellungskonfiguration angehängt sind, können Sie herausfinden, indem Sie eine engines.servingConfigs.get-Anfrage stellen und sich das Feld boostControlIds in der Antwort ansehen.

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID"

    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • CONFIG_ID: die ID der Bereitstellungskonfiguration, zu der Sie weitere Informationen benötigen.

  2. Wenn Sie die Bereitstellungskonfiguration aktualisieren möchten, um eine Optimierungssteuerung zu entfernen, verwenden Sie die Methode engines.servingConfigs.patch.

    curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
-d '{
  "boostControlIds": ["CONTROL_ID"]
}'

    • CONFIG_ID: Die ID der Auslieferungskonfiguration, der Sie die Boost-Steuerungen zuordnen möchten, z. B. my_app-1234567_id. Siehe vorherigen Schritt.

    • CONTROL_ID: Enthält die IDs einer oder mehrerer Leistungssteigerungssteuerungen, die in der Auslieferungskonfiguration enthalten sein sollen. Achten Sie darauf, keine Boost-Steuerelemente auszuwählen, die Sie löschen möchten. Dies ist ein Array von Strings. Wenn Sie mehr als eine ID haben, vergessen Sie nicht, Anführungszeichen und Kommas zu verwenden, z. B. boost-1", "boost-2.