feat: Add new RPC IngestContextReferences, GenerateSuggestions

docs: clarified wording around phrase_sets

PiperOrigin-RevId: 733912069

Source-Link: googleapis/googleapis@c57048e

Source-Link: googleapis/googleapis-gen@d295b21
Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuRGlhbG9nZmxvdy5WMi8uT3dsQm90LnlhbWwiLCJoIjoiZDI5NWIyMTA5MGNkOTBkMGIyZjg5NWQ1MjY5ZjcxOGIxZjlmYmVlOCJ9

Author: gcf-owl-bot[bot]

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateStatelessSuggestionRequestObjectAsyncSnippet.g.cs

@@ -40,6 +40,13 @@ public async Task GenerateStatelessSuggestionRequestObjectAsync()
             {
                 ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
                 Generator = new Generator(),
+                ContextReferences =
+                {
+                    {
+                        "",
+                        new Conversation.Types.ContextReference()
+                    },
+                },
                 ConversationContext = new ConversationContext(),
                 TriggerEvents =
                 {

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateStatelessSuggestionRequestObjectSnippet.g.cs

@@ -39,6 +39,13 @@ public void GenerateStatelessSuggestionRequestObject()
             {
                 ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
                 Generator = new Generator(),
+                ContextReferences =
+                {
+                    {
+                        "",
+                        new Conversation.Types.ContextReference()
+                    },
+                },
                 ConversationContext = new ConversationContext(),
                 TriggerEvents =
                 {

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateSuggestionsAsyncSnippet.g.cs

@@ -0,0 +1,44 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_GenerateSuggestions_async_flattened]
+    using Google.Cloud.Dialogflow.V2;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for GenerateSuggestionsAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task GenerateSuggestionsAsync()
+        {
+            // Create client
+            ConversationsClient conversationsClient = await ConversationsClient.CreateAsync();
+            // Initialize request argument(s)
+            string conversation = "projects/[PROJECT]/conversations/[CONVERSATION]";
+            // Make the request
+            GenerateSuggestionsResponse response = await conversationsClient.GenerateSuggestionsAsync(conversation);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_GenerateSuggestions_async_flattened]
+}

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateSuggestionsRequestObjectAsyncSnippet.g.cs

@@ -0,0 +1,52 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_GenerateSuggestions_async]
+    using Google.Cloud.Dialogflow.V2;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for GenerateSuggestionsAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task GenerateSuggestionsRequestObjectAsync()
+        {
+            // Create client
+            ConversationsClient conversationsClient = await ConversationsClient.CreateAsync();
+            // Initialize request argument(s)
+            GenerateSuggestionsRequest request = new GenerateSuggestionsRequest
+            {
+                ConversationAsConversationName = ConversationName.FromProjectConversation("[PROJECT]", "[CONVERSATION]"),
+                LatestMessageAsMessageName = MessageName.FromProjectConversationMessage("[PROJECT]", "[CONVERSATION]", "[MESSAGE]"),
+                TriggerEvents =
+                {
+                    TriggerEvent.Unspecified,
+                },
+            };
+            // Make the request
+            GenerateSuggestionsResponse response = await conversationsClient.GenerateSuggestionsAsync(request);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_GenerateSuggestions_async]
+}

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateSuggestionsRequestObjectSnippet.g.cs

@@ -0,0 +1,51 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_GenerateSuggestions_sync]
+    using Google.Cloud.Dialogflow.V2;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for GenerateSuggestions</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void GenerateSuggestionsRequestObject()
+        {
+            // Create client
+            ConversationsClient conversationsClient = ConversationsClient.Create();
+            // Initialize request argument(s)
+            GenerateSuggestionsRequest request = new GenerateSuggestionsRequest
+            {
+                ConversationAsConversationName = ConversationName.FromProjectConversation("[PROJECT]", "[CONVERSATION]"),
+                LatestMessageAsMessageName = MessageName.FromProjectConversationMessage("[PROJECT]", "[CONVERSATION]", "[MESSAGE]"),
+                TriggerEvents =
+                {
+                    TriggerEvent.Unspecified,
+                },
+            };
+            // Make the request
+            GenerateSuggestionsResponse response = conversationsClient.GenerateSuggestions(request);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_GenerateSuggestions_sync]
+}

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateSuggestionsResourceNamesAsyncSnippet.g.cs

@@ -0,0 +1,44 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_GenerateSuggestions_async_flattened_resourceNames]
+    using Google.Cloud.Dialogflow.V2;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for GenerateSuggestionsAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task GenerateSuggestionsResourceNamesAsync()
+        {
+            // Create client
+            ConversationsClient conversationsClient = await ConversationsClient.CreateAsync();
+            // Initialize request argument(s)
+            ConversationName conversation = ConversationName.FromProjectConversation("[PROJECT]", "[CONVERSATION]");
+            // Make the request
+            GenerateSuggestionsResponse response = await conversationsClient.GenerateSuggestionsAsync(conversation);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_GenerateSuggestions_async_flattened_resourceNames]
+}

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateSuggestionsResourceNamesSnippet.g.cs

@@ -0,0 +1,43 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_GenerateSuggestions_sync_flattened_resourceNames]
+    using Google.Cloud.Dialogflow.V2;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for GenerateSuggestions</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void GenerateSuggestionsResourceNames()
+        {
+            // Create client
+            ConversationsClient conversationsClient = ConversationsClient.Create();
+            // Initialize request argument(s)
+            ConversationName conversation = ConversationName.FromProjectConversation("[PROJECT]", "[CONVERSATION]");
+            // Make the request
+            GenerateSuggestionsResponse response = conversationsClient.GenerateSuggestions(conversation);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_GenerateSuggestions_sync_flattened_resourceNames]
+}

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.GenerateSuggestionsSnippet.g.cs

@@ -0,0 +1,43 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_GenerateSuggestions_sync_flattened]
+    using Google.Cloud.Dialogflow.V2;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for GenerateSuggestions</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void GenerateSuggestions()
+        {
+            // Create client
+            ConversationsClient conversationsClient = ConversationsClient.Create();
+            // Initialize request argument(s)
+            string conversation = "projects/[PROJECT]/conversations/[CONVERSATION]";
+            // Make the request
+            GenerateSuggestionsResponse response = conversationsClient.GenerateSuggestions(conversation);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_GenerateSuggestions_sync_flattened]
+}

apis/Google.Cloud.Dialogflow.V2/Google.Cloud.Dialogflow.V2.GeneratedSnippets/ConversationsClient.IngestContextReferencesAsyncSnippet.g.cs

@@ -0,0 +1,52 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START dialogflow_v2_generated_Conversations_IngestContextReferences_async_flattened]
+    using Google.Cloud.Dialogflow.V2;
+    using System.Collections.Generic;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedConversationsClientSnippets
+    {
+        /// <summary>Snippet for IngestContextReferencesAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task IngestContextReferencesAsync()
+        {
+            // Create client
+            ConversationsClient conversationsClient = await ConversationsClient.CreateAsync();
+            // Initialize request argument(s)
+            string conversation = "projects/[PROJECT]/conversations/[CONVERSATION]";
+            IDictionary<string, Conversation.Types.ContextReference> contextReferences = new Dictionary<string, Conversation.Types.ContextReference>
+            {
+                {
+                    "",
+                    new Conversation.Types.ContextReference()
+                },
+            };
+            // Make the request
+            IngestContextReferencesResponse response = await conversationsClient.IngestContextReferencesAsync(conversation, contextReferences);
+        }
+    }
+    // [END dialogflow_v2_generated_Conversations_IngestContextReferences_async_flattened]
+}