Ragent 0.0.1.2

Ragent

A lightweight .NET agentic framework with tool discovery, LLM abstraction, and configuration.

Installation

dotnet add package Ragent

Quick Start

using Microsoft.Extensions.Logging;
using Ragent.Agent;
using Ragent.Config;
using Ragent.LLMClients;

var loggerFactory = LoggerFactory.Create(b => b.AddConsole());
var logger = loggerFactory.CreateLogger<Agent>();

var agent = new Agent(logger, new AgentConfig {
    Model = EModel.GEMINI_2_5_FLASH
});

agent.OnMessageReceived = async () => {
    Console.WriteLine(agent.ChatHistory.Last().Content);
    await Task.CompletedTask;
};

await agent.ProcessMessage("What is the square root of 144?");

Configuration

AgentConfig controls all agent behaviour:

var config = new AgentConfig {
    Model                  = EModel.GEMINI_2_5_FLASH,
    MaxIterations          = 5,
    MaxToolRetries         = 2,
    MaxChatHistorySize     = 50,
    ExtraSystemInstructions = "Always respond concisely.",
    SystemPromptOverride   = null,           // replaces the built-in prompt entirely
    ToolIdsBlackList       = ["query_db"],   // tool IDs to hide from the LLM
    AdditionalAssemblies   = [typeof(RagentTools).Assembly]  // third-party tool packages
};

Supported Models

Defining Tools

Tools are discovered automatically from the entry assembly. Decorate a static class and its methods:

using Ragent.Reflection;

[ToolCollection]
public static class MathTools
{
    [Tool(Id = "sqrt", Name = "Square Root", Description = "Returns the square root of a number")]
    public static double SquareRoot(
        [ToolParam(Description = "The input number")] double value)
        => Math.Sqrt(value);
}

• [ToolCollection] marks a class as a source of tools.
• [Tool] marks a public static method as an invocable tool.
• [ToolParam] annotates parameters with descriptions sent to the LLM.

Tool Discovery

Ragent scans three sources for tools automatically:

1. Ragent core assembly — built-in tools.
2. Entry assembly — your application's tools, discovered automatically with no configuration.
3. AdditionalAssemblies — third-party tool packages (e.g. Ragent.Tools).

// Load built-in Ragent.Tools package alongside your own tools
AdditionalAssemblies = [typeof(RagentTools).Assembly]

Dependency Injection (Blazor / ASP.NET Core)

builder.Services.AddSingleton(new AgentConfig { Model = EModel.GEMINI_2_5_FLASH });
builder.Services.AddScoped<Agent>();

Events

// Func<Task> — awaited by the agent after every status change
agent.OnMessageReceived = () => InvokeAsync(StateHasChanged);

Source & Issues

github.com/RoryLinnane-Evolve/Agent