feat: removed OPTIONAL for speech model variant feat: supported the k…

…nowledge base in knowledge operation metadata docs: added more docs for speech model variant and improved docs format for participant (#799) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 416079874 Source-Link: googleapis/googleapis@18c59ec Source-Link: googleapis/googleapis-gen@20123be Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjAxMjNiZWMzNmEyNDhhYzBlMzUyYjExODU0Yjg1ZmE2YzQyZDU3ZCJ9
googleapis · Dec 13, 2021 · feac480 · feac480
1 parent 8e9684e
commit feac480
Show file tree

Hide file tree

Showing 42 changed files with 1,460 additions and 1,530 deletions.
diff --git a/...ialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/ParticipantsGrpc.java b/...ialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/ParticipantsGrpc.java
@@ -21,8 +21,7 @@
  *
  *
  * <pre>
- * Service for managing
- * [Participants][google.cloud.dialogflow.v2beta1.Participant].
+ * Service for managing [Participants][google.cloud.dialogflow.v2beta1.Participant].
  * </pre>
  */
 @javax.annotation.Generated(
@@ -550,8 +549,7 @@ public ParticipantsFutureStub newStub(
    *
    *
    * <pre>
-   * Service for managing
-   * [Participants][google.cloud.dialogflow.v2beta1.Participant].
+   * Service for managing [Participants][google.cloud.dialogflow.v2beta1.Participant].
    * </pre>
    */
   public abstract static class ParticipantsImplBase implements io.grpc.BindableService {
@@ -641,12 +639,9 @@ public void analyzeContent(
      * <pre>
      * Gets suggested articles for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     public void suggestArticles(
@@ -695,9 +690,9 @@ public void suggestSmartReplies(
      * <pre>
      * Deprecated: Use inline suggestion, event based suggestion or
      * Suggestion* API instead.
-     * See
-     * [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name]
-     * for more details. Removal Date: 2020-09-01.
+     * See [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name] for more
+     * details.
+     * Removal Date: 2020-09-01.
      * Retrieves suggestions for live agents.
      * This method should be used by human agent client software to fetch auto
      * generated suggestions in real-time, while the conversation with an end user
@@ -726,19 +721,12 @@ public void listSuggestions(
      *
      *
      * <pre>
-     * Deprecated. use
-     * [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles]
-     * and
-     * [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers]
-     * instead.
+     * Deprecated. use [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles] and [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers] instead.
      * Gets suggestions for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     @java.lang.Deprecated
@@ -831,8 +819,7 @@ public final io.grpc.ServerServiceDefinition bindService() {
    *
    *
    * <pre>
-   * Service for managing
-   * [Participants][google.cloud.dialogflow.v2beta1.Participant].
+   * Service for managing [Participants][google.cloud.dialogflow.v2beta1.Participant].
    * </pre>
    */
   public static final class ParticipantsStub
@@ -941,12 +928,9 @@ public void analyzeContent(
      * <pre>
      * Gets suggested articles for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     public void suggestArticles(
@@ -1001,9 +985,9 @@ public void suggestSmartReplies(
      * <pre>
      * Deprecated: Use inline suggestion, event based suggestion or
      * Suggestion* API instead.
-     * See
-     * [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name]
-     * for more details. Removal Date: 2020-09-01.
+     * See [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name] for more
+     * details.
+     * Removal Date: 2020-09-01.
      * Retrieves suggestions for live agents.
      * This method should be used by human agent client software to fetch auto
      * generated suggestions in real-time, while the conversation with an end user
@@ -1034,19 +1018,12 @@ public void listSuggestions(
      *
      *
      * <pre>
-     * Deprecated. use
-     * [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles]
-     * and
-     * [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers]
-     * instead.
+     * Deprecated. use [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles] and [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers] instead.
      * Gets suggestions for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     @java.lang.Deprecated
@@ -1065,8 +1042,7 @@ public void compileSuggestion(
    *
    *
    * <pre>
-   * Service for managing
-   * [Participants][google.cloud.dialogflow.v2beta1.Participant].
+   * Service for managing [Participants][google.cloud.dialogflow.v2beta1.Participant].
    * </pre>
    */
   public static final class ParticipantsBlockingStub
@@ -1156,12 +1132,9 @@ public com.google.cloud.dialogflow.v2beta1.AnalyzeContentResponse analyzeContent
      * <pre>
      * Gets suggested articles for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     public com.google.cloud.dialogflow.v2beta1.SuggestArticlesResponse suggestArticles(
@@ -1204,9 +1177,9 @@ public com.google.cloud.dialogflow.v2beta1.SuggestSmartRepliesResponse suggestSm
      * <pre>
      * Deprecated: Use inline suggestion, event based suggestion or
      * Suggestion* API instead.
-     * See
-     * [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name]
-     * for more details. Removal Date: 2020-09-01.
+     * See [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name] for more
+     * details.
+     * Removal Date: 2020-09-01.
      * Retrieves suggestions for live agents.
      * This method should be used by human agent client software to fetch auto
      * generated suggestions in real-time, while the conversation with an end user
@@ -1233,19 +1206,12 @@ public com.google.cloud.dialogflow.v2beta1.ListSuggestionsResponse listSuggestio
      *
      *
      * <pre>
-     * Deprecated. use
-     * [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles]
-     * and
-     * [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers]
-     * instead.
+     * Deprecated. use [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles] and [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers] instead.
      * Gets suggestions for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     @java.lang.Deprecated
@@ -1260,8 +1226,7 @@ public com.google.cloud.dialogflow.v2beta1.CompileSuggestionResponse compileSugg
    *
    *
    * <pre>
-   * Service for managing
-   * [Participants][google.cloud.dialogflow.v2beta1.Participant].
+   * Service for managing [Participants][google.cloud.dialogflow.v2beta1.Participant].
    * </pre>
    */
   public static final class ParticipantsFutureStub
@@ -1356,12 +1321,9 @@ protected ParticipantsFutureStub build(
      * <pre>
      * Gets suggested articles for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<
@@ -1408,9 +1370,9 @@ protected ParticipantsFutureStub build(
      * <pre>
      * Deprecated: Use inline suggestion, event based suggestion or
      * Suggestion* API instead.
-     * See
-     * [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name]
-     * for more details. Removal Date: 2020-09-01.
+     * See [HumanAgentAssistantConfig.name][google.cloud.dialogflow.v2beta1.HumanAgentAssistantConfig.name] for more
+     * details.
+     * Removal Date: 2020-09-01.
      * Retrieves suggestions for live agents.
      * This method should be used by human agent client software to fetch auto
      * generated suggestions in real-time, while the conversation with an end user
@@ -1438,19 +1400,12 @@ protected ParticipantsFutureStub build(
      *
      *
      * <pre>
-     * Deprecated. use
-     * [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles]
-     * and
-     * [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers]
-     * instead.
+     * Deprecated. use [SuggestArticles][google.cloud.dialogflow.v2beta1.Participants.SuggestArticles] and [SuggestFaqAnswers][google.cloud.dialogflow.v2beta1.Participants.SuggestFaqAnswers] instead.
      * Gets suggestions for a participant based on specific historical
      * messages.
-     * Note that
-     * [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions]
-     * will only list the auto-generated suggestions, while
-     * [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion]
-     * will try to compile suggestion based on the provided conversation context
-     * in the real time.
+     * Note that [ListSuggestions][google.cloud.dialogflow.v2beta1.Participants.ListSuggestions] will only list the auto-generated
+     * suggestions, while [CompileSuggestion][google.cloud.dialogflow.v2beta1.Participants.CompileSuggestion] will try to compile suggestion
+     * based on the provided conversation context in the real time.
      * </pre>
      */
     @java.lang.Deprecated

diff --git a/...flow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AnalyzeContentRequest.java b/...flow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/AnalyzeContentRequest.java
@@ -22,8 +22,7 @@
  *
  *
  * <pre>
- * The request message for
- * [Participants.AnalyzeContent][google.cloud.dialogflow.v2beta1.Participants.AnalyzeContent].
+ * The request message for [Participants.AnalyzeContent][google.cloud.dialogflow.v2beta1.Participants.AnalyzeContent].
  * </pre>
  *
  * Protobuf type {@code google.cloud.dialogflow.v2beta1.AnalyzeContentRequest}
@@ -984,8 +983,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * The request message for
-   * [Participants.AnalyzeContent][google.cloud.dialogflow.v2beta1.Participants.AnalyzeContent].
+   * The request message for [Participants.AnalyzeContent][google.cloud.dialogflow.v2beta1.Participants.AnalyzeContent].
    * </pre>
    *
    * Protobuf type {@code google.cloud.dialogflow.v2beta1.AnalyzeContentRequest}