If you're new to Vertex AI Agent Builder, consider following the Get started with generic recommendations tutorial to create a sample app.
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 have one already.
Actions
- Review Before you begin and confirm that you have completed the steps.
Determine what kind of data you'll make available in your recommendations app and prepare it for importing to Vertex AI Search.
You can base your data store on the following types of data:
- Website data. Website URLs.
- Unstructured data. Documents (such as PDFs, HTML files, and TXT files) that are stored in Cloud Storage. Optionally, you can provide metadata in a JSON file or in a BigQuery table.
- Structured data. Data provided with a specific schema. For example, you can provide data in a BigQuery table or as JSON files in Cloud Storage.
Actions
Review the information about supported data and the relationship between apps and data stores in About apps and data stores.
Prepare your data according to the requirements in Prepare data for ingestion.
Create a data store and then import your data into it.
How you import your data depends on where you're importing it from. For example, if your data is in Cloud Storage, you can import it using the console or the API by providing the bucket location of your data.
Actions
- Follow the instructions for your data source in Create a generic recommendations data store.
Create your generic recommendations app and connect it to your new data store.
Actions
For apps with structured data or apps with unstructured data with metadata, you can update field settings to make them filterable and filter your recommendations results using those fields.
Actions
Set specific fields as filterable to allow Vertex AI Search to use those fields for filtering recommendations. See Configure field settings.
You can preview your recommendations to check if your recommendations are appearing as expected.
Actions
To preview your recommendations, use the Vertex AI Agent Builder console or the API.
Console. Use the console Preview page to preview your recommendations. See the Console instructions for the kind of data that your app uses in Get recommendations.
API. Make cURL calls to preview your recommendations. See the REST instructions for the kind of data that your app uses in Get recommendations.
When you are happy with the previews from your recommendations app, share it with your users by deploying it to your website.
Actions
To deploy your recommendations app, integrate API calls into your server or applications. For more information about making API calls, see the REST instructions for the kind of data that your app uses in Get recommendations.
For client library resources, see Vertex AI Agent Builder client libraries.
You can maintain your app to ensure that latest and necessary data is available in your data store.