docs: recommend AnalyzeContent for future users (#745)

* docs: recommend AnalyzeContent for future users PiperOrigin-RevId: 402401837 Source-Link: googleapis/googleapis@16ff813 Source-Link: https://github.com/googleapis/googleapis-gen/commit/c9e6ac25d5e309170f1805bf8ea382a8b23dee65 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzllNmFjMjVkNWUzMDkxNzBmMTgwNWJmOGVhMzgyYThiMjNkZWU2NSJ9 * 🦉 Updates from OwlBot See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2/SessionsClient.java

@@ -147,6 +147,12 @@ public SessionsStub getStub() {
  * method is not idempotent, because it may cause contexts and session entity types to be updated,
  * which in turn might affect results of future queries.
  *
+ * <p>If you might use [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa) or other CCAI
+ * products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent] instead of
+ * `DetectIntent`. `AnalyzeContent` has additional functionality for Agent Assist and other CCAI
+ * products.
+ *
  * <p>Note: Always use agent versions for production traffic. See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
  *
@@ -195,6 +201,12 @@ public final DetectIntentResponse detectIntent(SessionName session, QueryInput q
  * method is not idempotent, because it may cause contexts and session entity types to be updated,
  * which in turn might affect results of future queries.
  *
+ * <p>If you might use [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa) or other CCAI
+ * products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent] instead of
+ * `DetectIntent`. `AnalyzeContent` has additional functionality for Agent Assist and other CCAI
+ * products.
+ *
  * <p>Note: Always use agent versions for production traffic. See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
  *
@@ -240,6 +252,12 @@ public final DetectIntentResponse detectIntent(String session, QueryInput queryI
  * method is not idempotent, because it may cause contexts and session entity types to be updated,
  * which in turn might affect results of future queries.
  *
+ * <p>If you might use [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa) or other CCAI
+ * products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent] instead of
+ * `DetectIntent`. `AnalyzeContent` has additional functionality for Agent Assist and other CCAI
+ * products.
+ *
  * <p>Note: Always use agent versions for production traffic. See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
  *
@@ -273,6 +291,12 @@ public final DetectIntentResponse detectIntent(DetectIntentRequest request) {
  * method is not idempotent, because it may cause contexts and session entity types to be updated,
  * which in turn might affect results of future queries.
  *
+ * <p>If you might use [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa) or other CCAI
+ * products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent] instead of
+ * `DetectIntent`. `AnalyzeContent` has additional functionality for Agent Assist and other CCAI
+ * products.
+ *
  * <p>Note: Always use agent versions for production traffic. See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
  *
@@ -306,6 +330,12 @@ public final UnaryCallable<DetectIntentRequest, DetectIntentResponse> detectInte
  * structured, actionable data as a result. This method is only available via the gRPC API (not
  * REST).
  *
+ * <p>If you might use [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa) or other CCAI
+ * products now or in the future, consider using
+ * [StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent]
+ * instead of `StreamingDetectIntent`. `StreamingAnalyzeContent` has additional functionality for
+ * Agent Assist and other CCAI products.
+ *
  * <p>Note: Always use agent versions for production traffic. See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
  *

grpc-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/SessionsGrpc.java

@@ -190,6 +190,12 @@ public abstract static class SessionsImplBase implements io.grpc.BindableService
  * as a result. This method is not idempotent, because it may cause contexts
  * and session entity types to be updated, which in turn might affect
  * results of future queries.
+ * If you might use
+ * [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ * or other CCAI products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
+ * instead of `DetectIntent`. `AnalyzeContent` has additional
+ * functionality for Agent Assist and other CCAI products.
  * Note: Always use agent versions for production traffic.
  * See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
@@ -210,6 +216,12 @@ public void detectIntent(
  * Processes a natural language query in audio format in a streaming fashion
  * and returns structured, actionable data as a result. This method is only
  * available via the gRPC API (not REST).
+ * If you might use
+ * [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ * or other CCAI products now or in the future, consider using
+ * [StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent]
+ * instead of `StreamingDetectIntent`. `StreamingAnalyzeContent` has
+ * additional functionality for Agent Assist and other CCAI products.
  * Note: Always use agent versions for production traffic.
  * See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
@@ -272,6 +284,12 @@ protected SessionsStub build(io.grpc.Channel channel, io.grpc.CallOptions callOp
  * as a result. This method is not idempotent, because it may cause contexts
  * and session entity types to be updated, which in turn might affect
  * results of future queries.
+ * If you might use
+ * [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ * or other CCAI products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
+ * instead of `DetectIntent`. `AnalyzeContent` has additional
+ * functionality for Agent Assist and other CCAI products.
  * Note: Always use agent versions for production traffic.
  * See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
@@ -294,6 +312,12 @@ public void detectIntent(
  * Processes a natural language query in audio format in a streaming fashion
  * and returns structured, actionable data as a result. This method is only
  * available via the gRPC API (not REST).
+ * If you might use
+ * [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ * or other CCAI products now or in the future, consider using
+ * [StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent]
+ * instead of `StreamingDetectIntent`. `StreamingAnalyzeContent` has
+ * additional functionality for Agent Assist and other CCAI products.
  * Note: Always use agent versions for production traffic.
  * See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
@@ -338,6 +362,12 @@ protected SessionsBlockingStub build(io.grpc.Channel channel, io.grpc.CallOption
  * as a result. This method is not idempotent, because it may cause contexts
  * and session entity types to be updated, which in turn might affect
  * results of future queries.
+ * If you might use
+ * [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ * or other CCAI products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
+ * instead of `DetectIntent`. `AnalyzeContent` has additional
+ * functionality for Agent Assist and other CCAI products.
  * Note: Always use agent versions for production traffic.
  * See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
@@ -378,6 +408,12 @@ protected SessionsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions
  * as a result. This method is not idempotent, because it may cause contexts
  * and session entity types to be updated, which in turn might affect
  * results of future queries.
+ * If you might use
+ * [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ * or other CCAI products now or in the future, consider using
+ * [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
+ * instead of `DetectIntent`. `AnalyzeContent` has additional
+ * functionality for Agent Assist and other CCAI products.
  * Note: Always use agent versions for production traffic.
  * See [Versions and
  * environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).

proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/session.proto

@@ -60,6 +60,13 @@ service Sessions {
  // and session entity types to be updated, which in turn might affect
  // results of future queries.
  //
+ // If you might use
+ // [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ // or other CCAI products now or in the future, consider using
+ // [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
+ // instead of `DetectIntent`. `AnalyzeContent` has additional
+ // functionality for Agent Assist and other CCAI products.
+ //
  // Note: Always use agent versions for production traffic.
  // See [Versions and
  // environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
@@ -87,6 +94,13 @@ service Sessions {
  // and returns structured, actionable data as a result. This method is only
  // available via the gRPC API (not REST).
  //
+ // If you might use
+ // [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
+ // or other CCAI products now or in the future, consider using
+ // [StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent]
+ // instead of `StreamingDetectIntent`. `StreamingAnalyzeContent` has
+ // additional functionality for Agent Assist and other CCAI products.
+ //
  // Note: Always use agent versions for production traffic.
  // See [Versions and
  // environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).