From c767a6453548dbe0e7970b65fb95552d45a6e651 Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Mon, 21 Jun 2021 15:08:55 -0700 Subject: [PATCH] docs: added notes to train agent prior to sending queries fix: added resource reference to agent_version PiperOrigin-RevId: 380595849 Source-Author: Google APIs Source-Date: Mon Jun 21 09:28:51 2021 -0700 Source-Repo: googleapis/googleapis Source-Sha: 5fe3c6322046ed5cfc41e6c41c7ebac54db589dd Source-Link: https://github.com/googleapis/googleapis/commit/5fe3c6322046ed5cfc41e6c41c7ebac54db589dd --- .../cloud/dialogflow/v2/AgentsClient.java | 93 ++++---- .../dialogflow/v2/EntityTypesClient.java | 132 +++++++++--- .../cloud/dialogflow/v2/IntentsClient.java | 85 ++++++-- .../dialogflow/v2/EnvironmentsClientTest.java | 6 +- .../cloud/dialogflow/v2/AgentsGrpc.java | 64 ++++-- .../cloud/dialogflow/v2/EntityTypesGrpc.java | 116 ++++++++-- .../cloud/dialogflow/v2/IntentsGrpc.java | 68 +++++- .../cloud/dialogflow/v2/Environment.java | 42 ++-- .../dialogflow/v2/EnvironmentOrBuilder.java | 12 +- .../cloud/dialogflow/v2/EnvironmentProto.java | 203 +++++++++--------- .../google/cloud/dialogflow/v2/agent.proto | 21 +- .../cloud/dialogflow/v2/audio_config.proto | 60 +++--- .../cloud/dialogflow/v2/entity_type.proto | 35 ++- .../cloud/dialogflow/v2/environment.proto | 9 +- .../google/cloud/dialogflow/v2/intent.proto | 22 +- synth.metadata | 10 +- 16 files changed, 668 insertions(+), 310 deletions(-) diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsClient.java index be9b86524..071b05dc1 100644 --- a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsClient.java +++ b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/AgentsClient.java @@ -278,6 +278,9 @@ public final UnaryCallable getAgentCallable() { /** * Creates/updates the specified agent. * + *

