Website search checklist

Set up a Google Cloud project, turn on Vertex AI Search, and set up access control for your project. You can use an existing Google Cloud project if you already have one.

Actions

1. Review the Before you begin page and confirm that you have completed the steps.

Understand how a website search app (a type of custom search app) behaves and the prerequisites to include websites in a website data store.

Actions

1. Review the information about the relationship between custom apps and data stores in About apps and data stores and what constitutes website data. For basic website search, you can connect only one data store to an app.

2. Prepare your website data according to the requirements in Website data.

Create a data store by providing the website URL patterns to include and the URL patterns to exclude.

Actions

1. Follow the instructions for your data source in Create a data store using website URLs.

Create your website search app and connect it to your new data store.

Actions

1. Create a search app. Ensure to turn on enterprise edition.

Vertex AI Search provides many configuration options. Some options depend on whether you plan to deploy a search widget.

Actions

Depending on your use case and whether you plan to deploy the out-of-the-box search widget or integrate search API calls into your own code, Vertex AI Search provides several options for configuration.

• You can embed a search widget into your website. The widget automatically provides a search bar and expandable search interface. If you plan to deploy the search widget, configure the following:

  • Search widget results. See Configure results for the search widget.

  • Autocomplete. See Update autocomplete settings.

• If you plan to integrate search API calls into your server or application instead of using the widget, you can configure your search settings using the following options:

  • Autocomplete. Depending on your data, set up autocomplete suggestions based on document content, fields, search history, or user events. See Configure autocomplete.

  • Serving controls. Control when search results are filtered or promoted. See Configure serving controls for search.

If you plan to deploy your app by integrating search API calls into your own code, Vertex AI Search provides additional options for configuring how your search results are returned.

Actions

1. Configure your search results with the following options:

   • Filter website search using filter expressions for basic website search.
   • Order web search results for basic website search.
   • Get snippets.

You can preview your search results to check if your app configurations are working as expected.

Actions

1. To preview your search results, use the console or the API.

   • Console. Use the Vertex AI Search console Preview page to preview how search widget configurations affect your results. See the Console instructions in Get search results.

   • API. If you're integrating API calls into your application, you can make cURL calls to preview your search configurations. See the REST instructions in Get search results.

When you're happy with the preview version of your search app, share it with your users by deploying it to your website.

Actions

1. You can deploy your search app in either of the following ways:

   • Embed the search widget into your website. Vertex AI Search provides code that you can copy into your website or web application. This deploys the search widget. You can preview search results in the console. See Add the search widget to a webpage.

   • Integrate search API calls into your server or application. For full control over how your search results are displayed, you can integrate API calls into your server or applications. For more information about making API calls, see Get search results. For client library resources, see Vertex AI Search client libraries.

To get personalized search and browse results, you can update the user events in your search app. For more information see About user events.

Actions

1. Import historical user events.
2. Record real-time user events.

You can upgrade your search app to advanced website indexing at any time. Advanced website indexing offers features that enrich your indexing to enhance your search experience.

Actions

1. Turn on advanced website indexing.