Website search checklist

This page provides a checklist of the steps required to create a website search app, which is a type of generic search app. For a checklist to create other types of generic search apps, see Generic search checklist.

If you're new to Vertex AI Agent Builder, consider following the Get started with generic search tutorial to create a sample website data app.

Choose between basic website search and advanced website indexing

Vertex AI Agent Builder offers two types of website data stores: basic website search and advanced website indexing.

You can choose to turn on advanced website indexing to index the web pages in your search data store. Advanced website indexing requires domain verification and offers several additional features over basic website search. For more information, see Advanced website indexing.

Depending on the type of website data store you require for your business needs, select one of the following checklists:

Basic website search Advanced website indexing

Set up a Google Cloud project

Set up a Google Cloud project, turn on Vertex AI Agent Builder, 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.

Prepare your data

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

Actions

1. Review the information about the relationship between generic 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

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 app

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.

Configure your search settings at a data store level

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.

Configure your search results at a request level

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.

Preview search results

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 Agent Builder 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.

Deploy your search app

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 Agent Builder client libraries.

Turn on advanced website indexing

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.