Over the coming months, generative features will be migrating from the Dialogflow CX console to the Agent Builder console. Currently, if you need to reference flows, you must use the Dialogflow CX console.
This guide focuses on describing the Vertex AI Agents features of the Agent Builder console.
Left menu navigation
The Vertex AI Agents user interface has the following left navigation menu items:
| Name | Description |
|---|---|
| Agents | Used to create and edit agents for your agent app. |
| Tools | Tools are used to connect to APIs or data stores. |
| Test cases | List and run test cases created with the simulator. |
| Conversation history | Provides the conversation history for all interactions with the agent. |
| Integrations | Integrate with other conversation platforms. |
| Agent app settings | Change settings such as agent app name, location, models, and logging. |
| Prebuilt agents | Example agents for popular domains. |
Create an agent app
To create an agent app:
Vertex AI Agents
- If you have not already, follow the Dialogflow CX 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 Agent.
Provide a name for your agent app.
Select a region.
Click Create.
The list of agents for the agent app is shown. Click Create to create a new agent for the agent app.
Provide a name.
Provide a goal.
Provide instructions.
Click the Examples tab, then click +Example to provide agent examples.
To enable conversation history, click the settings icon on the left navigation, then Logging, Enable Conversation History.
To enable logging for debug purposes, click the settings icon on the left navigation, then Logging, Enable Cloud Logging.
To select the model, click the settings icon on the left navigation, then select the Vertex AI model.
Dialogflow CX
When creating a Dialogflow CX agent you can choose to have the agent start a conversation with either an agent or a Dialogflow CX flow.
To create an agent app:
- Follow the steps to create a Dialogflow CX agent, selecting Build your own.
- Select Generative as the agent type.
- Click Save.
Notice that there are three new resource selectors in the left navigation. These selectors let you choose between:
- Flow resources
- Generative resources
- Shared resources
To create an agent:
- Select the generative resources on the left navigation.
- Click Agents.
- Click Create new.
- Provide data.
Test cases
The existing test case feature has been enhanced to support agents.
A required expected test case result field has been added, which provides a list of actions in the form of agent examples. The test case verifies that the actions were performed as expected.
When viewing an agent or agent version, you can click the Test cases tab above the agent data to see test case results and to execute a test case on demand.
You can also compare test case results for different versions of an agent. Select a test case, then click Compare.
To see all test cases for the agent, click Test cases in the left navigation.
Conversation history
The existing conversation history feature has been enhanced to support agents.
Information has been added for tool execution, agent invocation, and flow invocation from an agent app.
Agent versions
You can save agent versions, which are immutable snapshots of agents.
To save an agent version:
- Load the agent in the console.
- Click Version history.
- Click Create version.
- Provide a version name and click Save.
To view version history:
- Load the agent in the console.
- Click Version history.
- Click View version history.
- The version history panel opens on the right side. You can click each version to see its content.