Bereitstellungskonfigurationen erstellen

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungskonfigurationen erstellen. Eine Bereitstellungskonfiguration ist eine Bereitstellungsentität, die ein Modell oder eine Reihe von Steuerelementen verknüpft, die zum Generieren der Such- oder Empfehlungsergebnisse verwendet werden. Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Bereitstellungskonfigurationen.

Hinweise

Für Bereitstellungskonfigurationen für Empfehlungen und die Suche gelten unterschiedliche Anforderungen und Optionen:

  • Für Bereitstellungskonfigurationen für Empfehlungen ist ein Modell erforderlich. Wenn Sie ein vorhandenes Modell an eine neue Bereitstellungskonfiguration anhängen möchten, rufen Sie die ID des Modells ab, das Sie verwenden möchten. Dies ist erforderlich, wenn Sie die Methode ServingConfig.create verwenden.

    Wenn Sie die Bereitstellungskonfiguration über die Console erstellen, können Sie während des Erstellungsvorgangs ein neues Modell erstellen, anstatt ein vorhandenes Modell anzuhängen.

    Sie können später zu einem anderen Modell desselben Typs wechseln.

  • Für die Suche können Bereitstellungssteuerungen verwendet werden, sie sind jedoch nicht erforderlich. Wenn Sie vorhandene Einstellungen an eine neue Bereitstellungskonfiguration anhängen möchten, rufen Sie die IDs der Einstellungen ab, die Sie verwenden möchten.

    Wenn Sie die Bereitstellungskonfiguration über die Console erstellen, können Sie auch neue Kontrollvariablen erstellen.

    Sie können die Bereitstellungssteuerelemente in Ihrer Bereitstellungskonfiguration nach der Erstellung ändern oder hinzufügen.

Bereitstellungskonfiguration erstellen

Sie können eine Bereitstellungskonfiguration mit folgenden Methoden erstellen:

Pro Katalog sind bis zu 100 Bereitstellungskonfigurationen zulässig.

Die Suche funktioniert auch mit nicht konfigurierten Bereitstellungskonfigurationen. serving_config_id kann als Teil der Suchanfrage platziert werden. Mit default_search wird der Katalog mit der Standardsuchfunktion von Vertex AI Search for Commerce durchsucht.

Wenn Sie bestehende Placements haben oder neue Placements erstellen, wird automatisch eine mit jedem Placement verknüpfte Bereitstellungskonfiguration erstellt. Durch das Erstellen einer Bereitstellungskonfiguration wird kein entsprechendes Placement erstellt. Wenn Sie eine Bereitstellungskonfiguration löschen, wird auch das entsprechende Placement gelöscht. Wenn Sie ein Placement löschen, wird auch die entsprechende Bereitstellungskonfiguration gelöscht.

Bereitstellungskonfiguration in der Konsole erstellen

Fügen Sie eine neue Bereitstellungskonfiguration auf der Seite „Bereitstellungskonfigurationen“ in der Commerce-Konsole hinzu.

