This page describes how to create a search app.
Create an app
Console
To create a search app using the Google Cloud console, follow these steps:
In the Google Cloud console, go to the Agent Builder page.
On the Apps page, click
Create app.On the
Create app page, under Search for your website, click Create.Decide if you want Enterprise features for this app and then click the toggle on or off. Turning on Enterprise edition features is required to get features such as website search and choosing a region for your app. Enterprise edition features incur additional cost. For more information, see Enterprise edition features.
Decide if you want advanced LLM features for this app and then click the toggle on or off. Activating the advanced LLM features is required to get features such as search summaries or search with follow-ups. For more information, see Advanced LLM features.
In the Your app name field, enter a name for your app.
In the External name of your company or organization field, enter the common name for your company or organization. Avoid suffixes like Inc or LLC. This field helps the LLM identify the company that the app represents.
Select a location for your app. Enterprise features must be turned on to pick a location. Google recommends that you use the default, global (Global), unless you have a reason to restrict your data to a particular geography.
Click Continue.
To connect to a data store, on the Data stores page, select a data store that you previously created or create a new data store.
Choose one of the following options:
- Select an existing data store: If you attach only one data store, you cannot remove it or add other data stores to the app later. Attaching multiple data stores lets you update the attached data stores later, but the app always requires at least two data stores.
- Create a new data store and ingest data into it:
- Click Create data store and follow the steps in the Create a new data store page.
- Choose your new data store and click Select. For more information, see Create a search data store.
REST
Before you use the command line to create an app, you must have an existing data store. If you don't have a data store, create one following the steps in Create a data store and ingest data for Vertex AI Search.
To use the engines.create
method to create a search app from
the command line, follow these steps:
Find your data store ID. If you already have your data store ID, skip to the next step.
In the Google Cloud console, go to the Agent Builder page and in the navigation menu, click Data Stores.
Click the name of your data store.
On the Data page for your data store, get the data store ID.
Create a search app and connect it to a data store. A data store can be attached to only one app and can't be removed from the app later.
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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \ -d '{ "displayName": "APP_DISPLAY_NAME", "dataStoreIds": ["DATA_STORE_ID"], "solutionType": "SOLUTION_TYPE_SEARCH", "industryVertical": "INDUSTRY_VERTICAL", "searchEngineConfig": { "searchTier": "SEARCH_TIER", "searchAddOns": ["SEARCH_ADD_ON"] } }'
Replace the following:
PROJECT_ID
: the ID of your Google Cloud project.APP_ID
: the ID of the Vertex AI Search app that you want to create.APP_DISPLAY_NAME
: the display name of the Vertex AI Search app that you want to create.DATA_STORE_ID
: the ID of an existing Vertex AI Search data store that you want to add to the Vertex AI Search app.INDUSTRY_VERTICAL
: the industry vertical that the app is associated with. This field can take the values specified inIndustryVertical
. For search apps with multiple data stores, also called blended search apps, you must specify this field asGENERIC
.SEARCH_TIER
: the search tier can beSEARCH_TIER_STANDARD
orSEARCH_TIER_ENTERPRISE
.SEARCH_TIER_ENTERPRISE
is required to get features such as website search and choosing a region for your app. Enterprise edition features incur additional cost. For more information, see Enterprise edition features.SEARCH_ADD_ON
: If you want Advanced LLM features for this app, then specifySEARCH_ADD_ON_LLM
. Advanced LLM features include search summaries and search with follow-ups.If you don't want Advanced LLM features, then either specify
SEARCH_ADD_ON_UNSPECIFIED
or remove thesearchAddOns
field.For more information, see Advanced LLM features.
Python
For more information, see the Vertex AI Agent Builder Python API reference documentation.
To authenticate to Vertex AI Agent Builder, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.
Terraform
To learn how to apply or remove a Terraform configuration, see Basic Terraform commands. For more information, see the Terraform provider reference documentation.
To create a search app using Terraform, see
discovery_engine_search_engine
.