Benutzerdefinierte Empfehlungs-App erstellen

Hinweis: Diese Funktion ist ein Vorabangebot, das den Pre-GA-Angebotsbedingungen in den dienstspezifischen Nutzungsbedingungen für die GCP 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 in den Beschreibungen der Produkteinführungsphasen. Wenn Sie diese Funktion verwenden, stimmen Sie außerdem den Nutzungsbedingungen für die Vorabversion der generativen KI („Bedingungen für Vorabversionen“) zu. Für diese Funktion können personenbezogene Daten gemäß dem Zusatz zur Verarbeitung von Cloud-Daten, vorbehaltlich der geltenden Einschränkungen und Verpflichtungen in der Vereinbarung (wie in den Vorschaubedingungen definiert) verarbeitet werden.

Auf dieser Seite wird beschrieben, wie Sie eine benutzerdefinierte Empfehlungsanwendung erstellen.

Console

So erstellen Sie eine benutzerdefinierte Empfehlungsanwendung mit der Google Cloud Console: Folgen Sie diesen Schritten:

1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

   KI-Anwendungen

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 des Mechanismus angezeigt.

5. Optional: Klicken Sie auf Bearbeiten , um die Anwendungs-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 Datenspeicher mit strukturierten Daten aus oder erstellen Sie einen Datenspeicher. Führen Sie einen der folgenden Schritte aus:

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

   • Erstellen Sie einen neuen Datenspeicher für strukturierte Daten und nehmen Sie Daten auf. Klicken Sie dazu auf Datenspeicher erstellen und folgen Sie der Anleitung im Bereich Neuen Datenspeicher erstellen , der sich öffnet. Wählen Sie dann den neuen Datenspeicher aus. Weitere Informationen zum Erstellen eines Datenspeichers finden Sie unter Benutzerdefinierten Datenspeicher für Empfehlungen erstellen.

8. Optional: Wenn Sie eine Liste der nicht verfügbaren Datenspeicher aufrufen möchten, klicken Sie auf Gründe anzeigen.

   Eine Tabelle mit einer Liste der Datenspeicher und dem Grund, warum sie nicht verfügbar sind, wird angezeigt. Hier sind einige Gründe, warum ein Datenspeicher möglicherweise nicht verfügbar ist:

   • Ihr Datenspeichertyp lässt nur eine Verbindung zu einer Anwendung zu und der Datenspeicher ist bereits verbunden.
   • Ihr Datenspeicher und Ihre Anwendung befinden sich in verschiedenen Regionen.
   • Ihr Datenspeicher und Ihre Anwendung haben unterschiedliche Typen. Sie können beispielsweise keinen Mediendatenspeicher mit einer benutzerdefinierten Empfehlungsanwendung verbinden.
   • Ihr Datenspeicher hat eine einfache Website-Suche, während für eine benutzerdefinierte Empfehlungsanwendung ein Datenspeicher mit erweiterter Websiteindexierung erforderlich ist.

9. Klicken Sie auf Erstellen.

REST

Bevor Sie eine App über die Befehlszeile erstellen, müssen Sie einen vorhandenen Datenspeicher haben. Wenn Sie keinen Datenspeicher haben, erstellen Sie einen. Folgen Sie dazu der Anleitung unter Benutzerdefinierten Datenspeicher für Empfehlungen erstellen.

**Hinweis**: Diese Funktion ist experimentell.

So erstellen Sie eine Empfehlungsanwendung über die Befehlszeile:

1. Suchen Sie nach Ihrer Datenspeicher-ID. Wenn Sie die ID Ihres Datenspeichers bereits haben, fahren Sie mit dem nächsten Schritt fort.

   1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf und klicken Sie im Navigationsmenü auf Datenspeicher.

      Rufen Sie die Seite Datenspeicher auf.

   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 für strukturierte Daten. Ein Datenspeicher kann nur mit einer Anwendung verknüpft werden und kann später nicht mehr aus der Anwendung entfernt werden.

   Wichtiger Begriff: In Agent Search kann der Begriff App im Zusammenhang mit 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: die ID Ihres Google Cloud Projekts in.
   • APP_ID: die ID der Empfehlungsanwendung, die Sie erstellen möchten.
   • APP_DISPLAY_NAME: der Anzeigename der Empfehlungsanwendung, die Sie erstellen möchten.
   • DATA_STORE_ID: die ID eines vorhandenen Datenspeichers für Empfehlungen, den Sie der Empfehlungsanwendung hinzufügen möchten.

Nächste Schritte

• Eine Vorschau der Empfehlungen finden Sie unter Empfehlungen abrufen.