Erste Schritte mit der allgemeinen Suche

Vertex AI Search führt die Leistungsfähigkeit von umfassenden Informationsabrufen und hochmodernem Natural Language Processing sowie die aktuellen Fortschritte im Bereich Large Language Processing zusammen, um Nutzerabsichten zu verstehen und hoch relevante Ergebnisse zurückzugeben.

Mit Vertex AI Search können Sie Anwendungen für die Suche und für Empfehlungen erstellen. Vertex AI Search bietet auch für einige Branchen wie Medien, Gesundheitswesen und Einzelhandel Sonderfunktionen.

In dieser Anleitung geht es vorrangig um das Erstellen einer Such-App für allgemeine Daten. also Daten, die nicht branchenspezifisch sind.

In dieser Anleitung wird erläutert, wie Sie Such-Apps für verschiedene Arten von Daten erstellen:

  • Websitedaten aus dem Crawling von cloud.google.com/generative-ai-app-builder/
  • Strukturierte Daten in Form eines NDJSON-formatierten Datasets, das aus einem Cloud Storage-Bucket aufgenommen wurde
  • Unstrukturierte Daten in Form von PDFs, die aus einem Cloud Storage-Bucket aufgenommen wurden

Bevor Sie mit dieser Anleitung beginnen, führen Sie die Schritte unter Bevor Sie beginnen aus.


Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt in der Google Cloud Console aufzurufen.

Anleitung


Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.

    Enable the APIs

Vertex AI Agent Builder aktivieren

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

    Zum Agent Builder

  2. Lesen und akzeptieren Sie die Nutzungsbedingungen und klicken Sie anschließend auf Fortfahren und API aktivieren.

Datenspeicher erstellen

Zuerst erstellen Sie einen Datenspeicher mit den Daten, die Ihre Such-App indexieren wird.

Klicken Sie auf den Tab für die Art der Daten, die Sie in Ihren Datenspeicher aufnehmen möchten: Website, strukturiert oder unstrukturiert.