So erstellen Sie eine neue Bereitstellungskonfiguration:

  1. Rufen Sie in der Search for Commerce Console die Seite Bereitstellungskonfigurationen auf.

    Zur Seite „Bereitstellungskonfigurationen“

  2. Klicken Sie auf Bereitstellungskonfiguration erstellen.

    Empfehlungen

    1. Wählen Sie Recommendation als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.

    2. Geben Sie einen Namen für Ihre Bereitstellungskonfiguration an.

      Der Name darf höchstens 1.024 Zeichen lang sein und nur alphanumerische Zeichen, Unterstriche, Bindestriche und Leerzeichen enthalten.

    3. Optional: Aktualisieren Sie bei Bedarf die ID.

      Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss in Ihrem Projekt eindeutig sein. Sie darf maximal 50 Zeichen lang sein und keine Leerzeichen enthalten.

    4. Wählen oder erstellen Sie ein Modell, für das diese Bereitstellungskonfiguration Empfehlungen abgeben soll.

      Weitere Informationen zum Erstellen neuer Modelle

    5. Wählen Sie aus, wie stark Preis-Reranking die Empfehlungsergebnisse beeinflussen soll, sofern diese Option für das ausgewählte Modell verfügbar ist.

      Beim Preis-Reranking werden die empfohlenen Produkte mit einer ähnlichen Empfehlungswahrscheinlichkeit nach Preis sortiert, wobei die Elemente mit dem höchsten Preis zuerst aufgelistet werden. Die Relevanz wird ebenfalls verwendet, um Artikel zu sortieren. Daher entspricht das Aktivieren des Preis-Rerankings nicht dem Sortieren nach Preis.

    6. Wählen Sie aus, ob die regelbasierte oder die datenbasierte Ergebnisdiversifizierung verwendet werden soll:

      • Regelbasiert:Die regelbasierte Ergebnisdiversifizierung beeinflusst, ob die von einer einzelnen Vorhersageanfrage zurückgegebenen Ergebnisse aus verschiedenen Kategorien Ihres Produktkatalogs stammen.

      • Datengestützt:Bei der datengestützten Diversifizierung von Ergebnissen wird maschinelles Lernen verwendet, um ein Gleichgewicht zwischen Kategoriediversität und ‑relevanz in Ihren Vorhersageergebnissen herzustellen.

      Weitere Informationen finden Sie unter Ergebnisdiversifizierung.

    7. Wählen Sie aus, wie stark die Empfehlungsergebnisse diversifiziert werden sollen.

    8. Wenn Sie für diese Bereitstellungskonfiguration ein Modell für ähnliche Artikel ausgewählt haben, legen Sie fest, ob die Kategoriezuordnung aktiviert werden soll.

      Wenn der Kategorieabgleich aktiviert ist, werden nur Produkt-Ergebnisse zurückgegeben, die mindestens eine Kategorie mit dem Kontextprodukt gemeinsam haben. Die Kategoriezuordnung kann in Kombination mit anderen Filteroptionen wie Preis, Verfügbarkeit und Filter-Tags verwendet werden.

    1. Wählen Sie auf der Seite Bereitstellungskonfiguration erstellen Suche als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.
    2. Geben Sie einen Namen für die Bereitstellungskonfiguration an.

      Der Name darf höchstens 1.024 Zeichen lang sein und nur alphanumerische Zeichen, Unterstriche, Bindestriche und Leerzeichen enthalten.
    3. Optional: Aktualisieren Sie bei Bedarf die ID.

      Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss in Ihrem Projekt eindeutig sein. Sie darf maximal 50 Zeichen lang sein und keine Leerzeichen enthalten.
    4. Klicken Sie auf Weiter.
    5. Wählen Sie aus, ob das dynamische Attribut für diese Bereitstellungskonfiguration aktiviert werden soll.
    6. Wählen Sie Bereitstellungssteuerungen aus, um Ihre Suchanfragen zu optimieren.

      Weitere Informationen zu Steuerelementen finden Sie unter Steuerelemente erstellen und verwalten.

  3. Klicken Sie auf Erstellen, um die neue Konfiguration anzulegen.

    Die neue Konfiguration wird auf der Seite Bereitstellungskonfigurationen angezeigt.

    Es kann einige Minuten dauern, bis die Konfiguration für die Verwendung in Suchanfragen verfügbar ist. Sie ist sofort für Empfehlungen verfügbar.

  4. Optional: Klicken Sie auf der Seite „Bereitstellungskonfigurationen“ auf einen Namen für die Bereitstellungskonfiguration und gehen Sie zum Tab Bewerten, um eine Vorschau der Produkte anzuzeigen, die für diese Konfiguration zurückgegeben werden würden.

    Mithilfe der Bewertungsvorschau können Sie prüfen, ob Ihre Konfiguration die erwartete Leistung bringt.

Bereitstellungskonfiguration mit ServingConfig.create erstellen

Sie können eine Bereitstellungskonfiguration mit der API-Methode ServingConfig.create erstellen. Die API-Referenzdokumentation für diese Methode finden Sie unter ServingConfig.create.

Welche Felder Sie verwenden, hängt davon ab, ob Sie eine Bereitstellungskonfiguration für Empfehlungen oder die Suche erstellen.

Weitere Informationen zu den ServingConfig-Feldern finden Sie in der ServingConfigs API-Referenz.

Empfehlungen

