Runiq.Agents 0.1.0-preview.7

Runiq.Agents

Code-first AI agents for .NET.

Runiq.Agents provides the core agent model for Runiq.Net. Use it to define agents in C#, attach strongly typed tools, configure model providers, and build agent-based applications with structured execution support.

Why Runiq.Agents?

Runiq.Agents is designed for .NET developers who want to build AI agents without leaving the C# ecosystem.

It focuses on:

• Code-first agent definitions
• Strongly typed tool execution
• Provider-aware model configuration
• Runtime-friendly agent composition
• Streaming and structured execution support
• Integration with the broader Runiq.Net platform

Install

dotnet add package Runiq.Agents --prerelease

Create an Agent

using Runiq.Agents;

var agent = new Agent(
    id: "weather-agent",
    name: "Weather Agent",
    instructions: "Answer weather questions using the available tools.",
    model: "openai/gpt-5",
    apiKey: configuration["OpenAI:ApiKey"]);

An agent contains the basic runtime definition:

• id: stable identifier used by the runtime
• name: human-readable agent name
• instructions: system-level behavior definition
• model: target model identifier
• apiKey: provider credential

Add a Tool

Tools allow agents to call strongly typed C# code.

using Runiq.Agents.Tools;

[RuniqTool("get_weather", "Gets the current weather for a city.")]
public sealed class WeatherTool : IRuniqTool<WeatherInput, WeatherOutput>
{
    public Task<WeatherOutput> ExecuteAsync(
        WeatherInput input,
        CancellationToken cancellationToken = default)
    {
        return Task.FromResult(
            new WeatherOutput(input.City, "Clear"));
    }
}

public sealed record WeatherInput(string City);

public sealed record WeatherOutput(string City, string Condition);

Attach the tool to the agent:

var agent = new Agent(
        id: "weather-agent",
        name: "Weather Agent",
        instructions: "Use tools when weather data is requested.",
        model: "openai/gpt-5",
        apiKey: configuration["OpenAI:ApiKey"])
    .AddTool<WeatherTool>();

Tool Design

A Runiq tool is a regular C# class that implements:

IRuniqTool<TInput, TOutput>

This gives you:

• Strongly typed input models
• Strongly typed output models
• Testable business logic
• Clean separation between agent behavior and application code

Typical Use Cases

Use Runiq.Agents when you want to build:

• AI assistants for .NET applications
• Tool-using agents
• Domain-specific agents
• Agent workflows
• Internal automation agents
• Dashboard-observable agent runtimes
• MCP-compatible agent experiences

Related Packages

Runiq.Net is modular. Runiq.Agents can be used together with other Runiq packages:

Documentation

Full documentation is available at:

https://runiq.net/docs

Status

Runiq.Net is currently in preview.

APIs may change before the first stable release.

The main direction is clear:

Build code-first AI agents, tools, workflows, context sources, MCP endpoints, and dashboards for .NET applications.

License

MIT