Getting Started with Smart PDF Viewer using Gemini AI Service
This guide provides step-by-step instructions for integrating and using Syncfusion’s Smart PDF Viewer with Gemini AI services in your Blazor App.
Prerequisites
Before you begin, ensure you have:
- System requirements for Blazor components
- Gemini API Key - Obtain an API key from Google AI Studio
Models
For a complete list of models and their capabilities, visit the Gemini Models Documentation.
Getting Started for Gemini AI with Smart PDF Viewer
After completing this setup, you can:
Install the following NuGet packages to your project:
open the NuGet package manager in Visual Studio (Tools → NuGet Package Manager → Manage NuGet Packages for Solution), search and install the following packages
1.Microsoft.Extensions.AI.
2.Microsoft.SemanticKernel.
3.Microsoft.SemanticKernel.Connectors.Google.
Step 1: Create a Custom AI Service
The Syncfusion Smart PDF Viewer are designed to work with different AI backends through the IChatInferenceService
interface. This section shows you how to create a custom implementation that connects the Smart PDF Viewer to the Gemini AI service.
Understanding the Interface
The IChatInferenceService
interface is the bridge between Syncfusion Smart PDF Viewer and AI services:
- Create a new file named
MyCustomService.cs
- Add the following implementation:
using Syncfusion.Blazor.AI;
using Microsoft.Extensions.AI;
public class MyCustomService : IChatInferenceService
{
private IChatClient _chatClient;
public MyCustomService(IChatClient client)
{
this._chatClient = client ?? throw new ArgumentNullException(nameof(client));
}
/// <summary>
/// Sends the chat parameters to the AI client and returns the response.
/// Also checks and updates token usage.
/// </summary>
/// <param name="options">Chat parameters including messages and settings.</param>
/// <returns>AI-generated response text.</returns
public async Task<string> GenerateResponseAsync(ChatParameters options)
{
ChatOptions completionRequest = new ChatOptions
{
Temperature = options.Temperature ?? 0.5f,
TopP = options.TopP ?? 1.0f,
MaxOutputTokens = options.MaxTokens ?? 2000,
FrequencyPenalty = options.FrequencyPenalty ?? 0.0f,
PresencePenalty = options.PresencePenalty ?? 0.0f,
StopSequences = options.StopSequences
};
try
{
ChatResponse completion = await _chatClient.GetResponseAsync(options.Messages[0].Text, completionRequest);
string rawResponse = completion.Text.ToString();
if (rawResponse.Contains("```html") || rawResponse.Contains("```"))
{
rawResponse = rawResponse.Replace("```html", "").Replace("```", "").Trim();
}
return rawResponse;
}
catch (Exception ex)
{
throw new ApplicationException("Error generating AI response", ex);
}
}
}
Step 2: Configure the Blazor App
Configure your Blazor application to use the Gemini AI service with Syncfusion Smart PDF Viewer. This involves registering necessary services and setting up the dependency injection container.
using Syncfusion.Blazor.AI;
using Microsoft.Extensions.AI;
using Microsoft.SemanticKernel;
using Microsoft.SemanticKernel.ChatCompletion;
var builder = WebApplication.CreateBuilder(args);
....
builder.Services.AddSyncfusionBlazor();
string geminiApiKey = "Your API Key" ?? throw new InvalidOperationException("GEMINI_API_KEY environment variable is not set.");
string geminiAiModel = "Your Model Name";
#pragma warning disable SKEXP0070
var kernelBuilder = Kernel.CreateBuilder().AddGoogleAIGeminiChatCompletion(geminiAiModel, geminiApiKey);
Kernel kernel = kernelBuilder.Build();
#pragma warning disable SKEXP0001
IChatClient geminiChatClient = kernel.GetRequiredService<IChatCompletionService>().AsChatClient();
builder.Services.AddChatClient(geminiChatClient);
builder.Services.AddScoped<IChatInferenceService, MyCustomService>(sp =>
{
return new MyCustomService(geminiChatClient);
});
var app = builder.Build();
....
NOTE