feat(genai): add provisioned throughput and controlled generation samples

genai/api/GenAI.Samples.Tests/ControlledGeneration/ControlledGenWithEnumSchemaTest.cs

@@ -0,0 +1,38 @@
+/*
+ * 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.
+ */
+
+using System.Threading.Tasks;
+using Xunit;
+
+[Collection(nameof(GenAIFixture))]
+public class ControlledGenWithEnumSchemaTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ControlledGenWithEnumSchema _sample;
+
+    public ControlledGenWithEnumSchemaTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ControlledGenWithEnumSchema();
+    }
+
+    [Fact]
+    public async Task TestControlledGenWithEnumSchema()
+    {
+        var response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotEmpty(response);
+    }
+}

genai/api/GenAI.Samples.Tests/ProvisionedThroughput/ProvisionedThroughputWithTxtTest.cs

@@ -0,0 +1,38 @@
+/*
+ * 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.
+ */
+
+using System.Threading.Tasks;
+using Xunit;
+
+[Collection(nameof(GenAIFixture))]
+public class ProvisionedThroughputWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ProvisionedThroughputWithTxt _sample;
+
+    public ProvisionedThroughputWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ProvisionedThroughputWithTxt();
+    }
+
+    [Fact]
+    public async Task TestProvisionedThroughputWithTxt()
+    {
+        var response = await _sample.GenerateContent(projectId: _fixture.ProjectId, throughputMode: "shared");
+        Assert.NotEmpty(response);
+    }
+}

genai/api/GenAI.Samples/ControlledGeneration/ControlledGenWithEnumSchema.cs

@@ -0,0 +1,57 @@
+/*
+ * 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.
+ */
+
+// [START googlegenaisdk_ctrlgen_with_enum_schema]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+public class ControlledGenWithEnumSchema
+{
+    public async Task<string> GenerateContent(
+        string projectId = "your-project-id",
+        string location = "global",
+        string model = "gemini-2.5-flash")
+    {
+        await using var client = new Client(
+            project: projectId,
+            location: location,
+            vertexAI: true,
+            httpOptions: new HttpOptions { ApiVersion = "v1" });
+
+        GenerateContentResponse response = await client.Models.GenerateContentAsync(
+            model: model,
+            contents: "What type of instrument is an oboe?",
+            config: new GenerateContentConfig
+            {
+                ResponseMimeType = "application/json",
+                ResponseJsonSchema = new Dictionary<string, object>
+                {
+                    { "type", "string" },
+                    { "enum", new List<string> { "Percussion", "String", "Woodwind", "Brass", "Keyboard" } }
+                }
+            });
+
+        string responseText = response.Candidates[0].Content.Parts[0].Text;
+        System.Console.WriteLine(responseText);
+        // Example response:
+        // Woodwind
+        return responseText;
+    }
+}
+// [END googlegenaisdk_ctrlgen_with_enum_schema]

genai/api/GenAI.Samples/ProvisionedThroughput/ProvisionedThroughputWithTxt.cs

@@ -0,0 +1,62 @@
+/*
+ * 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.
+ */
+
+// [START googlegenaisdk_provisionedthroughput_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+public class ProvisionedThroughputWithTxt
+{
+    public async Task<string> GenerateContent(
+        string projectId = "your-project-id",
+        string location = "us-central1",
+        string model = "gemini-2.5-flash",
+        string throughputMode = "dedicated")
+    {
+        await using var client = new Client(
+            project: projectId,
+            location: location,
+            vertexAI: true,
+            httpOptions: new HttpOptions
+            {
+                ApiVersion = "v1",
+                Headers = new Dictionary<string, string>
+                {
+                    // Options:
+                    // - "dedicated": Use Provisioned Throughput
+                    // - "shared": Use pay-as-you-go
+                    // https://cloud.google.com/vertex-ai/generative-ai/docs/use-provisioned-throughput
+                    { "X-Vertex-AI-LLM-Request-Type", throughputMode }
+                }
+            });
+
+        GenerateContentResponse response = await client.Models.GenerateContentAsync(model: model, contents: "How does AI work?");
+
+        string responseText = response.Candidates[0].Content.Parts[0].Text;
+        Console.WriteLine(responseText);
+        // Example response:
+        // At its core, **Artificial Intelligence (AI)** works by enabling machines to learn from data,
+        // identify patterns, and make decisions or predictions without being explicitly programmed for
+        // every possible scenario...
+        return responseText;
+    }
+}
+// [END googlegenaisdk_provisionedthroughput_with_txt]
+

genai/api/GenAI.Samples/TextGeneration/TextGenWithPdf.cs

@@ -64,7 +64,7 @@ Your task is to provide a concise executive summary of no more than 300 words.
 
         string responseText = response.Candidates[0].Content.Parts[0].Text;
         Console.WriteLine(responseText);
-        // Example reponse:
+        // Example response:
         // This paper introduces the Transformer, a novel neural network architecture designed
         // for processing sequences, such as those found in language translation. Traditionally,
         // such tasks have relied on complex recurrent or convolutional neural networks...

genai/api/GenAI.Samples/TextGeneration/TextGenWithTxt.cs

@@ -38,7 +38,7 @@ public async Task<string> GenerateContent(
 
         string responseText = response.Candidates[0].Content.Parts[0].Text;
         Console.WriteLine(responseText);
-        // Example reponse:
+        // Example response:
         // AI, or Artificial Intelligence, at its core, is about creating machines that can perform...
         // Here's a breakdown of how it generally works...
         return responseText;