Share your agent

It is common for multiple team members to collaborate on building an agent. Using roles, you can control the level of access granted to team members.

If you are using the API, you may also have one or more applications that send requests to an agent. In this case, you can control access with roles and service accounts.

You can manage roles using either the Dialogflow Console or GCP Console IAM settings. There are some situations in which you must use the GCP Console to assign roles:

  • The Dialogflow Console does not allow assignment of the Admin role. If you want to change the Admin or add multiple Admins for one agent, you need to use the GCP Console.
  • If you have integrations with other GCP resources, like Cloud Functions, and you don't want to grant full project access to an application, you must assign the Dialogflow API roles (Admin, Client, or Reader) in the GCP IAM console.
  • A subset of the GCP IAM roles have corresponding Dialogflow Console roles. If you want to grant a role that does not exist on the Dialogflow Console, you need to use the GCP Console.

Roles

The following table lists all roles relevant to Dialogflow.

Dialogflow Console role GCP IAM role Description
Admin Project >
Owner
  • Full access to all GCP project resources using GCP Console or APIs.
  • Full access to Dialogflow Console to create and edit agents.
Developer Project >
Editor
  • Edit access to all GCP project resources using GCP Console or APIs.
  • Edit access to Dialogflow Console to edit agents.
Reviewer Project >
Viewer
  • Read access to all GCP project resources using GCP Console or APIs.
  • Read access to Dialogflow Console.
N/A Project >
Browser
  • Read access to all GCP project resources using GCP Console or APIs.
  • No access to Dialogflow Console.
  • Cannot detect intent using API.
N/A Dialogflow >
Dialogflow API Admin
  • Full access to Dialogflow using GCP Console or APIs.
  • Read access to Dialogflow Console.
N/A Dialogflow >
Dialogflow API Client
  • Edit access to Dialogflow using GCP Console or APIs.
  • No access to Dialogflow Console.
N/A Dialogflow >
Dialogflow Console Agent Editor
  • Full access to Dialogflow using GCP Console or APIs.
  • Edit access to most agent data using Dialogflow Console. Cannot access Inline Editor for Cloud Functions or Google Assistant integration.
  • Cannot detect intent using API.
N/A Dialogflow >
Dialogflow API Reader
  • Read access to Dialogflow using GCP Console or APIs.
  • Read access to Dialogflow Console.
  • Cannot detect intent using API.

Manage roles with Dialogflow Console

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

You can manage permissions with GCP IAM settings. 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.

Was this page helpful? Let us know how we did:

Send feedback about...

Dialogflow Enterprise Edition Documentation