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. Wenn Sie diese Funktion verwenden, stimmen Sie außerdem den Nutzungsbedingungen für die Vorschau der generativen KI zu ("Vorschaubedingungen"). 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

So erstellen Sie mit der Google Cloud Console eine allgemeine Empfehlungs-App:

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. Klicken Sie auf der Seite App erstellen unter Empfehlungsmechanismus auf Erstellen.

4. Geben Sie im Feld Anwendungsname einen Namen für die Anwendung ein. Die Anwendungs-ID wird unter dem Namen der Suchmaschine angezeigt.

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

6. Klicken Sie auf Weiter.

7. Wenn Sie eine Verbindung zu einem Datenspeicher herstellen möchten, wählen Sie auf der Seite Datenspeicher einen zuvor erstellten Datenspeicher aus oder erstellen Sie einen neuen. Führen Sie einen der folgenden Schritte aus:

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

   • 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.

8. 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 möglicherweise nicht verfügbar ist:

   • Mit Ihrem Datenspeichertyp ist nur eine Verbindung zu einer App möglich und der Datenspeicher ist bereits verbunden.
   • Ihr Datenspeicher und Ihre App befinden sich in verschiedenen 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 grundlegende Websitesuche, während für eine allgemeine Empfehlungs-App ein Datenspeicher mit erweiterter Websiteindexierung erforderlich ist.

9. 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 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.

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, den Sie der Empfehlungs-App hinzufügen möchten.

Nächste Schritte

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