feat: mark agent.default_language_code as required (#246)

PiperOrigin-RevId: 380726996 Source-Link: googleapis/googleapis@a5cec0a Source-Link: googleapis/googleapis-gen@1e4922a feat: add return_partial response to Fulfillment docs: add notes to train agent before sending queries
googleapis · Jun 24, 2021 · a3432ed · a3432ed
1 parent ff6f759
commit a3432ed
Show file tree

Hide file tree

Showing 41 changed files with 1,840 additions and 480 deletions.
diff --git a/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java b/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java
@@ -391,6 +391,9 @@ public final UnaryCallable<GetAgentRequest, Agent> getAgentCallable() {
   /**
    * Creates an agent in the specified location.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -419,6 +422,9 @@ public final Agent createAgent(LocationName parent, Agent agent) {
   /**
    * Creates an agent in the specified location.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -444,6 +450,9 @@ public final Agent createAgent(String parent, Agent agent) {
   /**
    * Creates an agent in the specified location.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -468,6 +477,9 @@ public final Agent createAgent(CreateAgentRequest request) {
   /**
    * Creates an agent in the specified location.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -491,6 +503,9 @@ public final UnaryCallable<CreateAgentRequest, Agent> createAgentCallable() {
   /**
    * Updates the specified agent.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -516,6 +531,9 @@ public final Agent updateAgent(Agent agent, FieldMask updateMask) {
   /**
    * Updates the specified agent.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -540,6 +558,9 @@ public final Agent updateAgent(UpdateAgentRequest request) {
   /**
    * Updates the specified agent.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -738,6 +759,9 @@ public final UnaryCallable<ExportAgentRequest, Operation> exportAgentCallable()
    * <p>Replaces the current agent with a new one. Note that all existing resources in agent (e.g.
    * intents, entity types, flows) will be removed.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -764,6 +788,9 @@ public final OperationFuture<Empty, Struct> restoreAgentAsync(RestoreAgentReques
    * <p>Replaces the current agent with a new one. Note that all existing resources in agent (e.g.
    * intents, entity types, flows) will be removed.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -791,6 +818,9 @@ public final OperationFuture<Empty, Struct> restoreAgentAsync(RestoreAgentReques
    * <p>Replaces the current agent with a new one. Note that all existing resources in agent (e.g.
    * intents, entity types, flows) will be removed.
    *
+   * <p>Note: You should always train flows prior to sending them queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code

diff --git a/...loud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java b/...loud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java
@@ -405,6 +405,9 @@ public final UnaryCallable<GetEntityTypeRequest, EntityType> getEntityTypeCallab
   /**
    * Creates an entity type in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -433,6 +436,9 @@ public final EntityType createEntityType(AgentName parent, EntityType entityType
   /**
    * Creates an entity type in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -459,6 +465,9 @@ public final EntityType createEntityType(String parent, EntityType entityType) {
   /**
    * Creates an entity type in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -486,6 +495,9 @@ public final EntityType createEntityType(CreateEntityTypeRequest request) {
   /**
    * Creates an entity type in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -513,6 +525,9 @@ public final UnaryCallable<CreateEntityTypeRequest, EntityType> createEntityType
   /**
    * Updates the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -540,6 +555,9 @@ public final EntityType updateEntityType(EntityType entityType, FieldMask update
   /**
    * Updates the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -565,6 +583,9 @@ public final EntityType updateEntityType(UpdateEntityTypeRequest request) {
   /**
    * Updates the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -590,6 +611,9 @@ public final UnaryCallable<UpdateEntityTypeRequest, EntityType> updateEntityType
   /**
    * Deletes the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -615,6 +639,9 @@ public final void deleteEntityType(EntityTypeName name) {
   /**
    * Deletes the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -639,6 +666,9 @@ public final void deleteEntityType(String name) {
   /**
    * Deletes the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -665,6 +695,9 @@ public final void deleteEntityType(DeleteEntityTypeRequest request) {
   /**
    * Deletes the specified entity type.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code

diff --git a/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java b/google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java
@@ -167,6 +167,9 @@ public final OperationsClient getOperationsClient() {
   /**
    * Creates a flow in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -195,6 +198,9 @@ public final Flow createFlow(AgentName parent, Flow flow) {
   /**
    * Creates a flow in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -220,6 +226,9 @@ public final Flow createFlow(String parent, Flow flow) {
   /**
    * Creates a flow in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -245,6 +254,9 @@ public final Flow createFlow(CreateFlowRequest request) {
   /**
    * Creates a flow in the specified agent.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -591,6 +603,9 @@ public final UnaryCallable<GetFlowRequest, Flow> getFlowCallable() {
   /**
    * Updates the specified flow.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -616,6 +631,9 @@ public final Flow updateFlow(Flow flow, FieldMask updateMask) {
   /**
    * Updates the specified flow.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -641,6 +659,9 @@ public final Flow updateFlow(UpdateFlowRequest request) {
   /**
    * Updates the specified flow.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -665,6 +686,9 @@ public final UnaryCallable<UpdateFlowRequest, Flow> updateFlowCallable() {
   /**
    * Trains the specified flow. Note that only the flow in 'draft' environment is trained.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -688,6 +712,9 @@ public final OperationFuture<Empty, Struct> trainFlowAsync(FlowName name) {
   /**
    * Trains the specified flow. Note that only the flow in 'draft' environment is trained.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -710,6 +737,9 @@ public final OperationFuture<Empty, Struct> trainFlowAsync(String name) {
   /**
    * Trains the specified flow. Note that only the flow in 'draft' environment is trained.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -733,6 +763,9 @@ public final OperationFuture<Empty, Struct> trainFlowAsync(TrainFlowRequest requ
   /**
    * Trains the specified flow. Note that only the flow in 'draft' environment is trained.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -756,6 +789,9 @@ public final OperationCallable<TrainFlowRequest, Empty, Struct> trainFlowOperati
   /**
    * Trains the specified flow. Note that only the flow in 'draft' environment is trained.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -938,6 +974,9 @@ public final FlowValidationResult getFlowValidationResult(
   /**
    * Imports the specified flow to the specified agent from a binary file.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -962,6 +1001,9 @@ public final OperationFuture<ImportFlowResponse, Struct> importFlowAsync(
   /**
    * Imports the specified flow to the specified agent from a binary file.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code
@@ -986,6 +1028,9 @@ public final OperationFuture<ImportFlowResponse, Struct> importFlowAsync(
   /**
    * Imports the specified flow to the specified agent from a binary file.
    *
+   * <p>Note: You should always train a flow prior to sending it queries. See the [training
+   * documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
+   *
    * <p>Sample code:
    *
    * <pre>{@code