AgentTools.Llm 1.0.0

AgentTools.Llm

A flexible .NET library for integrating with various Large Language Model (LLM) providers. This library provides a unified interface for working with different LLM providers while maintaining the ability to use provider-specific features.

Features

• Unified interface for different LLM providers
• Support for both text completion and chat completion
• Configurable completion options
• Easy provider registration and management
• Extensible architecture for adding new providers

Installation

Add the package to your project using NuGet:

dotnet add package AgentTools.Llm

Usage

Basic Usage

using AgentTools.Llm.Providers;
using AgentTools.Llm.Models;

// Create a provider factory
var factory = new LlmProviderFactory();

// Create and register OpenAI providers with different models
var gpt35Provider = new OpenAiProvider(
    apiKey: "your-api-key-here",
    modelName: "gpt-3.5-turbo",
    providerId: "gpt-35" // Unique identifier for this provider instance
);
var gpt4Provider = new OpenAiProvider(
    apiKey: "your-api-key-here",
    modelName: "gpt-4",
    providerId: "gpt-4"
);
factory.RegisterProvider(gpt35Provider);
factory.RegisterProvider(gpt4Provider);

// Get the specific provider instance you want to use
var provider = factory.GetProvider("gpt-35"); // or "gpt-4"

// Generate a completion
var response = await provider.GenerateCompletionAsync(
    "What is the capital of France?",
    new CompletionOptions { Temperature = 0.7f }
);

Using Different Models for Different Scenarios

// Create a provider registry to manage different models
public class LlmProviderRegistry
{
    private readonly LlmProviderFactory _factory;
    
    public LlmProviderRegistry(LlmProviderFactory factory)
    {
        _factory = factory;
    }
    
    public ILlmProvider GetProviderForScenario(string scenario)
    {
        return scenario switch
        {
            "chat" => _factory.GetProvider("gpt-35"),
            "code" => _factory.GetProvider("gpt-4"),
            "analysis" => _factory.GetProvider("gpt-4"),
            _ => _factory.GetProvider("gpt-35") // Default fallback
        };
    }
}

// Usage
var registry = new LlmProviderRegistry(factory);
var chatProvider = registry.GetProviderForScenario("chat");
var codeProvider = registry.GetProviderForScenario("code");

Chat Completion

var messages = new[]
{
    new ChatMessage("system", "You are a helpful assistant."),
    new ChatMessage("user", "What is the capital of France?")
};

var response = await provider.GenerateChatCompletionAsync(messages);

Using Custom Options

var options = new CompletionOptions
{
    Temperature = 0.2f,
    MaxTokens = 100,
    TopP = 0.9f,
    FrequencyPenalty = 0.5f,
    PresencePenalty = 0.5f,
    StopSequences = new[] { "\n" }
};

var response = await provider.GenerateCompletionAsync("Write a short poem.", options);

Configuration

OpenAI Configuration

var config = new OpenAiConfiguration(
    apiKey: "your-api-key-here",
    defaultModel: "gpt-3.5-turbo",
    organizationId: "optional-org-id"
);

License

This project is licensed under the MIT License - see the LICENSE file for details.