Data store agents are a special type of Dialogflow agent that can provide LLM generated agent responses based on your website content and uploaded data.
To create this agent, you provide data stores when creating the agent.
A data store agent has special state handlers called data store handlers. Using these data store handlers, your data store agent can have conversations about the content with your end-users.
Limitations
The following limitations apply:
- This feature currently only supports select languages in GA. See the data store column in the language reference.
- Only the following regions
are supported:
global
,us
multi-region, andeu
multi-region. - The only structured data store type supported is FAQ.
- Apps with both chunked and non-chunked data stores are not supported.
Access control
If you are the project owner, you have all the permissions needed to create a data store agent. If you are not the project owner, you must have the following roles:
- Dialogflow Admin
- Discovery Engine Admin
For more information, see the Dialogflow access control guide.
Create a data store agent
To create a data store agent:
- If you have not already, follow the Dialogflow setup instructions.
Go to the Agent Builder console:
Select your project from the console drop-down.
If you have not already activated the API, read and agree to the Terms of Service, then click Continue and activate the API.
Click Create a New App or New App.
Select Chat.
Provide your company name in the Agent configurations section.
Expand the time zone and language settings section.
Select a time zone.
Select a default language.
Provide an agent name in the Your agent name section.
Select a region or multi-region in the Location of your agent section.
Click Continue.
Connect a data store to your agent by doing one of the following:
- Select an existing data store that you previously created.
- Create a new data store:
- Click Create New Data Store.
- Choose a data source.
- Provide data and configuration for the data store source you selected. Your data store location should correspond to the agent location.
- Click Create to create the data store.
- Select your new data store.
Click Create.
Your agent is now created, and you are automatically redirected to the Available data stores page, where you can add more data stores as needed.
If you have created a new data store for a website, you must verify your domain.
To open your agent with Conversational Agents (Dialogflow CX), click Preview in the left panel. In the Conversational Agents (Dialogflow CX) console, you can edit or add data store handlers, deploy your agent, and optionally add flows that will handle scenarios not covered by the data stores.
Test your agent
You can use the Dialogflow CX simulator to test your agent.
Deploy your agent
There are many ways to deploy your agent:
The simplest option is to use a Dialogflow CX integration, which provides a user interface for your agent. Each integration provides instructions for deployment.
The Dialogflow Messenger integration is a particularly good option for data store agents. It has built-in options for generative features.
You can create your own user interface and use the Dialogflow CX API for interactions. Your user interface implementation is in control of deployment.
Special intents
In addition to handling questions about the content you provide, the data store agent can handle the following types of questions:
- Agent identification: Handles questions like "Who are you?" or "Are you human?".
- Escalate to a human agent: Handles questions like "I want to talk to a human" or "I want to talk to a real person".
This is accomplished by automatically generated intents and intent routes.
Add or edit data store handlers for an existing agent
Data store handlers are a special type of Dialogflow state handler. This means that you can apply them to flows or pages, and that they are evaluated using the same scope rules.
To add or edit a data store handler:
- Go to the Dialogflow CX Console.
- Select your Google Cloud project.
- Select the agent.
- Select the flow associated with the data store handler. This is commonly the default start flow.
- Select the page associated with the data store handler. This is commonly the start page.
- Click Add state handler in the page data, then select data store.
- If you need to create a data store, you will be taken to the Vertex AI Agent Builder user interface. See the data store information to help you make selections.
- If you already have a data store, click Edit data store.
- Make updates as needed and save when you are complete. See information below about data store specific settings.
Agent responses
In the Agent responses section,
you can provide custom responses that reference generative answers.
Use $request.knowledge.questions[0]
in the Agent says section
to provide the generative answer.
Data store response options
You can update the Link maximum field to indicate the maximum number of supplemental links that should be provided by the generative answers.