Note: You should always train an agent prior to sending it queries. See the [training + * documentation](https://cloud.google.com/dialogflow/es/docs/training). + * *

Sample code: * * 

{@code
@@ -299,6 +302,9 @@ public final Agent setAgent(Agent agent) {
   /**
    * Creates/updates the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -323,6 +329,9 @@ public final Agent setAgent(SetAgentRequest request) {
   /**
    * Creates/updates the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -658,7 +667,8 @@ public final UnaryCallable searchAgen
   /**
    * Trains the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -683,7 +693,8 @@ public final OperationFuture trainAgentAsync(LocationName parent)
   /**
    * Trains the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -708,7 +719,8 @@ public final OperationFuture trainAgentAsync(ProjectName parent)
   /**
    * Trains the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -732,7 +744,8 @@ public final OperationFuture trainAgentAsync(String parent) {
   /**
    * Trains the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -757,7 +770,8 @@ public final OperationFuture trainAgentAsync(TrainAgentRequest re
   /**
    * Trains the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -782,7 +796,8 @@ public final OperationCallable trainAgentOpera
   /**
    * Trains the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -806,9 +821,6 @@ public final UnaryCallable trainAgentCallable() {
   /**
    * Exports the specified agent to a ZIP file.
    *
-   * 
Operation <response:
-   * [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
-   *
    * 
Sample code:
    *
    * 
{@code
@@ -834,9 +846,6 @@ public final OperationFuture exportAgentAsync(Locat
   /**
    * Exports the specified agent to a ZIP file.
    *
-   * 
Operation <response:
-   * [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
-   *
    * 
Sample code:
    *
    * 
{@code
@@ -862,9 +871,6 @@ public final OperationFuture exportAgentAsync(Proje
   /**
    * Exports the specified agent to a ZIP file.
    *
-   * 
Operation <response:
-   * [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
-   *
    * 
Sample code:
    *
    * 
{@code
@@ -887,9 +893,6 @@ public final OperationFuture exportAgentAsync(Strin
   /**
    * Exports the specified agent to a ZIP file.
    *
-   * 
Operation <response:
-   * [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
-   *
    * 
Sample code:
    *
    * 
{@code
@@ -915,9 +918,6 @@ public final OperationFuture exportAgentAsync(
   /**
    * Exports the specified agent to a ZIP file.
    *
-   * 
Operation <response:
-   * [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
-   *
    * 
Sample code:
    *
    * 
{@code
@@ -943,9 +943,6 @@ public final OperationFuture exportAgentAsync(
   /**
    * Exports the specified agent to a ZIP file.
    *
-   * 
Operation <response:
-   * [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
-   *
    * 
Sample code:
    *
    * 
{@code
@@ -977,9 +974,11 @@ public final UnaryCallable exportAgentCallable()
    * [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
    * returns in order to train explicitly.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]> An operation
-   * which tracks when importing is complete. It only tracks when the draft agent is updated not
-   * when it is done training.
+   * 
An operation which tracks when importing is complete. It only tracks when the draft agent is
+   * updated not when it is done training.
+   *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1012,9 +1011,11 @@ public final OperationFuture importAgentAsync(ImportAgentRequest
    * [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
    * returns in order to train explicitly.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]> An operation
-   * which tracks when importing is complete. It only tracks when the draft agent is updated not
-   * when it is done training.
+   * 
An operation which tracks when importing is complete. It only tracks when the draft agent is
+   * updated not when it is done training.
+   *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1047,9 +1048,11 @@ public final OperationCallable importAgentOpe
    * [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
    * returns in order to train explicitly.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]> An operation
-   * which tracks when importing is complete. It only tracks when the draft agent is updated not
-   * when it is done training.
+   * 
An operation which tracks when importing is complete. It only tracks when the draft agent is
+   * updated not when it is done training.
+   *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1080,9 +1083,11 @@ public final UnaryCallable importAgentCallable()
    * [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
    * returns in order to train explicitly.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]> An operation
-   * which tracks when restoring is complete. It only tracks when the draft agent is updated not
-   * when it is done training.
+   * 
An operation which tracks when restoring is complete. It only tracks when the draft agent is
+   * updated not when it is done training.
+   *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1114,9 +1119,11 @@ public final OperationFuture restoreAgentAsync(RestoreAgentReques
    * [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
    * returns in order to train explicitly.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]> An operation
-   * which tracks when restoring is complete. It only tracks when the draft agent is updated not
-   * when it is done training.
+   * 
An operation which tracks when restoring is complete. It only tracks when the draft agent is
+   * updated not when it is done training.
+   *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1149,9 +1156,11 @@ public final OperationFuture restoreAgentAsync(RestoreAgentReques
    * [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
    * returns in order to train explicitly.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]> An operation
-   * which tracks when restoring is complete. It only tracks when the draft agent is updated not
-   * when it is done training.
+   * 
An operation which tracks when restoring is complete. It only tracks when the draft agent is
+   * updated not when it is done training.
+   *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java
index 6aa03c8b3..da35e4f0f 100644
--- a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java
+++ b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesClient.java
@@ -534,6 +534,9 @@ public final UnaryCallable getEntityTypeCallab
   /**
    * Creates an entity type in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -562,6 +565,9 @@ public final EntityType createEntityType(AgentName parent, EntityType entityType
   /**
    * Creates an entity type in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -588,6 +594,9 @@ public final EntityType createEntityType(String parent, EntityType entityType) {
   /**
    * Creates an entity type in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -623,6 +632,9 @@ public final EntityType createEntityType(
   /**
    * Creates an entity type in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -659,6 +671,9 @@ public final EntityType createEntityType(
   /**
    * Creates an entity type in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -685,6 +700,9 @@ public final EntityType createEntityType(CreateEntityTypeRequest request) {
   /**
    * Creates an entity type in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -711,6 +729,9 @@ public final UnaryCallable createEntityType
   /**
    * Updates the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -733,6 +754,9 @@ public final EntityType updateEntityType(EntityType entityType) {
   /**
    * Updates the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -763,6 +787,9 @@ public final EntityType updateEntityType(EntityType entityType, String languageC
   /**
    * Updates the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -788,6 +815,9 @@ public final EntityType updateEntityType(UpdateEntityTypeRequest request) {
   /**
    * Updates the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -813,6 +843,9 @@ public final UnaryCallable updateEntityType
   /**
    * Deletes the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -836,6 +869,9 @@ public final void deleteEntityType(EntityTypeName name) {
   /**
    * Deletes the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -858,6 +894,9 @@ public final void deleteEntityType(String name) {
   /**
    * Deletes the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -882,6 +921,9 @@ public final void deleteEntityType(DeleteEntityTypeRequest request) {
   /**
    * Deletes the specified entity type.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -905,8 +947,8 @@ public final UnaryCallable deleteEntityTypeCalla
   /**
    * Updates/Creates multiple entity types in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -936,8 +978,8 @@ public final OperationFuture batchUpdate
   /**
    * Updates/Creates multiple entity types in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -967,8 +1009,8 @@ public final OperationFuture batchUpdate
   /**
    * Updates/Creates multiple entity types in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -997,7 +1039,8 @@ public final OperationFuture batchUpdate
   /**
    * Deletes entity types in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1029,7 +1072,8 @@ public final OperationFuture batchDeleteEntityTypesAsync(
   /**
    * Deletes entity types in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1062,7 +1106,8 @@ public final OperationFuture batchDeleteEntityTypesAsync(
   /**
    * Deletes entity types in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1090,7 +1135,8 @@ public final OperationFuture batchDeleteEntityTypesAsync(
   /**
    * Deletes entity types in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1118,7 +1164,8 @@ public final OperationFuture batchDeleteEntityTypesAsync(
   /**
    * Deletes entity types in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1146,7 +1193,8 @@ public final OperationFuture batchDeleteEntityTypesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1177,7 +1225,8 @@ public final OperationFuture batchCreateEntitiesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1206,7 +1255,8 @@ public final OperationFuture batchCreateEntitiesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1243,7 +1293,8 @@ public final OperationFuture batchCreateEntitiesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1281,7 +1332,8 @@ public final OperationFuture batchCreateEntitiesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1310,7 +1362,8 @@ public final OperationFuture batchCreateEntitiesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1339,7 +1392,8 @@ public final OperationFuture batchCreateEntitiesAsync(
   /**
    * Creates multiple new entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1368,7 +1422,8 @@ public final UnaryCallable batchCreateEnt
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1400,7 +1455,8 @@ public final OperationFuture batchUpdateEntitiesAsync(
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1430,7 +1486,8 @@ public final OperationFuture batchUpdateEntitiesAsync(
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1468,7 +1525,8 @@ public final OperationFuture batchUpdateEntitiesAsync(
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1507,7 +1565,8 @@ public final OperationFuture batchUpdateEntitiesAsync(
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1538,7 +1597,8 @@ public final OperationFuture batchUpdateEntitiesAsync(
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1569,7 +1629,8 @@ public final OperationFuture batchUpdateEntitiesAsync(
    * Updates or creates multiple entities in the specified entity type. This method does not affect
    * entities in the entity type that aren't explicitly specified in the request.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1598,7 +1659,8 @@ public final UnaryCallable batchUpdateEnt
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1630,7 +1692,8 @@ public final OperationFuture batchDeleteEntitiesAsync(
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1663,7 +1726,8 @@ public final OperationFuture batchDeleteEntitiesAsync(
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1701,7 +1765,8 @@ public final OperationFuture batchDeleteEntitiesAsync(
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1740,7 +1805,8 @@ public final OperationFuture batchDeleteEntitiesAsync(
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1769,7 +1835,8 @@ public final OperationFuture batchDeleteEntitiesAsync(
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1798,7 +1865,8 @@ public final OperationFuture batchDeleteEntitiesAsync(
   /**
    * Deletes entities in the specified entity type.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
diff --git a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/IntentsClient.java b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/IntentsClient.java
index 4338f0e3d..26061a224 100644
--- a/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/IntentsClient.java
+++ b/google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/IntentsClient.java
@@ -546,6 +546,9 @@ public final UnaryCallable getIntentCallable() {
   /**
    * Creates an intent in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -574,6 +577,9 @@ public final Intent createIntent(AgentName parent, Intent intent) {
   /**
    * Creates an intent in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -599,6 +605,9 @@ public final Intent createIntent(String parent, Intent intent) {
   /**
    * Creates an intent in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -633,6 +642,9 @@ public final Intent createIntent(AgentName parent, Intent intent, String languag
   /**
    * Creates an intent in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -667,6 +679,9 @@ public final Intent createIntent(String parent, Intent intent, String languageCo
   /**
    * Creates an intent in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -693,6 +708,9 @@ public final Intent createIntent(CreateIntentRequest request) {
   /**
    * Creates an intent in the specified agent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -718,6 +736,9 @@ public final UnaryCallable createIntentCallable() {
   /**
    * Updates the specified intent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -745,6 +766,9 @@ public final Intent updateIntent(Intent intent, String languageCode) {
   /**
    * Updates the specified intent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -778,6 +802,9 @@ public final Intent updateIntent(Intent intent, String languageCode, FieldMask u
   /**
    * Updates the specified intent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -804,6 +831,9 @@ public final Intent updateIntent(UpdateIntentRequest request) {
   /**
    * Updates the specified intent.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -829,6 +859,9 @@ public final UnaryCallable updateIntentCallable() {
   /**
    * Deletes the specified intent and its direct or indirect followup intents.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -853,6 +886,9 @@ public final void deleteIntent(IntentName name) {
   /**
    * Deletes the specified intent and its direct or indirect followup intents.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -876,6 +912,9 @@ public final void deleteIntent(String name) {
   /**
    * Deletes the specified intent and its direct or indirect followup intents.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -899,6 +938,9 @@ public final void deleteIntent(DeleteIntentRequest request) {
   /**
    * Deletes the specified intent and its direct or indirect followup intents.
    *
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
+   *
    * 
Sample code:
    *
    * 
{@code
@@ -921,8 +963,8 @@ public final UnaryCallable deleteIntentCallable() {
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -954,8 +996,8 @@ public final OperationFuture batchUpdateInte
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -989,8 +1031,8 @@ public final OperationFuture batchUpdateInte
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1022,8 +1064,8 @@ public final OperationFuture batchUpdateInte
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1057,8 +1099,8 @@ public final OperationFuture batchUpdateInte
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1087,8 +1129,8 @@ public final OperationFuture batchUpdateInte
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1117,8 +1159,8 @@ public final OperationFuture batchUpdateInte
   /**
    * Updates/Creates multiple intents in the specified agent.
    *
-   * 
Operation <response:
-   * [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1145,7 +1187,8 @@ public final UnaryCallable batchUpdateInte
   /**
    * Deletes intents in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1177,7 +1220,8 @@ public final OperationFuture batchDeleteIntentsAsync(
   /**
    * Deletes intents in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1206,7 +1250,8 @@ public final OperationFuture batchDeleteIntentsAsync(
   /**
    * Deletes intents in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1233,7 +1278,8 @@ public final OperationFuture batchDeleteIntentsAsync(
   /**
    * Deletes intents in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
@@ -1260,7 +1306,8 @@ public final OperationFuture batchDeleteIntentsAsync(
   /**
    * Deletes intents in the specified agent.
    *
-   * 
Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+   * 
Note: You should always train an agent prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/es/docs/training).
    *
    * 
Sample code:
    *
diff --git a/google-cloud-dialogflow/src/test/java/com/google/cloud/dialogflow/v2/EnvironmentsClientTest.java b/google-cloud-dialogflow/src/test/java/com/google/cloud/dialogflow/v2/EnvironmentsClientTest.java
index 6480e8a79..c5d21caba 100644
--- a/google-cloud-dialogflow/src/test/java/com/google/cloud/dialogflow/v2/EnvironmentsClientTest.java
+++ b/google-cloud-dialogflow/src/test/java/com/google/cloud/dialogflow/v2/EnvironmentsClientTest.java
@@ -177,7 +177,7 @@ public void getEnvironmentTest() throws Exception {
             .setName(
                 EnvironmentName.ofProjectEnvironmentName("[PROJECT]", "[ENVIRONMENT]").toString())
             .setDescription("description-1724546052")
-            .setAgentVersion("agentVersion1928000019")
+            .setAgentVersion(VersionName.ofProjectVersionName("[PROJECT]", "[VERSION]").toString())
             .setUpdateTime(Timestamp.newBuilder().build())
             .setTextToSpeechSettings(TextToSpeechSettings.newBuilder().build())
             .setFulfillment(Fulfillment.newBuilder().build())
@@ -229,7 +229,7 @@ public void createEnvironmentTest() throws Exception {
             .setName(
                 EnvironmentName.ofProjectEnvironmentName("[PROJECT]", "[ENVIRONMENT]").toString())
             .setDescription("description-1724546052")
-            .setAgentVersion("agentVersion1928000019")
+            .setAgentVersion(VersionName.ofProjectVersionName("[PROJECT]", "[VERSION]").toString())
             .setUpdateTime(Timestamp.newBuilder().build())
             .setTextToSpeechSettings(TextToSpeechSettings.newBuilder().build())
             .setFulfillment(Fulfillment.newBuilder().build())
@@ -287,7 +287,7 @@ public void updateEnvironmentTest() throws Exception {
             .setName(
                 EnvironmentName.ofProjectEnvironmentName("[PROJECT]", "[ENVIRONMENT]").toString())
             .setDescription("description-1724546052")
-            .setAgentVersion("agentVersion1928000019")
+            .setAgentVersion(VersionName.ofProjectVersionName("[PROJECT]", "[VERSION]").toString())
             .setUpdateTime(Timestamp.newBuilder().build())
             .setTextToSpeechSettings(TextToSpeechSettings.newBuilder().build())
             .setFulfillment(Fulfillment.newBuilder().build())
diff --git a/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentsGrpc.java b/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentsGrpc.java
index b05bb2470..ffa750593 100644
--- a/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentsGrpc.java
+++ b/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentsGrpc.java
@@ -486,6 +486,9 @@ public void getAgent(
      *
      * 
      * Creates/updates the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void setAgent(
@@ -533,7 +536,9 @@ public void searchAgents(
      *
      * 
      * Trains the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void trainAgent(
@@ -547,7 +552,6 @@ public void trainAgent(
      *
      * 
      * Exports the specified agent to a ZIP file.
-     * Operation <response: [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
      * 

      */
     public void exportAgent(
@@ -569,9 +573,11 @@ public void exportAgent(
      * However, once the import is done, training may not be completed yet. Please
      * call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it returns in order to train
      * explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when importing is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void importAgent(
@@ -592,9 +598,11 @@ public void importAgent(
      * agent settings). However, once the restore is done, training may not be
      * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
      * returns in order to train explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when restoring is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void restoreAgent(
@@ -719,6 +727,9 @@ public void getAgent(
      *
      * 
      * Creates/updates the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void setAgent(
@@ -771,7 +782,9 @@ public void searchAgents(
      *
      * 
      * Trains the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void trainAgent(
@@ -786,7 +799,6 @@ public void trainAgent(
      *
      * 
      * Exports the specified agent to a ZIP file.
-     * Operation <response: [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
      * 

      */
     public void exportAgent(
@@ -810,9 +822,11 @@ public void exportAgent(
      * However, once the import is done, training may not be completed yet. Please
      * call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it returns in order to train
      * explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when importing is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void importAgent(
@@ -835,9 +849,11 @@ public void importAgent(
      * agent settings). However, once the restore is done, training may not be
      * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
      * returns in order to train explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when restoring is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void restoreAgent(
@@ -904,6 +920,9 @@ public com.google.cloud.dialogflow.v2.Agent getAgent(
      *
      * 
      * Creates/updates the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.cloud.dialogflow.v2.Agent setAgent(
@@ -948,7 +967,9 @@ public com.google.cloud.dialogflow.v2.SearchAgentsResponse searchAgents(
      *
      * 
      * Trains the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation trainAgent(
@@ -962,7 +983,6 @@ public com.google.longrunning.Operation trainAgent(
      *
      * 
      * Exports the specified agent to a ZIP file.
-     * Operation <response: [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
      * 

      */
     public com.google.longrunning.Operation exportAgent(
@@ -983,9 +1003,11 @@ public com.google.longrunning.Operation exportAgent(
      * However, once the import is done, training may not be completed yet. Please
      * call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it returns in order to train
      * explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when importing is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation importAgent(
@@ -1005,9 +1027,11 @@ public com.google.longrunning.Operation importAgent(
      * agent settings). However, once the restore is done, training may not be
      * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
      * returns in order to train explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when restoring is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation restoreAgent(
@@ -1067,6 +1091,9 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      *
      * 
      * Creates/updates the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1112,7 +1139,9 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      *
      * 
      * Trains the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1126,7 +1155,6 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      *
      * 
      * Exports the specified agent to a ZIP file.
-     * Operation <response: [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1147,9 +1175,11 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * However, once the import is done, training may not be completed yet. Please
      * call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it returns in order to train
      * explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when importing is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1169,9 +1199,11 @@ protected AgentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions ca
      * agent settings). However, once the restore is done, training may not be
      * completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
      * returns in order to train explicitly.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
      * An operation which tracks when restoring is complete. It only tracks
      * when the draft agent is updated not when it is done training.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
diff --git a/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesGrpc.java b/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesGrpc.java
index d8ebcd2f7..5fd4e3b16 100644
--- a/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesGrpc.java
+++ b/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EntityTypesGrpc.java
@@ -583,6 +583,9 @@ public void getEntityType(
      *
      * 
      * Creates an entity type in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void createEntityType(
@@ -597,6 +600,9 @@ public void createEntityType(
      *
      * 
      * Updates the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void updateEntityType(
@@ -611,6 +617,9 @@ public void updateEntityType(
      *
      * 
      * Deletes the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void deleteEntityType(
@@ -625,7 +634,9 @@ public void deleteEntityType(
      *
      * 
      * Updates/Creates multiple entity types in the specified agent.
-     * Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchUpdateEntityTypes(
@@ -640,7 +651,9 @@ public void batchUpdateEntityTypes(
      *
      * 
      * Deletes entity types in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchDeleteEntityTypes(
@@ -655,7 +668,9 @@ public void batchDeleteEntityTypes(
      *
      * 
      * Creates multiple new entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchCreateEntities(
@@ -672,7 +687,9 @@ public void batchCreateEntities(
      * Updates or creates multiple entities in the specified entity type. This
      * method does not affect entities in the entity type that aren't explicitly
      * specified in the request.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchUpdateEntities(
@@ -687,7 +704,9 @@ public void batchUpdateEntities(
      *
      * 
      * Deletes entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchDeleteEntities(
@@ -823,6 +842,9 @@ public void getEntityType(
      *
      * 
      * Creates an entity type in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void createEntityType(
@@ -839,6 +861,9 @@ public void createEntityType(
      *
      * 
      * Updates the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void updateEntityType(
@@ -855,6 +880,9 @@ public void updateEntityType(
      *
      * 
      * Deletes the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void deleteEntityType(
@@ -871,7 +899,9 @@ public void deleteEntityType(
      *
      * 
      * Updates/Creates multiple entity types in the specified agent.
-     * Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchUpdateEntityTypes(
@@ -888,7 +918,9 @@ public void batchUpdateEntityTypes(
      *
      * 
      * Deletes entity types in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchDeleteEntityTypes(
@@ -905,7 +937,9 @@ public void batchDeleteEntityTypes(
      *
      * 
      * Creates multiple new entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchCreateEntities(
@@ -924,7 +958,9 @@ public void batchCreateEntities(
      * Updates or creates multiple entities in the specified entity type. This
      * method does not affect entities in the entity type that aren't explicitly
      * specified in the request.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchUpdateEntities(
@@ -941,7 +977,9 @@ public void batchUpdateEntities(
      *
      * 
      * Deletes entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchDeleteEntities(
@@ -1004,6 +1042,9 @@ public com.google.cloud.dialogflow.v2.EntityType getEntityType(
      *
      * 
      * Creates an entity type in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.cloud.dialogflow.v2.EntityType createEntityType(
@@ -1017,6 +1058,9 @@ public com.google.cloud.dialogflow.v2.EntityType createEntityType(
      *
      * 
      * Updates the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.cloud.dialogflow.v2.EntityType updateEntityType(
@@ -1030,6 +1074,9 @@ public com.google.cloud.dialogflow.v2.EntityType updateEntityType(
      *
      * 
      * Deletes the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.protobuf.Empty deleteEntityType(
@@ -1043,7 +1090,9 @@ public com.google.protobuf.Empty deleteEntityType(
      *
      * 
      * Updates/Creates multiple entity types in the specified agent.
-     * Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchUpdateEntityTypes(
@@ -1057,7 +1106,9 @@ public com.google.longrunning.Operation batchUpdateEntityTypes(
      *
      * 
      * Deletes entity types in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchDeleteEntityTypes(
@@ -1071,7 +1122,9 @@ public com.google.longrunning.Operation batchDeleteEntityTypes(
      *
      * 
      * Creates multiple new entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchCreateEntities(
@@ -1087,7 +1140,9 @@ public com.google.longrunning.Operation batchCreateEntities(
      * Updates or creates multiple entities in the specified entity type. This
      * method does not affect entities in the entity type that aren't explicitly
      * specified in the request.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchUpdateEntities(
@@ -1101,7 +1156,9 @@ public com.google.longrunning.Operation batchUpdateEntities(
      *
      * 
      * Deletes entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchDeleteEntities(
@@ -1163,6 +1220,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Creates an entity type in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -1177,6 +1237,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Updates the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -1191,6 +1254,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Deletes the specified entity type.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1204,7 +1270,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Updates/Creates multiple entity types in the specified agent.
-     * Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1219,7 +1287,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Deletes entity types in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1234,7 +1304,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Creates multiple new entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1250,7 +1322,9 @@ protected EntityTypesFutureStub build(
      * Updates or creates multiple entities in the specified entity type. This
      * method does not affect entities in the entity type that aren't explicitly
      * specified in the request.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -1264,7 +1338,9 @@ protected EntityTypesFutureStub build(
      *
      * 
      * Deletes entities in the specified entity type.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
diff --git a/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/IntentsGrpc.java b/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/IntentsGrpc.java
index ed4f43ebc..b9bbd0a8d 100644
--- a/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/IntentsGrpc.java
+++ b/grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/IntentsGrpc.java
@@ -423,6 +423,9 @@ public void getIntent(
      *
      * 
      * Creates an intent in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void createIntent(
@@ -437,6 +440,9 @@ public void createIntent(
      *
      * 
      * Updates the specified intent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void updateIntent(
@@ -451,6 +457,9 @@ public void updateIntent(
      *
      * 
      * Deletes the specified intent and its direct or indirect followup intents.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void deleteIntent(
@@ -465,7 +474,9 @@ public void deleteIntent(
      *
      * 
      * Updates/Creates multiple intents in the specified agent.
-     * Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchUpdateIntents(
@@ -480,7 +491,9 @@ public void batchUpdateIntents(
      *
      * 
      * Deletes intents in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchDeleteIntents(
@@ -593,6 +606,9 @@ public void getIntent(
      *
      * 
      * Creates an intent in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void createIntent(
@@ -609,6 +625,9 @@ public void createIntent(
      *
      * 
      * Updates the specified intent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void updateIntent(
@@ -625,6 +644,9 @@ public void updateIntent(
      *
      * 
      * Deletes the specified intent and its direct or indirect followup intents.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void deleteIntent(
@@ -641,7 +663,9 @@ public void deleteIntent(
      *
      * 
      * Updates/Creates multiple intents in the specified agent.
-     * Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchUpdateIntents(
@@ -658,7 +682,9 @@ public void batchUpdateIntents(
      *
      * 
      * Deletes intents in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public void batchDeleteIntents(
@@ -720,6 +746,9 @@ public com.google.cloud.dialogflow.v2.Intent getIntent(
      *
      * 
      * Creates an intent in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.cloud.dialogflow.v2.Intent createIntent(
@@ -733,6 +762,9 @@ public com.google.cloud.dialogflow.v2.Intent createIntent(
      *
      * 
      * Updates the specified intent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.cloud.dialogflow.v2.Intent updateIntent(
@@ -746,6 +778,9 @@ public com.google.cloud.dialogflow.v2.Intent updateIntent(
      *
      * 
      * Deletes the specified intent and its direct or indirect followup intents.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.protobuf.Empty deleteIntent(
@@ -759,7 +794,9 @@ public com.google.protobuf.Empty deleteIntent(
      *
      * 
      * Updates/Creates multiple intents in the specified agent.
-     * Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchUpdateIntents(
@@ -773,7 +810,9 @@ public com.google.longrunning.Operation batchUpdateIntents(
      *
      * 
      * Deletes intents in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.longrunning.Operation batchDeleteIntents(
@@ -833,6 +872,9 @@ protected IntentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
      * Creates an intent in the specified agent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -846,6 +888,9 @@ protected IntentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
      * Updates the specified intent.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -859,6 +904,9 @@ protected IntentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
      * Deletes the specified intent and its direct or indirect followup intents.
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -872,7 +920,9 @@ protected IntentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
      * Updates/Creates multiple intents in the specified agent.
-     * Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
@@ -886,7 +936,9 @@ protected IntentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * 
      * Deletes intents in the specified agent.
-     * Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
+     * Note: You should always train an agent prior to sending it queries. See the
+     * [training
+     * documentation](https://cloud.google.com/dialogflow/es/docs/training).
      * 

      */
     public com.google.common.util.concurrent.ListenableFuture
diff --git a/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/Environment.java b/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/Environment.java
index dce9938dd..3ba4e9ca4 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/Environment.java
+++ b/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/Environment.java
@@ -493,14 +493,16 @@ public com.google.protobuf.ByteString getDescriptionBytes() {
    *
    *
    * 
-   * Optional. The agent version loaded into this environment.
+   * Required. The agent version loaded into this environment.
    * Supported formats:
    * - `projects/<Project ID>/agent/versions/<Version ID>`
    * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
    *   ID>`
    * 

    *
-   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The agentVersion.
    */
@@ -520,14 +522,16 @@ public java.lang.String getAgentVersion() {
    *
    *
    * 
-   * Optional. The agent version loaded into this environment.
+   * Required. The agent version loaded into this environment.
    * Supported formats:
    * - `projects/<Project ID>/agent/versions/<Version ID>`
    * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
    *   ID>`
    * 

    *
-   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The bytes for agentVersion.
    */
@@ -1450,14 +1454,16 @@ public Builder setDescriptionBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
-     * Optional. The agent version loaded into this environment.
+     * Required. The agent version loaded into this environment.
      * Supported formats:
      * - `projects/<Project ID>/agent/versions/<Version ID>`
      * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
      *   ID>`
      * 

      *
-     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return The agentVersion.
      */
@@ -1476,14 +1482,16 @@ public java.lang.String getAgentVersion() {
      *
      *
      * 
-     * Optional. The agent version loaded into this environment.
+     * Required. The agent version loaded into this environment.
      * Supported formats:
      * - `projects/<Project ID>/agent/versions/<Version ID>`
      * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
      *   ID>`
      * 

      *
-     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return The bytes for agentVersion.
      */
@@ -1502,14 +1510,16 @@ public com.google.protobuf.ByteString getAgentVersionBytes() {
      *
      *
      * 
-     * Optional. The agent version loaded into this environment.
+     * Required. The agent version loaded into this environment.
      * Supported formats:
      * - `projects/<Project ID>/agent/versions/<Version ID>`
      * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
      *   ID>`
      * 

      *
-     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @param value The agentVersion to set.
      * @return This builder for chaining.
@@ -1527,14 +1537,16 @@ public Builder setAgentVersion(java.lang.String value) {
      *
      *
      * 
-     * Optional. The agent version loaded into this environment.
+     * Required. The agent version loaded into this environment.
      * Supported formats:
      * - `projects/<Project ID>/agent/versions/<Version ID>`
      * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
      *   ID>`
      * 

      *
-     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @return This builder for chaining.
      */
@@ -1548,14 +1560,16 @@ public Builder clearAgentVersion() {
      *
      *
      * 
-     * Optional. The agent version loaded into this environment.
+     * Required. The agent version loaded into this environment.
      * Supported formats:
      * - `projects/<Project ID>/agent/versions/<Version ID>`
      * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
      *   ID>`
      * 

      *
-     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+     * 
+     * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+     * 
      *
      * @param value The bytes for agentVersion to set.
      * @return This builder for chaining.
diff --git a/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentOrBuilder.java b/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentOrBuilder.java
index 58dde8d2a..da971c429 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentOrBuilder.java
+++ b/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentOrBuilder.java
@@ -87,14 +87,16 @@ public interface EnvironmentOrBuilder
    *
    *
    * 
-   * Optional. The agent version loaded into this environment.
+   * Required. The agent version loaded into this environment.
    * Supported formats:
    * - `projects/<Project ID>/agent/versions/<Version ID>`
    * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
    *   ID>`
    * 

    *
-   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The agentVersion.
    */
@@ -103,14 +105,16 @@ public interface EnvironmentOrBuilder
    *
    *
    * 
-   * Optional. The agent version loaded into this environment.
+   * Required. The agent version loaded into this environment.
    * Supported formats:
    * - `projects/<Project ID>/agent/versions/<Version ID>`
    * - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
    *   ID>`
    * 

    *
-   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL];
+   * 
+   * string agent_version = 3 [(.google.api.field_behavior) = OPTIONAL, (.google.api.resource_reference) = { ... }
+   * 
    *
    * @return The bytes for agentVersion.
    */
diff --git a/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentProto.java b/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentProto.java
index 1e37099f1..c8581c0f8 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentProto.java
+++ b/proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/EnvironmentProto.java
@@ -93,108 +93,109 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ogle/cloud/dialogflow/v2/fulfillment.pro"
           + "to\032\033google/protobuf/empty.proto\032 google/"
           + "protobuf/field_mask.proto\032\037google/protob"
-          + "uf/timestamp.proto\"\336\004\n\013Environment\022\021\n\004na"
+          + "uf/timestamp.proto\"\204\005\n\013Environment\022\021\n\004na"
           + "me\030\001 \001(\tB\003\340A\003\022\030\n\013description\030\002 \001(\tB\003\340A\001\022"
-          + "\032\n\ragent_version\030\003 \001(\tB\003\340A\001\022A\n\005state\030\004 \001"
-          + "(\0162-.google.cloud.dialogflow.v2.Environm"
-          + "ent.StateB\003\340A\003\0224\n\013update_time\030\005 \001(\0132\032.go"
-          + "ogle.protobuf.TimestampB\003\340A\003\022V\n\027text_to_"
-          + "speech_settings\030\007 \001(\01320.google.cloud.dia"
-          + "logflow.v2.TextToSpeechSettingsB\003\340A\001\022A\n\013"
-          + "fulfillment\030\010 \001(\0132\'.google.cloud.dialogf"
-          + "low.v2.FulfillmentB\003\340A\001\"E\n\005State\022\025\n\021STAT"
-          + "E_UNSPECIFIED\020\000\022\013\n\007STOPPED\020\001\022\013\n\007LOADING\020"
-          + "\002\022\013\n\007RUNNING\020\003:\252\001\352A\246\001\n%dialogflow.google"
-          + "apis.com/Environment\0223projects/{project}"
-          + "/agent/environments/{environment}\022Hproje"
-          + "cts/{project}/locations/{location}/agent"
-          + "/environments/{environment}\"\232\003\n\024TextToSp"
-          + "eechSettings\022\"\n\025enable_text_to_speech\030\001 "
-          + "\001(\010B\003\340A\001\022S\n\025output_audio_encoding\030\002 \001(\0162"
-          + "/.google.cloud.dialogflow.v2.OutputAudio"
-          + "EncodingB\003\340A\002\022\036\n\021sample_rate_hertz\030\003 \001(\005"
-          + "B\003\340A\001\022u\n\031synthesize_speech_configs\030\004 \003(\013"
-          + "2M.google.cloud.dialogflow.v2.TextToSpee"
-          + "chSettings.SynthesizeSpeechConfigsEntryB"
-          + "\003\340A\001\032r\n\034SynthesizeSpeechConfigsEntry\022\013\n\003"
-          + "key\030\001 \001(\t\022A\n\005value\030\002 \001(\01322.google.cloud."
-          + "dialogflow.v2.SynthesizeSpeechConfig:\0028\001"
-          + "\"\211\001\n\027ListEnvironmentsRequest\022=\n\006parent\030\001"
-          + " \001(\tB-\340A\002\372A\'\022%dialogflow.googleapis.com/"
-          + "Environment\022\026\n\tpage_size\030\002 \001(\005B\003\340A\001\022\027\n\np"
-          + "age_token\030\003 \001(\tB\003\340A\001\"r\n\030ListEnvironments"
-          + "Response\022=\n\014environments\030\001 \003(\0132\'.google."
-          + "cloud.dialogflow.v2.Environment\022\027\n\017next_"
-          + "page_token\030\002 \001(\t\"T\n\025GetEnvironmentReques"
-          + "t\022;\n\004name\030\001 \001(\tB-\340A\002\372A\'\n%dialogflow.goog"
-          + "leapis.com/Environment\"\271\001\n\030CreateEnviron"
-          + "mentRequest\022=\n\006parent\030\001 \001(\tB-\340A\002\372A\'\022%dia"
-          + "logflow.googleapis.com/Environment\022A\n\013en"
-          + "vironment\030\002 \001(\0132\'.google.cloud.dialogflo"
-          + "w.v2.EnvironmentB\003\340A\002\022\033\n\016environment_id\030"
-          + "\003 \001(\tB\003\340A\002\"\311\001\n\030UpdateEnvironmentRequest\022"
-          + "A\n\013environment\030\001 \001(\0132\'.google.cloud.dial"
-          + "ogflow.v2.EnvironmentB\003\340A\002\0224\n\013update_mas"
-          + "k\030\002 \001(\0132\032.google.protobuf.FieldMaskB\003\340A\002"
-          + "\0224\n\'allow_load_to_draft_and_discard_chan"
-          + "ges\030\003 \001(\010B\003\340A\001\"W\n\030DeleteEnvironmentReque"
-          + "st\022;\n\004name\030\001 \001(\tB-\340A\002\372A\'\n%dialogflow.goo"
-          + "gleapis.com/Environment\"\216\001\n\034GetEnvironme"
-          + "ntHistoryRequest\022=\n\006parent\030\001 \001(\tB-\340A\002\372A\'"
-          + "\n%dialogflow.googleapis.com/Environment\022"
-          + "\026\n\tpage_size\030\002 \001(\005B\003\340A\001\022\027\n\npage_token\030\003 "
-          + "\001(\tB\003\340A\001\"\371\001\n\022EnvironmentHistory\022\023\n\006paren"
-          + "t\030\001 \001(\tB\003\340A\003\022J\n\007entries\030\002 \003(\01324.google.c"
-          + "loud.dialogflow.v2.EnvironmentHistory.En"
-          + "tryB\003\340A\003\022\034\n\017next_page_token\030\003 \001(\tB\003\340A\003\032d"
-          + "\n\005Entry\022\025\n\ragent_version\030\001 \001(\t\022\023\n\013descri"
-          + "ption\030\002 \001(\t\022/\n\013create_time\030\003 \001(\0132\032.googl"
-          + "e.protobuf.Timestamp2\313\014\n\014Environments\022\364\001"
-          + "\n\020ListEnvironments\0223.google.cloud.dialog"
-          + "flow.v2.ListEnvironmentsRequest\0324.google"
-          + ".cloud.dialogflow.v2.ListEnvironmentsRes"
-          + "ponse\"u\202\323\344\223\002f\022*/v2/{parent=projects/*/ag"
-          + "ent}/environmentsZ8\0226/v2/{parent=project"
-          + "s/*/locations/*/agent}/environments\332A\006pa"
-          + "rent\022\332\001\n\016GetEnvironment\0221.google.cloud.d"
-          + "ialogflow.v2.GetEnvironmentRequest\032\'.goo"
-          + "gle.cloud.dialogflow.v2.Environment\"l\202\323\344"
-          + "\223\002f\022*/v2/{name=projects/*/agent/environm"
-          + "ents/*}Z8\0226/v2/{name=projects/*/location"
-          + "s/*/agent/environments/*}\022\374\001\n\021CreateEnvi"
-          + "ronment\0224.google.cloud.dialogflow.v2.Cre"
-          + "ateEnvironmentRequest\032\'.google.cloud.dia"
-          + "logflow.v2.Environment\"\207\001\202\323\344\223\002\200\001\"*/v2/{p"
-          + "arent=projects/*/agent}/environments:\013en"
-          + "vironmentZE\"6/v2/{parent=projects/*/loca"
-          + "tions/*/agent}/environments:\013environment"
-          + "\022\224\002\n\021UpdateEnvironment\0224.google.cloud.di"
-          + "alogflow.v2.UpdateEnvironmentRequest\032\'.g"
-          + "oogle.cloud.dialogflow.v2.Environment\"\237\001"
-          + "\202\323\344\223\002\230\00126/v2/{environment.name=projects/"
-          + "*/agent/environments/*}:\013environmentZQ2B"
-          + "/v2/{environment.name=projects/*/locatio"
-          + "ns/*/agent/environments/*}:\013environment\022"
-          + "\317\001\n\021DeleteEnvironment\0224.google.cloud.dia"
-          + "logflow.v2.DeleteEnvironmentRequest\032\026.go"
-          + "ogle.protobuf.Empty\"l\202\323\344\223\002f**/v2/{name=p"
-          + "rojects/*/agent/environments/*}Z8*6/v2/{"
-          + "name=projects/*/locations/*/agent/enviro"
-          + "nments/*}\022\204\002\n\025GetEnvironmentHistory\0228.go"
-          + "ogle.cloud.dialogflow.v2.GetEnvironmentH"
-          + "istoryRequest\032..google.cloud.dialogflow."
-          + "v2.EnvironmentHistory\"\200\001\202\323\344\223\002z\0224/v2/{par"
-          + "ent=projects/*/agent/environments/*}/his"
-          + "toryZB\022@/v2/{parent=projects/*/locations"
-          + "/*/agent/environments/*}/history\032x\312A\031dia"
-          + "logflow.googleapis.com\322AYhttps://www.goo"
-          + "gleapis.com/auth/cloud-platform,https://"
-          + "www.googleapis.com/auth/dialogflowB\237\001\n\036c"
-          + "om.google.cloud.dialogflow.v2B\020Environme"
-          + "ntProtoP\001ZDgoogle.golang.org/genproto/go"
-          + "ogleapis/cloud/dialogflow/v2;dialogflow\370"
-          + "\001\001\242\002\002DF\252\002\032Google.Cloud.Dialogflow.V2b\006pr"
-          + "oto3"
+          + "@\n\ragent_version\030\003 \001(\tB)\340A\001\372A#\n!dialogfl"
+          + "ow.googleapis.com/Version\022A\n\005state\030\004 \001(\016"
+          + "2-.google.cloud.dialogflow.v2.Environmen"
+          + "t.StateB\003\340A\003\0224\n\013update_time\030\005 \001(\0132\032.goog"
+          + "le.protobuf.TimestampB\003\340A\003\022V\n\027text_to_sp"
+          + "eech_settings\030\007 \001(\01320.google.cloud.dialo"
+          + "gflow.v2.TextToSpeechSettingsB\003\340A\001\022A\n\013fu"
+          + "lfillment\030\010 \001(\0132\'.google.cloud.dialogflo"
+          + "w.v2.FulfillmentB\003\340A\001\"E\n\005State\022\025\n\021STATE_"
+          + "UNSPECIFIED\020\000\022\013\n\007STOPPED\020\001\022\013\n\007LOADING\020\002\022"
+          + "\013\n\007RUNNING\020\003:\252\001\352A\246\001\n%dialogflow.googleap"
+          + "is.com/Environment\0223projects/{project}/a"
+          + "gent/environments/{environment}\022Hproject"
+          + "s/{project}/locations/{location}/agent/e"
+          + "nvironments/{environment}\"\232\003\n\024TextToSpee"
+          + "chSettings\022\"\n\025enable_text_to_speech\030\001 \001("
+          + "\010B\003\340A\001\022S\n\025output_audio_encoding\030\002 \001(\0162/."
+          + "google.cloud.dialogflow.v2.OutputAudioEn"
+          + "codingB\003\340A\002\022\036\n\021sample_rate_hertz\030\003 \001(\005B\003"
+          + "\340A\001\022u\n\031synthesize_speech_configs\030\004 \003(\0132M"
+          + ".google.cloud.dialogflow.v2.TextToSpeech"
+          + "Settings.SynthesizeSpeechConfigsEntryB\003\340"
+          + "A\001\032r\n\034SynthesizeSpeechConfigsEntry\022\013\n\003ke"
+          + "y\030\001 \001(\t\022A\n\005value\030\002 \001(\01322.google.cloud.di"
+          + "alogflow.v2.SynthesizeSpeechConfig:\0028\001\"\211"
+          + "\001\n\027ListEnvironmentsRequest\022=\n\006parent\030\001 \001"
+          + "(\tB-\340A\002\372A\'\022%dialogflow.googleapis.com/En"
+          + "vironment\022\026\n\tpage_size\030\002 \001(\005B\003\340A\001\022\027\n\npag"
+          + "e_token\030\003 \001(\tB\003\340A\001\"r\n\030ListEnvironmentsRe"
+          + "sponse\022=\n\014environments\030\001 \003(\0132\'.google.cl"
+          + "oud.dialogflow.v2.Environment\022\027\n\017next_pa"
+          + "ge_token\030\002 \001(\t\"T\n\025GetEnvironmentRequest\022"
+          + ";\n\004name\030\001 \001(\tB-\340A\002\372A\'\n%dialogflow.google"
+          + "apis.com/Environment\"\271\001\n\030CreateEnvironme"
+          + "ntRequest\022=\n\006parent\030\001 \001(\tB-\340A\002\372A\'\022%dialo"
+          + "gflow.googleapis.com/Environment\022A\n\013envi"
+          + "ronment\030\002 \001(\0132\'.google.cloud.dialogflow."
+          + "v2.EnvironmentB\003\340A\002\022\033\n\016environment_id\030\003 "
+          + "\001(\tB\003\340A\002\"\311\001\n\030UpdateEnvironmentRequest\022A\n"
+          + "\013environment\030\001 \001(\0132\'.google.cloud.dialog"
+          + "flow.v2.EnvironmentB\003\340A\002\0224\n\013update_mask\030"
+          + "\002 \001(\0132\032.google.protobuf.FieldMaskB\003\340A\002\0224"
+          + "\n\'allow_load_to_draft_and_discard_change"
+          + "s\030\003 \001(\010B\003\340A\001\"W\n\030DeleteEnvironmentRequest"
+          + "\022;\n\004name\030\001 \001(\tB-\340A\002\372A\'\n%dialogflow.googl"
+          + "eapis.com/Environment\"\216\001\n\034GetEnvironment"
+          + "HistoryRequest\022=\n\006parent\030\001 \001(\tB-\340A\002\372A\'\n%"
+          + "dialogflow.googleapis.com/Environment\022\026\n"
+          + "\tpage_size\030\002 \001(\005B\003\340A\001\022\027\n\npage_token\030\003 \001("
+          + "\tB\003\340A\001\"\371\001\n\022EnvironmentHistory\022\023\n\006parent\030"
+          + "\001 \001(\tB\003\340A\003\022J\n\007entries\030\002 \003(\01324.google.clo"
+          + "ud.dialogflow.v2.EnvironmentHistory.Entr"
+          + "yB\003\340A\003\022\034\n\017next_page_token\030\003 \001(\tB\003\340A\003\032d\n\005"
+          + "Entry\022\025\n\ragent_version\030\001 \001(\t\022\023\n\013descript"
+          + "ion\030\002 \001(\t\022/\n\013create_time\030\003 \001(\0132\032.google."
+          + "protobuf.Timestamp2\313\014\n\014Environments\022\364\001\n\020"
+          + "ListEnvironments\0223.google.cloud.dialogfl"
+          + "ow.v2.ListEnvironmentsRequest\0324.google.c"
+          + "loud.dialogflow.v2.ListEnvironmentsRespo"
+          + "nse\"u\202\323\344\223\002f\022*/v2/{parent=projects/*/agen"
+          + "t}/environmentsZ8\0226/v2/{parent=projects/"
+          + "*/locations/*/agent}/environments\332A\006pare"
+          + "nt\022\332\001\n\016GetEnvironment\0221.google.cloud.dia"
+          + "logflow.v2.GetEnvironmentRequest\032\'.googl"
+          + "e.cloud.dialogflow.v2.Environment\"l\202\323\344\223\002"
+          + "f\022*/v2/{name=projects/*/agent/environmen"
+          + "ts/*}Z8\0226/v2/{name=projects/*/locations/"
+          + "*/agent/environments/*}\022\374\001\n\021CreateEnviro"
+          + "nment\0224.google.cloud.dialogflow.v2.Creat"
+          + "eEnvironmentRequest\032\'.google.cloud.dialo"
+          + "gflow.v2.Environment\"\207\001\202\323\344\223\002\200\001\"*/v2/{par"
+          + "ent=projects/*/agent}/environments:\013envi"
+          + "ronmentZE\"6/v2/{parent=projects/*/locati"
+          + "ons/*/agent}/environments:\013environment\022\224"
+          + "\002\n\021UpdateEnvironment\0224.google.cloud.dial"
+          + "ogflow.v2.UpdateEnvironmentRequest\032\'.goo"
+          + "gle.cloud.dialogflow.v2.Environment\"\237\001\202\323"
+          + "\344\223\002\230\00126/v2/{environment.name=projects/*/"
+          + "agent/environments/*}:\013environmentZQ2B/v"
+          + "2/{environment.name=projects/*/locations"
+          + "/*/agent/environments/*}:\013environment\022\317\001"
+          + "\n\021DeleteEnvironment\0224.google.cloud.dialo"
+          + "gflow.v2.DeleteEnvironmentRequest\032\026.goog"
+          + "le.protobuf.Empty\"l\202\323\344\223\002f**/v2/{name=pro"
+          + "jects/*/agent/environments/*}Z8*6/v2/{na"
+          + "me=projects/*/locations/*/agent/environm"
+          + "ents/*}\022\204\002\n\025GetEnvironmentHistory\0228.goog"
+          + "le.cloud.dialogflow.v2.GetEnvironmentHis"
+          + "toryRequest\032..google.cloud.dialogflow.v2"
+          + ".EnvironmentHistory\"\200\001\202\323\344\223\002z\0224/v2/{paren"
+          + "t=projects/*/agent/environments/*}/histo"
+          + "ryZB\022@/v2/{parent=projects/*/locations/*"
+          + "/agent/environments/*}/history\032x\312A\031dialo"
+          + "gflow.googleapis.com\322AYhttps://www.googl"
+          + "eapis.com/auth/cloud-platform,https://ww"
+          + "w.googleapis.com/auth/dialogflowB\237\001\n\036com"
+          + ".google.cloud.dialogflow.v2B\020Environment"
+          + "ProtoP\001ZDgoogle.golang.org/genproto/goog"
+          + "leapis/cloud/dialogflow/v2;dialogflow\370\001\001"
+          + "\242\002\002DF\252\002\032Google.Cloud.Dialogflow.V2b\006prot"
+          + "o3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/agent.proto b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/agent.proto
index b52d2bbeb..db1af7abb 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/agent.proto
+++ b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/agent.proto
@@ -52,6 +52,10 @@ service Agents {
   }
 
   // Creates/updates the specified agent.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc SetAgent(SetAgentRequest) returns (Agent) {
     option (google.api.http) = {
       post: "/v2/{agent.parent=projects/*}/agent"
@@ -94,7 +98,10 @@ service Agents {
 
   // Trains the specified agent.
   //
-  // Operation 
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc TrainAgent(TrainAgentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/agent:train"
@@ -112,8 +119,6 @@ service Agents {
   }
 
   // Exports the specified agent to a ZIP file.
-  //
-  // Operation 
   rpc ExportAgent(ExportAgentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/agent:export"
@@ -140,9 +145,12 @@ service Agents {
   // call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it returns in order to train
   // explicitly.
   //
-  // Operation 
   // An operation which tracks when importing is complete. It only tracks
   // when the draft agent is updated not when it is done training.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc ImportAgent(ImportAgentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/agent:import"
@@ -167,9 +175,12 @@ service Agents {
   // completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
   // returns in order to train explicitly.
   //
-  // Operation 
   // An operation which tracks when restoring is complete. It only tracks
   // when the draft agent is updated not when it is done training.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc RestoreAgent(RestoreAgentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/agent:restore"
diff --git a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/audio_config.proto b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/audio_config.proto
index 53803f513..6ba9c0840 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/audio_config.proto
+++ b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/audio_config.proto
@@ -29,36 +29,6 @@ option java_outer_classname = "AudioConfigProto";
 option java_package = "com.google.cloud.dialogflow.v2";
 option objc_class_prefix = "DF";
 
-// Hints for the speech recognizer to help with recognition in a specific
-// conversation state.
-message SpeechContext {
-  // Optional. A list of strings containing words and phrases that the speech
-  // recognizer should recognize with higher likelihood.
-  //
-  // This list can be used to:
-  //
-  // * improve accuracy for words and phrases you expect the user to say,
-  //   e.g. typical commands for your Dialogflow agent
-  // * add additional words to the speech recognizer vocabulary
-  // * ...
-  //
-  // See the [Cloud Speech
-  // documentation](https://cloud.google.com/speech-to-text/quotas) for usage
-  // limits.
-  repeated string phrases = 1;
-
-  // Optional. Boost for this context compared to other contexts:
-  //
-  // * If the boost is positive, Dialogflow will increase the probability that
-  //   the phrases in this context are recognized over similar sounding phrases.
-  // * If the boost is unspecified or non-positive, Dialogflow will not apply
-  //   any boost.
-  //
-  // Dialogflow recommends that you use boosts in the range (0, 20] and that you
-  // find a value that fits your use case with binary search.
-  float boost = 2;
-}
-
 // Audio encoding of the audio content sent in the conversational query request.
 // Refer to the
 // [Cloud Speech API
@@ -108,6 +78,36 @@ enum AudioEncoding {
   AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE = 7;
 }
 
+// Hints for the speech recognizer to help with recognition in a specific
+// conversation state.
+message SpeechContext {
+  // Optional. A list of strings containing words and phrases that the speech
+  // recognizer should recognize with higher likelihood.
+  //
+  // This list can be used to:
+  //
+  // * improve accuracy for words and phrases you expect the user to say,
+  //   e.g. typical commands for your Dialogflow agent
+  // * add additional words to the speech recognizer vocabulary
+  // * ...
+  //
+  // See the [Cloud Speech
+  // documentation](https://cloud.google.com/speech-to-text/quotas) for usage
+  // limits.
+  repeated string phrases = 1;
+
+  // Optional. Boost for this context compared to other contexts:
+  //
+  // * If the boost is positive, Dialogflow will increase the probability that
+  //   the phrases in this context are recognized over similar sounding phrases.
+  // * If the boost is unspecified or non-positive, Dialogflow will not apply
+  //   any boost.
+  //
+  // Dialogflow recommends that you use boosts in the range (0, 20] and that you
+  // find a value that fits your use case with binary search.
+  float boost = 2;
+}
+
 // Information for a word recognized by the speech recognizer.
 message SpeechWordInfo {
   // The word this info is for.
diff --git a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/entity_type.proto b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/entity_type.proto
index 720444493..3d076d64e 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/entity_type.proto
+++ b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/entity_type.proto
@@ -64,6 +64,10 @@ service EntityTypes {
   }
 
   // Creates an entity type in the specified agent.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc CreateEntityType(CreateEntityTypeRequest) returns (EntityType) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent}/entityTypes"
@@ -78,6 +82,10 @@ service EntityTypes {
   }
 
   // Updates the specified entity type.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc UpdateEntityType(UpdateEntityTypeRequest) returns (EntityType) {
     option (google.api.http) = {
       patch: "/v2/{entity_type.name=projects/*/agent/entityTypes/*}"
@@ -92,6 +100,10 @@ service EntityTypes {
   }
 
   // Deletes the specified entity type.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc DeleteEntityType(DeleteEntityTypeRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=projects/*/agent/entityTypes/*}"
@@ -104,7 +116,10 @@ service EntityTypes {
 
   // Updates/Creates multiple entity types in the specified agent.
   //
-  // Operation 
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchUpdateEntityTypes(BatchUpdateEntityTypesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent}/entityTypes:batchUpdate"
@@ -122,7 +137,9 @@ service EntityTypes {
 
   // Deletes entity types in the specified agent.
   //
-  // Operation 
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchDeleteEntityTypes(BatchDeleteEntityTypesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent}/entityTypes:batchDelete"
@@ -141,7 +158,9 @@ service EntityTypes {
 
   // Creates multiple new entities in the specified entity type.
   //
-  // Operation 
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchCreateEntities(BatchCreateEntitiesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent/entityTypes/*}/entities:batchCreate"
@@ -163,8 +182,9 @@ service EntityTypes {
   // method does not affect entities in the entity type that aren't explicitly
   // specified in the request.
   //
-  //
-  // Operation 
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchUpdateEntities(BatchUpdateEntitiesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent/entityTypes/*}/entities:batchUpdate"
@@ -184,8 +204,9 @@ service EntityTypes {
 
   // Deletes entities in the specified entity type.
   //
-  //
-  // Operation 
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchDeleteEntities(BatchDeleteEntitiesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent/entityTypes/*}/entities:batchDelete"
diff --git a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/environment.proto b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/environment.proto
index 322dd2b28..45c0ff0ff 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/environment.proto
+++ b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/environment.proto
@@ -173,12 +173,17 @@ message Environment {
   // The maximum length is 500 characters. If exceeded, the request is rejected.
   string description = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The agent version loaded into this environment.
+  // Required. The agent version loaded into this environment.
   // Supported formats:
   // - `projects//agent/versions/`
   // - `projects//locations//agent/versions/`
-  string agent_version = 3 [(google.api.field_behavior) = OPTIONAL];
+  string agent_version = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "dialogflow.googleapis.com/Version"
+    }
+  ];
 
   // Output only. The state of this environment. This field is read-only, i.e., it cannot be
   // set by create and update methods.
diff --git a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/intent.proto b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/intent.proto
index 1e75f9baa..fae280cee 100644
--- a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/intent.proto
+++ b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/intent.proto
@@ -74,6 +74,10 @@ service Intents {
   }
 
   // Creates an intent in the specified agent.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc CreateIntent(CreateIntentRequest) returns (Intent) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent}/intents"
@@ -88,6 +92,10 @@ service Intents {
   }
 
   // Updates the specified intent.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc UpdateIntent(UpdateIntentRequest) returns (Intent) {
     option (google.api.http) = {
       patch: "/v2/{intent.name=projects/*/agent/intents/*}"
@@ -102,6 +110,10 @@ service Intents {
   }
 
   // Deletes the specified intent and its direct or indirect followup intents.
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc DeleteIntent(DeleteIntentRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=projects/*/agent/intents/*}"
@@ -114,7 +126,10 @@ service Intents {
 
   // Updates/Creates multiple intents in the specified agent.
   //
-  // Operation 
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchUpdateIntents(BatchUpdateIntentsRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent}/intents:batchUpdate"
@@ -134,7 +149,10 @@ service Intents {
 
   // Deletes intents in the specified agent.
   //
-  // Operation 
+  //
+  // Note: You should always train an agent prior to sending it queries. See the
+  // [training
+  // documentation](https://cloud.google.com/dialogflow/es/docs/training).
   rpc BatchDeleteIntents(BatchDeleteIntentsRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*/agent}/intents:batchDelete"
diff --git a/synth.metadata b/synth.metadata
index ce1da9d30..9f58f2c6e 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -4,23 +4,23 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/java-dialogflow.git",
-        "sha": "8af0ca973f6e55b7e527baea133391a6308f8064"
+        "sha": "3775bbce9a300dcc8c485307aa4088853ab575c3"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "551681f25e36b11829e87e580281350461f4f3f5",
-        "internalRef": "379784268"
+        "sha": "5fe3c6322046ed5cfc41e6c41c7ebac54db589dd",
+        "internalRef": "380595849"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "551681f25e36b11829e87e580281350461f4f3f5",
-        "internalRef": "379784268"
+        "sha": "5fe3c6322046ed5cfc41e6c41c7ebac54db589dd",
+        "internalRef": "380595849"
       }
     },
     {