Create and manage agents

All agent-related menus and information are found at the top of the left sidebar menu at the Dialogflow Console. There, you'll see a list of the agents associated with your account and the option to create a new agent.

Create an agent

Note: You can only create one agent per region for a GCP project. If you need multiple agents in the same region, you will need to create multiple projects.

To create an agent with the console (common), follow these steps:

1. You must have a role with full or edit access in order to create an agent.
2. Go to the Dialogflow ES console.
3. If requested, sign in to the Dialogflow console. See Dialogflow console overview for more information.
4. Click Create Agent in the left menu. (If you already have other agents, click the agent name, scroll to the bottom and click Create new agent.)
5. Enter your agent's name, default language, default time zone and GCP project, then click the Create button. (You can change the agent edition after creation.)

To create an agent with the API (uncommon), see Create an agent with the API.

Delete an agent

Caution: Deleting an agent cannot be undone. Export your agent to keep a backup if necessary.

1. You must have a role with full access in order to delete an agent in the Dialogflow Console.

   Note: Either full or edit access can delete an agent when using the API.

2. Before deleting an agent, you must remove access for all users besides yourself:

   • If you are the only user with the Owner/Admin role, you can use the Dialogflow Console to remove other users.
   • If more than one user has the Owner/Admin role, you must use the GCP Console to remove other users.

3. To delete an agent:

   1. Go to the Dialogflow ES console.
   2. Select the agent you wish to delete.
   3. Click on the settings button next to the agent's name.
   4. Select the General tab, and scroll down to the bottom.
   5. Click Delete this agent. If you do not see the Delete this agent button, it is because you do not have the required Owner/Admin role.
   6. Enter DELETE in the text field.
   7. Click Delete.

If you delete your project, all Dialogflow ES agents and data associated with the project are deleted within 60 days of project deletion. If you receive an error when attempting to delete a project due to an existing lien, see the troubleshooting documentation section on project liens.