feat(genai): add tool samples (3)

genai/api/GenAI.Samples.Tests/Tools/ToolsEnterpriseWebSearchWithTxtTest.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 ToolsEnterpriseWebSearchWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ToolsEnterpriseWebSearchWithTxt _sample;
+
+    public ToolsEnterpriseWebSearchWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ToolsEnterpriseWebSearchWithTxt();
+    }
+
+    [Fact]
+    public async Task TestToolsEnterpriseWebSearchWithTxt()
+    {
+        var response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotEmpty(response);
+    }
+}

genai/api/GenAI.Samples.Tests/Tools/ToolsGoogleMapsCoordinatesWithTxtTest.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 ToolsGoogleMapsCoordinatesWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ToolsGoogleMapsCoordinatesWithTxt _sample;
+
+    public ToolsGoogleMapsCoordinatesWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ToolsGoogleMapsCoordinatesWithTxt();
+    }
+
+    [Fact]
+    public async Task TestToolsGoogleMapsCoordinatesWithTxt()
+    {
+        var response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotEmpty(response);
+    }
+}

genai/api/GenAI.Samples.Tests/Tools/ToolsGoogleSearchAndUrlContextWithTxtTest.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 ToolsGoogleSearchAndUrlContextWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ToolsGoogleSearchAndUrlContextWithTxt _sample;
+
+    public ToolsGoogleSearchAndUrlContextWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ToolsGoogleSearchAndUrlContextWithTxt();
+    }
+
+    [Fact]
+    public async Task TestToolsGoogleSearchAndUrlContextWithTxt()
+    {
+        var response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotEmpty(response);
+    }
+}

genai/api/GenAI.Samples/Tools/ToolsEnterpriseWebSearchWithTxt.cs

@@ -0,0 +1,56 @@
+/*
+ * 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_tools_enterprise_web_search_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+public class ToolsEnterpriseWebSearchWithTxt
+{
+    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: "When is the next total solar eclipse in the United States",
+            config: new GenerateContentConfig
+            {
+                Tools = new List<Tool>
+                {
+                    new Tool { EnterpriseWebSearch = new EnterpriseWebSearch() }
+                }
+            });
+
+        string responseText = response.Candidates[0].Content.Parts[0].Text;
+        Console.WriteLine(responseText);
+        // Example response:
+        // The next total solar eclipse in the United States will occur on...
+        return responseText;
+    }
+}
+// [END googlegenaisdk_tools_enterprise_web_search_with_txt]

genai/api/GenAI.Samples/Tools/ToolsGoogleMapsCoordinatesWithTxt.cs

@@ -0,0 +1,65 @@
+/*
+ * 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_tools_google_maps_coordinates_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+public class ToolsGoogleMapsCoordinatesWithTxt
+{
+    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: "Where can I get the best espresso near me?",
+            config: new GenerateContentConfig
+            {
+                Tools = new List<Tool>
+                {
+                    new Tool { GoogleMaps = new GoogleMaps() }
+                },
+                ToolConfig = new ToolConfig
+                {
+                    RetrievalConfig = new RetrievalConfig
+                    {
+                        LatLng = new LatLng { Latitude = 40.7128, Longitude = -74.006 },
+                        LanguageCode = "en_US"
+                    }
+                }
+            });
+
+        string responseText = response.Candidates[0].Content.Parts[0].Text;
+        Console.WriteLine(responseText);
+        // Example response:
+        // Here are some of the top-rated coffee shops near you that are
+        // open now and known for their espresso...
+        return responseText;
+    }
+}
+// [END googlegenaisdk_tools_google_maps_coordinates_with_txt]

genai/api/GenAI.Samples/Tools/ToolsGoogleSearchAndUrlContextWithTxt.cs

@@ -0,0 +1,64 @@
+/*
+ * 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_tools_google_search_and_urlcontext_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+public class ToolsGoogleSearchAndUrlContextWithTxt
+{
+    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 = "v1beta1" });
+
+        string url = "https://www.google.com/search?q=events+in+New+York";
+
+        GenerateContentResponse response = await client.Models.GenerateContentAsync(
+            model: model,
+            contents: $"Give me three day events schedule based on {url}." +
+            " Also let me know what needs to be taken care of considering weather and commute",
+            config: new GenerateContentConfig
+            {
+                Tools = new List<Tool>
+                {
+                    new Tool { UrlContext = new UrlContext() },
+                    new Tool { GoogleSearch = new GoogleSearch() },
+                },
+                ResponseModalities = new List<string> { "TEXT" }
+            });
+
+        string responseText = response.Candidates[0].Content.Parts[0].Text;
+        Console.WriteLine(responseText);
+        // Example response:
+        // Here is a three-day event schedule for New York City in mid-December,
+        // along with important considerations for weather and commute:
+        // **Three - Day Event Schedule**
+        // **Day 1...
+        return responseText;
+    }
+}
+// [END googlegenaisdk_tools_google_search_and_urlcontext_with_txt]