Share your agent

Many team members can collaborate on an agent, and you can control the level of access granted to each team member. You can manage access using either the Dialogflow console or the Google Cloud Platform console.

You can manage permissions with the Google Cloud Platform (GCP) IAM settings, and a subset of the IAM roles have corresponding Dialogflow roles.

Dialogflow console role GCP IAM role Description Where to assign
Admin Project > Owner Full access to all Dialogflow (console and API) and GCP resources. Can use console to create agent. Dialogflow console or GCP IAM console.
Developer Project > Editor Edit access to all Dialogflow (console and API) and GCP resources. Can use console to create agent. Dialogflow console or GCP IAM console.
Reviewer Project > Viewer Read access to all Dialogflow (console and API) and GCP resources. Cannot detect intent. Dialogflow console or GCP IAM console.
N/A Project > Browser Access to browser GCP resources. GCP IAM console only.
N/A Dialogflow > Dialogflow API Admin Full access to Dialogflow (API only) resources. GCP IAM console only.
N/A Dialogflow > Dialogflow API Client Edit access to Dialogflow (API only) resources. GCP IAM console only.
N/A Dialogflow > Dialogflow API Reader Read access to Dialogflow (API only) resources. Cannot detect intent. GCP IAM console only.

There are two main situations in which you must use the GCP IAM console to assign roles:

  • Dialogflow's sharing feature does not allow assignment of the Admin role. If you want to have multiple Admins for the agent, you will need to assign the role to the other user in the GCP IAM console.
  • If you have integrations with other GCP resources, like Cloud Functions, and don't want to grant full project access to a user, you must assign the Dialogflow API roles (Admin, Client, or Reader) in the GCP IAM console.

Manage roles in Dialogflow

Sharing options are in the agent's settings (the gear icon settings next to the agent's name) under the Share tab:

Add a user

To share an agent with a user, follow these steps:

  1. Enter the user's email address under INVITE NEW PEOPLE.
  2. Select a role from the drop down.
  3. Click ADD.
  4. Click SAVE.

Change a user's role

To change the level of access a user has, follow these steps:

  1. Find the user in the list.
  2. Select a different role from the drop down menu.
  3. Click SAVE.

Remove a user

To remove a user's access to an agent, follow these steps:

  1. Find the user in the list.
  2. Click X on the right of the user's listing.
  3. Click SAVE.

Manage roles in the Google Cloud Platform console

All of the following steps take place in the GCP IAM console. See the IAM quickstart for detailed instructions on adding, editing, and removing roles.

Add a user

To share an agent with a user through Google Cloud Platform, follow these steps:

  1. Click ADD edit at the top of the page.
  2. Enter the email address of the user.
  3. Select a role from the drop down.
  4. Click SAVE.

Change a user's role

To change the level of access a user has in Google Cloud Platform, follow these steps:

  1. Click the edit edit icon for the user you want to edit.
  2. Select a different role from the drop down.
  3. Click SAVE.

Remove a user

To remove a user through Google Cloud Platform, click the delete delete icon for the user you want to remove.