Wenn Sie die Custom Search Site Restricted JSON API der Programmable Search Engine verwenden, können Sie mit Vertex AI Search in wenigen Minuten eine eingeschränkte Suche in Google-Qualität erstellen und bereitstellen. Zum Bereitstellen Ihrer App können Sie das Such-Widget verwenden. Dazu kopieren Sie einfach Code aus der Google Cloud Console direkt auf eine Webseite. Es ist keine Programmierung erforderlich. Alternativ können Sie eine API-Bereitstellung implementieren, um die Darstellung der Suchfunktion auf Ihrer Website zu steuern.
Weitere Informationen zur Verwendung der API finden Sie auf dem Tab „REST“ unter Suchergebnisse für eine App mit Websitedaten abrufen und in der REST-Referenz unter der Methode servingConfigs.search.
Zusätzlich zu den kurzen Standard-Snippets, die Vertex AI Search mit den Suchergebnissen zurückgibt, können Sie Ihrer Suche erweiterte Funktionen hinzufügen. Dazu gehören generierte Zusammenfassungen von Suchergebnissen, Suchanfragen mit Follow-ups für kontextbezogene Suchanfragen, die Folgefragen ermöglichen, und extrahierte Antworten für extrahierten Text, der mit jedem Suchergebnis zurückgegeben wird. Wenn Sie diese erweiterten Funktionen für Ihre Websuche nutzen möchten, ist eine Domainbestätigung erforderlich. Außerdem fallen zusätzliche Indexierungskosten an.
Sie können Ihre Suchergebnisse auch filtern oder sortieren und Promote-Steuerelemente anwenden, um einen Link als beworbenes Ergebnis anzuzeigen.
Weitere Informationen finden Sie auf der Seite Vertex AI Search-Preise.
Vertex AI Search einrichten
So richten Sie Vertex AI Search ein:
Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl das Projekt aus, das Sie für die Custom Search Site Restricted JSON API verwendet haben.
Suchanwendung erstellen
So erstellen Sie eine Such-App:
Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.
Klicken Sie auf Anwendung erstellen.
Klicken Sie auf der Seite App erstellen unter Site Search mit KI-Modus auf Erstellen.
Die Features der Enterprise-Version müssen aktiviert sein. Dies ist für die Websitesuche erforderlich. Weitere Informationen finden Sie unter Funktionen der Enterprise-Version.
Deaktivieren Sie Generative Antworten. Wenn Sie diese Option deaktivieren, erhalten Sie eine ähnliche Funktionalität wie bei der Custom Search Site Restricted JSON API der Programmable Search Engine. Deaktivieren Sie diese Option, wenn Sie keine Zusammenfassungen oder Suchanfragen mit Follow-ups benötigen. Weitere Informationen finden Sie unter Generative Antworten.
Geben Sie im Feld Name der App einen Namen für Ihre App ein.
Geben Sie im Feld Externer Name Ihres Unternehmens oder Ihrer Organisation den üblichen Namen Ihres Unternehmens oder Ihrer Organisation ein.
Wählen Sie als Standort für Ihre App Global aus und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Datenspeicher auf Neuen Datenspeicher erstellen.
Wählen Sie im Bereich Datenquelle auswählen die Option Websiteinhalte aus.
Deaktivieren Sie die Indexierung für die erweiterte Websiteindexierung. Wenn Sie diese Option deaktivieren, erhalten Sie Funktionen, die der Custom Search Site Restricted JSON API der Programmable Search Engine ähneln. Deaktivieren Sie diese Option, wenn Sie keine Zusammenfassung der Suche oder Suche mit Follow-ups benötigen oder wenn Sie nicht der Inhaber der angegebenen Domains sind. Weitere Informationen finden Sie unter Erweiterte Websiteindexierung.
Geben Sie im Bereich URL-Muster für die Indexierung angeben im Feld Einzuschließende Websites die URL-Muster der Websites ein, die Sie durchsuchen möchten, und klicken Sie dann auf Weiter.
Geben Sie im Bereich Datenspeicher konfigurieren einen Anzeigenamen für den Datenspeicher ein und klicken Sie dann auf Erstellen.
Wählen Sie auf der Seite Datenspeicher den neuen Datenspeicher aus und klicken Sie dann auf Erstellen.
Suchanwendung bereitstellen
Entscheiden Sie, wie Sie Ihre Vertex AI Search-Suchanwendung authentifizieren möchten: mit OAuth 2.0 oder einem API-Schlüssel. Informationen zu den Vor- und Nachteilen der einzelnen Methoden finden Sie unter Authentifizierung.
Suchanwendung bereitstellen (OAuth 2.0)
So stellen Sie Ihre Such-App mit OAuth 2.0-Authentifizierung bereit:
Informationen zum Einrichten von OAuth 2.0 finden Sie unter In Google Cloud im Hilfeartikel Bei Vertex AI Search authentifizieren. Fügen Sie dem Dienstkonto die Rolle Discovery Engine-Nutzer oder Discovery Engine-Betrachter hinzu.
Sie haben folgende Möglichkeiten, Ihre Such-App bereitzustellen:
Such-Widget verwenden Stellen Sie Ihre Such-App ohne Programmierung bereit. Weitere Informationen finden Sie unter Such-Widget auf einer Webseite einfügen.
API verwenden: Mit der API können Sie die Darstellung der Suchfunktion auf Ihrer Website anpassen. Weitere Informationen finden Sie auf dem Tab „REST“ unter Suchergebnisse für eine App mit Websitedaten abrufen und in der REST-Referenz unter der Methode
servingConfigs.search. Informationen zum Sortieren der Ergebnisse Ihrer Websuchanfragen finden Sie unter Web-Suchergebnisse sortieren.
Suchanwendung bereitstellen (API-Schlüssel)
So stellen Sie Ihre Such-App mit einem API-Schlüssel zur Authentifizierung bereit:
API-Schlüssel erstellen:
Rufen Sie in der Google Cloud Console die Seite Anmeldedaten auf.
Wenn Sie sich noch nicht in Ihrem Projekt befinden, wählen Sie es in der Projektliste oben auf der Google Cloud -Console-Seite aus.
Klicken Sie auf Anmeldedaten erstellen und wählen Sie anschließend API-Schlüssel aus. Fügen Sie keine Einschränkungen für die Referrer-URL hinzu. Bei einigen Datenschutzeinstellungen für Nutzer wird die Referrer-URL nicht übergeben.
- Notieren Sie sich den generierten API-Schlüssel, da Sie ihn beim Aufrufen der
searchLite-Methode verwenden.
- Notieren Sie sich den generierten API-Schlüssel, da Sie ihn beim Aufrufen der
Für mehr Sicherheit fügen Sie Ihrem API-Schlüssel eine HTTP-Einschränkung hinzu, um den Zugriff auf den Vertex AI Search-Dienst unter
https://discoveryengine.googleapis.com/*einzuschränken.
Suchanwendung über die API bereitstellen Weitere Informationen finden Sie unter Suchergebnisse für eine App mit Websitedaten abrufen (API-Schlüssel) und in der REST-Referenz unter der Methode
servingConfigs.searchLite. Informationen zum Sortieren der Ergebnisse Ihrer Websuche finden Sie unter Web-Suchergebnisse sortieren.
Authentifizierung
Die Authentifizierung der Custom Search Site Restricted JSON API der Programmable Search Engine erfolgt über einen API-Schlüssel. Mit einigen Ausnahmen ist für Vertex AI Search OAuth 2.0 erforderlich.
Wenn Sie weiterhin einen API-Schlüssel zur Authentifizierung verwenden möchten, müssen Sie die Methode searchLite über API-Aufrufe verwenden.
Wenn Sie die Authentifizierung über OAuth 2.0 wählen, müssen Sie die Methode search und die Methode answer verwenden, um Ihre Website abzufragen. Außerdem können Sie Ihre Such-App über das No-Code-Such-Widget bereitstellen.
In der folgenden Tabelle sind die Unterschiede zwischen der Verwendung der Methode searchLite mit API-Schlüsselauthentifizierung und der Methoden search und answer mit OAuth 2.0-Authentifizierung aufgeführt.
| Funktion/Methoden | Methode searchLite |
Methode search |
|---|---|---|
| Authentifizierung | API-Schlüssel | oauth 2.0 |
| Such-Widget verfügbar | ✘ | ✔ |
| Suchzusammenfassungen | ✔ | ✔ |
| Öffentliche Websites durchsuchen | ✔ | ✔ |
Nächste Schritte
Wenn Sie die Suchergebnisse filtern müssen, lesen Sie den Abschnitt Filterausdrücke für die einfache Websuche.
Wenn Sie eine Bildersuche anbieten müssen, lesen Sie den Abschnitt Bilder auf Websites suchen.
Wenn Sie die Suchergebnisse sortieren möchten, z. B. nach Datum, lesen Sie den Abschnitt Suchergebnisse für die einfache Website-Suche sortieren.
Wenn Sie die Suche in mehreren Schritten benötigen, lesen Sie den Abschnitt Befehle für Folgefragen.