App für allgemeine Empfehlungen erstellen

Hinweis: Dieses Feature ist ein Vorschauangebot, das den Pre-GA-Bedingungen in den Nutzungsbedingungen des GCP-Dienstes unterliegt. Pre-GA-Produkte und -Funktionen werden eventuell nur eingeschränkt unterstützt. Änderungen an Pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen Pre-GA-Versionen kompatibel. Weitere Informationen finden Sie unter den Beschreibungen der Startphase. Darüber hinaus stimmen Sie durch die Nutzung dieser Funktion den Nutzungsbedingungen für die Generative AI Preview ("Bedingungen für Vorschau"). Für diese Funktion können personenbezogene Daten gemäß dem Zusatz zur Verarbeitung von Cloud-Daten verarbeitet werden, vorbehaltlich der geltenden Einschränkungen und Verpflichtungen in der Vereinbarung (wie in den Vorschaubedingungen definiert).

Auf dieser Seite wird beschrieben, wie Sie eine allgemeine Empfehlungs-App erstellen.

Console

Wenn Sie die Google Cloud Console zum Erstellen einer generischen Empfehlungsanwendung verwenden möchten, folgen Sie diese Schritte:

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

   Zum Agent Builder

2. Klicken Sie auf der Seite Apps auf App erstellen.

3. Wählen Sie auf der Seite Anwendung erstellen die Option Empfehlungen aus.

4. Geben Sie im Feld Name Ihrer App einen Namen für die App ein. Ihre App-ID unter dem Suchmaschinennamen angezeigt.

5. Optional: Klicken Sie auf Bearbeiten, um die App-ID zu bearbeiten.

6. Achten Sie darauf, dass unter Inhalt die Option Generisch ausgewählt ist.

7. Klicken Sie auf Weiter.

8. Um eine Verbindung zu einem Datenspeicher herzustellen, wählen Sie auf der Seite Datenspeicher einen Datenspeicher aus, den Sie oder erstellen Sie einen neuen Datenspeicher. Führen Sie einen der folgenden Schritte aus:

   • Wählen Sie einen vorhandenen Datenspeicher aus, falls verfügbar. Ein Datenspeicher kann die nur mit einer App verknüpft ist und später nicht mehr aus der App entfernt werden kann.

   • Erstellen Sie einen neuen Datenspeicher und laden Sie Daten in ihn hoch. Klicken Sie dazu auf Datenspeicher erstellen und folgen Sie der Anleitung im Bereich Neuen Datenspeicher erstellen. Wählen Sie dann den neuen Datenspeicher aus. Weitere Informationen zum Erstellen eines Datenspeichers finden Sie unter Generischer Empfehlungsdatenspeicher erstellen.

9. Optional: Klicken Sie auf Erläuterung, um eine Liste der nicht verfügbaren Datenspeicher aufzurufen.

   Eine Tabelle mit einer Liste der Datenspeicher und dem Grund für ihre Nichtverfügbarkeit wird angezeigt. Hier sind einige Gründe, warum ein Datenspeicher nicht verfügbar:

   • Ihr Datenspeichertyp lässt nur die Verbindung zu einer App und den Daten zu Shop ist bereits verknüpft.
   • Ihr Datenspeicher und Ihre Anwendung befinden sich in unterschiedlichen Regionen.
   • Ihr Datenspeicher und Ihre App haben unterschiedliche Typen. Sie können beispielsweise keinen Mediendatenspeicher mit einer App für generische Empfehlungen verknüpfen.
   • Ihr Datenspeicher bietet eine einfache Websitesuche, während für eine allgemeine Empfehlungs-App ein Datenspeicher mit erweiterter Websiteindexierung erforderlich ist.

10. Klicken Sie auf Erstellen.

REST

Bevor Sie mit der Befehlszeile eine App erstellen können, benötigen Sie einen vorhandenen Datenspeicher. Wenn Sie noch keinen Datenspeicher haben, erstellen Sie einen. Folgen Sie dazu der Anleitung unter Allgemeinen Datenspeicher für Empfehlungen erstellen.

Hinweis: Diese Funktion befindet sich in der Entwicklungsphase.

So erstellen Sie eine Empfehlungs-App über die Befehlszeile:

1. Suchen Sie Ihre 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 Ihres Datenspeichers.

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

2. Erstellen Sie eine App und verbinden Sie sie mit einem Datenspeicher. Ein Datenspeicher kann nur mit einer App verknüpft werden und kann später nicht mehr aus der App entfernt werden.

   Wichtiger Begriff: In Vertex AI Search kann der Begriff App im Kontext von APIs synonym mit dem Begriff Engine verwendet werden.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.
   • APP_ID: Die ID der Empfehlungs-App, die Sie erstellen möchten.
   • APP_DISPLAY_NAME: der Anzeigename der Empfehlungs-App, die Sie erstellen möchten.
   • DATA_STORE_ID: die ID eines vorhandenen Empfehlungsdatenspeichers die Sie der Empfehlungs-App hinzufügen möchten.

Nächste Schritte

• Eine Vorschau, wie Ihre Empfehlungen angezeigt werden, finden Sie unter Empfehlungen erhalten.