Refactor to use Gemini.NET library for content generation

Refactored multiple files to use the Gemini.NET library for generating content and validating API keys. Updated request construction and response handling across various scopes. Removed `Generator.cs` and added `GeminiGenerator.cs` for similar functionality. Modified `index.js` for local development. Updated `Events.csproj` to include the new package and project references.

Author: PHAN Xuan Quang

Diff for: EngAce.Api/Controllers/HealthcheckController.cs

@@ -21,16 +21,15 @@ public async Task<ActionResult<string>> Healthcheck()
                 return Unauthorized("Invalid Access Key");
             }
 
-            try
+            var isValidApiKey = await HealthcheckScope.Healthcheck(_accessKey);
+            if (isValidApiKey)
             {
-                var result = await HealthcheckScope.Healthcheck(_accessKey);
                 _logger.LogInformation("Gemini API Key: {ApiKey}", _accessKey);
-
-                return Ok(result);
+                return Ok(isValidApiKey);
             }
-            catch (Exception ex)
+            else
             {
-                return Unauthorized(ex.Message);
+                return Unauthorized("Invalid Access Key");
             }
         }
     }

Diff for: Events/ChatScope.cs

@@ -6,9 +6,13 @@
     <Nullable>enable</Nullable>
   </PropertyGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Gemini.NET" Version="1.1.1" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\Entities\Entities.csproj" />
-    <ProjectReference Include="..\Gemini\Gemini.csproj" />
+    <ProjectReference Include="..\Helper\Helper.csproj" />
   </ItemGroup>
 
 </Project>

Diff for: Events/Events.csproj

@@ -1,11 +1,14 @@
-namespace Events
+using Gemini.NET;
+
+namespace Events
 {
     public static class HealthcheckScope
     {
-        public static async Task<string> Healthcheck(string apiKey)
+        public static async Task<bool> Healthcheck(string apiKey)
         {
-            var prompt = "Say `I am Gemini` to me!";
-            return await Gemini.Generator.GenerateContent(apiKey, "You are my helpful assistant", prompt, false, 10);
+            var generator = new Generator(apiKey);
+
+            return await generator.IsValidApiKeyAsync();
         }
     }
 }

Diff for: Events/HealthcheckScope.cs

@@ -1,8 +1,8 @@
 using Entities;
 using Entities.Enums;
-using Gemini;
+using Gemini.NET;
 using Helper;
-using Newtonsoft.Json;
+using Helpers;
 using System.Text;
 
 namespace Events
