ResearchAI 1.0.0

💬 ResearchAI is an Azure OpenAI Chat Client (.NET)

This project provides a simple yet extensible .NET wrapper for Azure OpenAI's Chat Completion API, including:

• Per-session chat memory (thread-safe)
• Configurable ChatCompletionOptions (like temperature, penalties, token limits)
• Injection of system context
• Clean abstraction for chatbot/message processing

🚀 Features

• ✅ Session-based memory (thread-safe with ConcurrentDictionary)
• ✅ Configurable model behavior via ChatCompletionSettings
• ✅ Custom system context per session
• ✅ Automatically limits and validates Azure AI parameters

🔧 Configuration

Here’s how you can configure the client in your application:

{
  "AzureOpenAI": {
    "Endpoint": "https://<your-openai-resource>.openai.azure.com/",
    "Key": "<your-api-key>",
    "DeploymentName": "gpt-35-turbo",
    "SystemContext": "You are a creative assistant for generating photo captions.",
    "ChatCompletionSettings": {
      "Temperature": 0.8,
      "MaxOutputTokenCount": 800,
      "FrequencyPenalty": 0.2,
      "PresencePenalty": 0.3
    }
  }
}

🧪 Sample Usage

var options = new AzureOpenAIOptions
{
    Endpoint = "<your-endpoint>",
    Key = "<your-key>",
    DeploymentName = "gpt-35-turbo",
    SystemContext = "You are a helpful assistant.",
    ChatCompletionSettings = new ChatCompletionSettings
    {
        Temperature = 0.7f,
        MaxOutputTokenCount = 800,
        FrequencyPenalty = 0.0f,
        PresencePenalty = 0.0f
    }
};

var openAI = new AzureOpenAI(options);

var response = await openAI.SendMessageAsync("user-session-id", "Describe a sunset wedding on the beach.");
Console.WriteLine(response.Content[0].Text);

🧠 How It Works

• First message initializes a session with the system prompt.
• Each user message is added to the session history.
• The history is passed to Azure OpenAI to maintain conversation context.
• The assistant response is added back into the session.

📌 Notes

• Temperature and Penalty values are clamped to valid ranges (0–2).
• MaxOutputTokenCount is limited between 512 and 800 to fit model constraints.
• You must provide a valid sessionId for session tracking to work.

📦 Dependencies

• Azure.AI.OpenAI
• System.Collections.Concurrent

📄 License

Apache 2.0 License