Websitedaten

  1. Rufen Sie die Seite Datenspeicher erstellen auf.

    Agent Builder – Datenspeicher erstellen

  2. Wählen Sie im Bereich Datenquelle auswählen die Option Website-Inhalt aus.

  3. Stellen Sie im Bereich Geben Sie die Websites für den Datenspeicher an sicher, dass die erweiterte Websiteindexierung deaktiviert ist.

  4. Geben Sie in das Feld Einzuschließende Websites Folgendes ein:

    cloud.google.com/generative-ai-app-builder/*
    
  5. Klicken Sie auf Weiter.

  6. Wählen Sie im Bereich Datenspeicher konfigurieren als Standort für den Datenspeicher global aus.

  7. Geben Sie einen Namen für den Datenspeicher ein. Notieren Sie sich die generierte ID. Sie benötigen diese Informationen später.

  8. Klicken Sie auf Erstellen.

Strukturierte Daten

  1. Rufen Sie die Seite Datenspeicher erstellen auf.

    Agent Builder – Datenspeicher erstellen

  2. Wählen Sie im Bereich Datenquelle auswählen die Option Cloud Storage aus.

  3. Wählen Sie im Bereich Daten aus Cloud Storage importieren die Option Strukturierte Daten (JSONL) aus.

  4. Achten Sie darauf, dass Datei ausgewählt ist.

  5. Geben Sie im Feld gs:// den folgenden Wert ein:

    cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson
    

    Dieser Cloud Storage-Bucket enthält eine NDJSON-formatiertes Datei mit Filmen, die von Kaggle zur Verfügung gestellt werden.

  6. Klicken Sie auf Weiter.

  7. Weisen Sie die wichtigsten Attribute so zu:

    Feldname Schlüsselattribut
    homepage uri
    overview description

    und klicken Sie auf Weiter.

  8. Wählen Sie im Bereich Datenspeicher konfigurieren als Standort für den Datenspeicher global aus.

  9. Geben Sie einen Namen für den Datenspeicher ein. Notieren Sie sich die generierte ID. Sie benötigen diese Informationen später.

  10. Klicken Sie auf Erstellen.

Unstrukturierte Daten

  1. Rufen Sie die Seite Datenspeicher erstellen auf.

    Agent Builder – Datenspeicher erstellen

  2. Wählen Sie im Bereich Datenquelle auswählen die Option Cloud Storage aus.

  3. Wählen Sie im Bereich Daten aus Cloud Storage importieren die Option Unstrukturierte Dokumente (PDF, HTML, TXT usw.) aus.

  4. Achten Sie darauf, dass Ordner ausgewählt ist.

  5. Geben Sie im Feld gs:// den folgenden Wert ein:

    cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs
    

    Dieser Cloud Storage-Bucket enthält PDF-Dateien mit Abrechnungen von der Alphabet-Investorenwebsite.

  6. Wählen Sie im Bereich Datenspeicher konfigurieren als Standort für den Datenspeicher global aus.

  7. Geben Sie einen Namen für den Datenspeicher ein. Notieren Sie sich die generierte ID. Sie benötigen diese Informationen später.

  8. Klicken Sie auf Erstellen.

Suchanwendung erstellen

Als Nächstes erstellen Sie eine Such-App und verknüpfen den zuvor erstellten Datenspeicher.

Websitedaten

  1. Rufen Sie die Seite App erstellen auf.

    Agent Builder – App erstellen

  2. Klicken Sie unter Website suchen auf Erstellen.

  3. Die Funktionen der Enterprise-Version müssen aktiviert sein.

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

  5. Geben Sie im Feld Externer Name Ihres Unternehmens oder Ihrer Organisation den Namen des Unternehmens oder der Organisation ein. Für diese Anleitung können Sie Google Cloud verwenden, da die App auf einer Google Cloud-Website sucht.

  6. Wählen Sie als Standort für Ihre Anwendung Global aus und klicken Sie dann auf Weiter.

  7. Wählen Sie in der Liste der Datenspeicher den Datenspeicher aus, den Sie zuvor erstellt haben, und klicken Sie dann auf Erstellen.

  8. Rufen Sie die Seite Daten Ihrer App auf, um die Liste der indexierten Websites aufzurufen und bei Bedarf zu ändern.

Strukturierte Daten

  1. Rufen Sie die Seite App erstellen auf.

    Agent Builder – App erstellen

  2. Klicken Sie unter Website suchen auf Erstellen.

  3. Die Funktionen der Enterprise-Version müssen aktiviert sein.

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

  5. Geben Sie im Feld Externer Name Ihres Unternehmens oder Ihrer Organisation den Namen des Unternehmens oder der Organisation ein. Für diese Anleitung können Sie Cymbal Cinemas verwenden, da die App in einem Datenspeicher nach Filmen sucht.

  6. Wählen Sie als Standort für Ihre Anwendung Global aus und klicken Sie dann auf Weiter.

  7. Wählen Sie in der Liste der Datenspeicher den Datenspeicher aus, den Sie zuvor erstellt haben, und klicken Sie dann auf Erstellen.

  8. Wechseln Sie auf der Seite Daten Ihrer Anwendung zum Tab Aktivität, um den Status der Datenaufnahme zu sehen. In der Spalte Status wird Import abgeschlossen angezeigt, wenn der Importvorgang abgeschlossen ist. Bei diesem Dataset dauert dies in der Regel zwei bis drei Minuten. Möglicherweise müssen Sie auf Aktualisieren klicken, damit Import abgeschlossen angezeigt wird.

  9. Klicken Sie auf den Tab Dokumente, um die Anzahl der importierten Dokumente zu sehen.

Unstrukturierte Daten

  1. Rufen Sie die Seite App erstellen auf.

    Agent Builder – App erstellen

  2. Klicken Sie unter Website suchen auf Erstellen.

  3. Die Unternehmensfunktionen müssen aktiviert sein.

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

  5. Geben Sie im Feld Externer Name Ihres Unternehmens oder Ihrer Organisation den Namen des Unternehmens oder der Organisation ein. Für diese Anleitung können Sie Alphabet verwenden, da die App in Alphabet-Dokumenten sucht.

  6. Wählen Sie als Standort für Ihre Anwendung Global aus und klicken Sie dann auf Weiter.

  7. Wählen Sie in der Liste der Datenspeicher den Datenspeicher aus, den Sie zuvor erstellt haben, und klicken Sie dann auf Erstellen.

  8. Wechseln Sie auf der Seite Daten Ihrer Anwendung zum Tab Aktivität, um den Status der Datenaufnahme zu sehen. Wenn der Import abgeschlossen ist, wird in der Spalte Status die Meldung Import abgeschlossen angezeigt. Für dieses Dataset dauert der Import normalerweise zwei bis drei Minuten. Möglicherweise müssen Sie auf Aktualisieren klicken, um den Status Import abgeschlossen zu sehen.

  9. Klicken Sie auf den Tab Dokumente, um die Anzahl der importierten Dokumente zu sehen.

App als Vorschau

Websitedaten

  1. Klicken Sie auf der Seite Anwendungen auf den Namen Ihrer neuen Anwendung.

  2. Klicken Sie im Navigationsmenü auf Vorschau, um die Suchanwendung zu testen.

  3. Optional: Klicken Sie auf die Ansichtssymbole, um zwischen der mobilen Ansicht und der Desktopansicht zu wechseln.

  4. Suchen Sie in der Suchleiste nach Vertex AI Search, um Ergebnisse zum Produkt zu sehen.

Strukturierte Daten

  1. Klicken Sie auf der Seite Anwendungen auf den Namen Ihrer neuen Anwendung.

  2. Klicken Sie im Navigationsmenü auf Vorschau, um die Suchanwendung zu testen.

  3. Optional: Klicken Sie auf die Ansichtssymbole, um zwischen der mobilen Ansicht und der Desktopansicht zu wechseln.

  4. Geben Sie in die Suchleiste trains ein und drücken Sie die Eingabetaste, um Ergebnisse für Filme mit Bezug auf Eisenbahnen zu sehen.

Unstrukturierte Daten

  1. Klicken Sie auf der Seite Anwendungen auf den Namen Ihrer neuen Anwendung.

  2. Klicken Sie im Navigationsmenü auf Vorschau, um die Suchanwendung zu testen.

  3. Optional: Klicken Sie auf die Ansichtssymbole, um zwischen der mobilen Ansicht und der Desktopansicht zu wechseln.

  4. Geben Sie in der Suchleiste Google ein und drücken Sie die Eingabetaste, um die Ergebnisse anzusehen.

Such-Widget konfigurieren

  1. Klicken Sie im Navigationsmenü auf Konfigurationen.

  2. Konfigurieren Sie auf dem Tab UI die Einstellungen für die Suchanwendung.

    Für verschiedene Datentypen sind unterschiedliche UI-Konfigurationen verfügbar. Weitere Informationen finden Sie unter Ergebnisse für das Such-Widget konfigurieren.

  3. Wenn Sie Konfigurationen auf dem Tab UI ändern, klicken Sie auf Speichern und veröffentlichen.

  4. Rufen Sie den Tab Automatische Vervollständigung auf, um bestimmte Einstellungen für die automatische Vervollständigung zu konfigurieren.

    Weitere Informationen finden Sie unter Automatische Vervollständigung konfigurieren.

  5. Rufen Sie den Tab Erweitert auf, um erweiterte Funktionen zu konfigurieren.

    Weitere Informationen finden Sie unter Erweiterte Funktionen.

Suchanwendung bereitstellen

  1. Klicken Sie auf der Seite Apps auf den Namen der Anwendung, die Sie bereitstellen möchten.

  2. Klicken Sie im Navigationsmenü auf Integration.

  3. Achten Sie darauf, dass der Tab Widget ausgewählt ist.

  4. Wählen Sie als Widget-Autorisierungstyp JWT- oder OAuth-basiert aus.

  5. Geben Sie in das Feld Domain den Domainnamen für die Webseite ein, auf der Sie das Widget ablegen möchten. Wenn Sie beispielsweise das Widget auf die Webseite example.com/ai.html kopieren, geben Sie example.com als Domain ein.

  6. Klicken Sie auf Hinzufügen und dann auf Speichern.

  7. Kopieren Sie das Code-Snippet im Abschnitt Kopieren Sie den folgenden Code in Ihre Webanwendung.

  8. Generieren Sie in der Codebasis ein Autorisierungstoken.

  9. Um das Autorisierungstoken an Ihr Widget zu übergeben, verwenden Sie das Code-Snippet "Autorisierungstoken festlegen" imKopieren Sie den folgenden Code in Ihre Webanwendung Abschnitt und ersetzen Sie den Text<JWT or OAuth token provided by your backend> durch Ihr Autorisierungstoken.

  10. Testen Sie Ihre bereitgestellte Anwendung. Sie können die Konfiguration weiter anpassen, indem Sie der Anleitung unter „Such-Widget konfigurieren“ folgen. Klicken Sie auf Speichern und veröffentlichen, damit die Änderungen auf das bereitgestellte Widget angewendet werden.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

  1. Löschen Sie Ihr Projekt mit der Google Cloud Console, wenn Sie es nicht mehr benötigen, um unnötige Google Cloud-Gebühren zu vermeiden.
  2. Wenn Sie ein neues Projekt erstellt haben, um mehr über Vertex AI Agent Builder zu erfahren, und dieses Projekt nicht mehr benötigen, löschen Sie es.
  3. Wenn Sie ein vorhandenes Google Cloud-Projekt verwendet haben, löschen Sie die von Ihnen erstellten Ressourcen. So vermeiden Sie, dass Ihrem Konto Gebühren in Rechnung gestellt werden. Weitere Informationen finden Sie im Abschnitt Anwendung löschen.
  4. Führen Sie die Schritte unter Vertex AI Agent Builder deaktivieren aus.

Nächste Schritte