@@ -163,13 +163,23 @@ private static async Task<List<Quiz>> GenerateQuizesForLessThan15(string apiKey,
                 promptBuilder.AppendLine($"Generate a set of multiple-choice English questions consisting of {questionsCount} to {questionsCount + 5} questions related to the topic '{topic.Trim()}' for me to practice, the quiz should be of the types: {types}");
                 promptBuilder.AppendLine();
                 promptBuilder.AppendLine("The generated questions should be of the types:");
-                foreach ( var type in quizzTypes )
+                foreach (var type in quizzTypes)
                 {
                     promptBuilder.AppendLine($"- {GeneralHelper.GetEnumDescription(type)}");
                 }
 
-                var response = await Generator.GenerateContent(apiKey, Instruction, promptBuilder.ToString(), true, 30);
-                return [.. JsonConvert.DeserializeObject<List<Quiz>>(response)];
+                var generator = new Generator(apiKey);
+
+                var apiRequest = new ApiRequestBuilder()
+                    .WithSystemInstruction(Instruction)
+                    .WithPrompt(promptBuilder.ToString())
+                    .WithDefaultGenerationConfig(0.3F, Models.Enums.ResponseMimeType.Json)
+                    .DisableAllSafetySettings()
+                    .Build();
+
+                var response = await generator.GenerateContentAsync(apiRequest);
+
+                return [.. JsonHelper.AsObject<List<Quiz>>(response.Result)];
             }
             catch
             {
@@ -195,9 +205,19 @@ private static async Task<List<Quiz>> GenerateQuizesByType(string apiKey, string
                 promptBuilder.AppendLine();
                 promptBuilder.AppendLine($"Generate a set of multiple-choice English questions consisting of {questionsCount} to {questionsCount + 5} questions related to the topic '{topic.Trim()}' for me to practice, the type of the questions must be: {type}");
 
-                var response = await Generator.GenerateContent(apiKey, Instruction, promptBuilder.ToString(), true, 40);
+                var generator = new Generator(apiKey);
+
+                var apiRequest = new ApiRequestBuilder()
+                    .WithSystemInstruction(Instruction)
+                    .WithPrompt(promptBuilder.ToString())
+                    .WithDefaultGenerationConfig(1, Models.Enums.ResponseMimeType.Json)
+                    .DisableAllSafetySettings()
+                    .Build();
 
-                return JsonConvert.DeserializeObject<List<Quiz>>(response)
+                //var response = await GeminiGenerator.GenerateContent(apiKey, Instruction, promptBuilder.ToString(), true, 40);
+                var response = await generator.GenerateContentAsync(apiRequest);
+
+                return JsonHelper.AsObject<List<Quiz>>(response.Result)
                     .Take(questionsCount)
                     .Select(quiz =>
                     {
@@ -240,8 +260,17 @@ public static async Task<List<string>> SuggestTopcis(string apiKey, EnglishLevel
             promptBuilder.AppendLine();
             promptBuilder.AppendLine("Make sure that each topic is unique, concise, and relevant for practicing English at different levels, especially intermediate to advanced.");
 
-            var response = await Generator.GenerateContent(apiKey, instruction, promptBuilder.ToString(), true, 75);
-            return [.. JsonConvert.DeserializeObject<List<string>>(response)];
+            var generator = new Generator(apiKey);
+
+            var apiRequest = new ApiRequestBuilder()
+                .WithSystemInstruction(instruction)
+                .WithPrompt(promptBuilder.ToString())
+                .WithDefaultGenerationConfig(0.7F, Models.Enums.ResponseMimeType.Json)
+                .DisableAllSafetySettings()
+                .Build();
+
+            var response = await generator.GenerateContentAsync(apiRequest);
+            return [.. JsonHelper.AsObject<List<string>>(response.Result)];
         }
 
         private static string GetLevelDescription(EnglishLevel level)

Diff for: Events/QuizScope.cs

@@ -1,8 +1,9 @@
 using Entities;
 using Entities.Enums;
-using Gemini;
+using Gemini.NET;
 using Helper;
-using Newtonsoft.Json;
+using Helpers;
+using Models.Enums;
 using System.Text;
 
 namespace Events
@@ -137,8 +138,18 @@ public static async Task<Comment> GenerateReview(string apiKey, EnglishLevel lev
             promptBuilder.AppendLine("## My writting for you to review: ");
             promptBuilder.AppendLine(content.Trim());
 
-            var result = await Generator.GenerateContent(apiKey, instructionBuilder.ToString(), promptBuilder.ToString(), true, 30, GenerativeModel.Gemini_20_Flash_Thinking);
-            return JsonConvert.DeserializeObject<Comment>(result);
+            var generator = new Generator(apiKey);
+
+            var apiRequest = new ApiRequestBuilder()
+                .WithSystemInstruction(instructionBuilder.ToString())
+                .WithPrompt(promptBuilder.ToString())
+                .WithDefaultGenerationConfig(0.5F, ResponseMimeType.Json)
+                .DisableAllSafetySettings()
+                .Build();
+
+            var response = await generator.GenerateContentAsync(apiRequest, ModelVersion.Gemini_20_Flash_Thinking);
+
+            return JsonHelper.AsObject<Comment>(response.Result);
         }
     }
 }

Diff for: Events/ReviewScope.cs

@@ -1,4 +1,6 @@
-using System.Text;
+using Gemini.NET;
+using Models.Enums;
+using System.Text;
 
 namespace Events
 {
@@ -117,7 +119,21 @@ Người dùng có thể nhập vào từ hoặc cụm từ tiếng Anh để tr
                 promptBuilder.AppendLine($"- {context.Trim()}");
             }
 
-            return await Gemini.Generator.GenerateContent(apiKey, useEnglish ? instructionforEnglish : instructionforVietnamese, promptBuilder.ToString().Trim(), false, 50, Gemini.GenerativeModel.Gemini_20_Flash_Lite);
+            var generator = new Generator(apiKey)
+                .ExcludesSearchEntryPointFromResponse()
+                .ExcludesGroundingDetailFromResponse();
+
+            var apiRequest = new ApiRequestBuilder()
+                .WithSystemInstruction(useEnglish ? instructionforEnglish : instructionforVietnamese)
+                .WithPrompt(promptBuilder.ToString())
+                .WithDefaultGenerationConfig(0.5F)
+                .DisableAllSafetySettings()
+                .EnableGrounding()
+                .Build();
+
+            var response = await generator.GenerateContentAsync(apiRequest, ModelVersion.Gemini_20_Flash);
+
+            return response.Result;
         }
     }
 }

Diff for: Events/SearchScope.cs

@@ -6,7 +6,7 @@
 
 namespace Gemini
 {
-    public static class Generator
+    public static class GeminiGenerator
     {
         private static readonly HttpClient Client = new();