Stellen Sie eine ServingConfig.create-Anfrage mit einer Serving-Konfigurations-ID und einer Instanz von ServingConfig, die im Anfragetext enthalten ist.

  • servingConfigId: erforderlich. Erstellt eine ID für Ihr ServingConfig. Dieser Wert sollte 4–63 Zeichen umfassen. Gültige Zeichen sind /[a-z][0-9]-_/.
  • displayName: erforderlich. Der für Menschen lesbare Name ServingConfig, der in der Search for Commerce Console angezeigt wird.
  • modelID: erforderlich. Die ID des Modells, das zur Bereitstellungszeit verwendet werden soll.
  • priceRerankingLevel: Optional. Legt fest, wie stark Preis-Reranking die Empfehlungsergebnisse beeinflussen soll. Zulässige Werte sind no-price-reranking (Standardwert, wenn nicht festgelegt), low-price-raranking, medium-price-reranking und high-price-reranking.
  • diversityLevel: Optional. Legt fest, wie stark die Empfehlungsergebnisse diversifiziert werden sollen. Zulässige Werte sind no-diversity (Standard), low-diversity, medium-diversity, high-diversity und auto-diversity. Wenn diversityLevel nicht festgelegt ist, ist die Diversität deaktiviert.
  • diversityType: Optional. Auf RULE_BASED_DIVERSITY festgelegt, um Empfehlungsergebnisse nach Produktkategorie zu diversifizieren. Auf DATA_DRIVEN_DIVERSITY festgelegt, um Empfehlungen auf Grundlage von Produktmetadaten zu diversifizieren und so ein Gleichgewicht zwischen Relevanz und Kategoriediversität zu schaffen. Wenn diversityLevel festgelegt, aber diversityType nicht festgelegt ist, wird diversityType standardmäßig auf „regelbasiert“ gesetzt. Weitere Informationen finden Sie unter Ergebnisdiversifizierung.
  • enableCategoryFilterLevel: Optional. Legt fest, ob dem Modell „Ähnliche Artikel“ zusätzliche Kategoriefilter hinzugefügt werden sollen. Zulässige Werte sind relaxed-category-match (Standardwert, wenn nicht festgelegt) und no-category-match.
  • solutionTypes: erforderlich. Auf SOLUTION_TYPE_RECOMMENDATION für Bereitstellungskonfigurationen für Empfehlungen festgelegt.
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"

Suchen

Stellen Sie eine ServingConfig.create-Anfrage mit einer Serving-Konfigurations-ID und einer Instanz von ServingConfig, die im Anfragetext enthalten ist.

  • servingConfigId: erforderlich. Erstellt eine ID für Ihr ServingConfig. Dieser Wert sollte 4–63 Zeichen umfassen. Gültige Zeichen sind /[a-z][0-9]-_/.
  • displayName: erforderlich. Der für Menschen lesbare Name ServingConfig, der in der Search for Commerce Console angezeigt wird.
  • facetControlIds: Optional. IDs von Steuerelementen, für die nur FacetSpec festgelegt ist.
  • dynamicFacetSpec.mode: Optional. Modus des Features DynamicFacet. Zulässige Werte sind DISABLED (Standardwert, wenn nicht festgelegt) und ENABLED.
  • boostControlIds: Optional. IDs von Steuerelementen für die Bereitstellung von Steigerungen.
  • filterControlIds: Optional. IDs der Steuerelemente für die Bereitstellung von Filtern.
  • redirectControlIds: Optional. IDs der Weiterleitungs-Bereitstellungseinstellungen.
  • twowaySynonymsControlIds: Optional. IDs von bidirektionalen Synonym-Serving-Kontrollgruppen.
  • onewaySynonymsControlIds: Optional. IDs von unidirektionalen Synonym-Serving-Steuerelementen.
  • doNotAssociateControlIds: Optional. IDs von nicht verknüpfenden Kontrollgruppen.
  • replacementControlIds: Optional. IDs der Ersatz-Bereitstellungssteuerungen.
  • ignoreControlIds: Optional. IDs der Steuerelemente für die Bereitstellung, die ignoriert werden sollen.
  • solutionTypes: erforderlich. Für Bereitstellungskonfigurationen für die Suche auf SOLUTION_TYPE_SEARCH festlegen.
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"

Nächste Schritte