Hazina Agent Orchestration: Building Autonomous AI Systems

A single AI call answers a question. An agent orchestration system solves problems. Hazina’s orchestration layer lets you build AI agents that can use tools, maintain state, and work autonomously toward goals.

What Is Agent Orchestration?

An agent is an AI model connected to tools (functions it can call). The orchestration layer manages:

• Tool execution – The AI decides which tools to call and in what order
• State management – Conversation history and intermediate results
• Error handling – Retries, fallbacks, and graceful degradation
• Security – Controlling what the agent can and cannot do

Creating an Agent

var agent = new HazinaAgent()
    .WithSystemPrompt("You are a customer support agent for an e-commerce store.")
    .WithTool(new SearchOrdersTool())
    .WithTool(new GetProductInfoTool())
    .WithTool(new CreateRefundTool())
    .WithMaxIterations(10);

var response = await agent.RunAsync("I want to return my order #12345");

Defining Tools

public class SearchOrdersTool : IAgentTool
{
    public string Name => "search_orders";
    public string Description => "Search for customer orders by order ID or email";

    public ToolParameters Parameters => new() {
        { "query", ToolParameterType.String, "Order ID or email address" }
    };

    public async Task<string> ExecuteAsync(ToolContext context)
    {
        var query = context.GetParameter<string>("query");
        var orders = await _orderService.SearchAsync(query);
        return JsonSerializer.Serialize(orders);
    }
}

The Orchestration Loop

When you call agent.RunAsync(), Hazina:

1. Sends the user message to the LLM with available tools
2. If the LLM wants to call a tool, Hazina executes it
3. Tool results are sent back to the LLM
4. Repeat until the LLM provides a final answer
5. Return the response to the user

Terminal Access (ConPTY)

Hazina can even give agents access to a terminal for system operations:

var agent = new HazinaAgent()
    .WithSystemPrompt("You are a DevOps agent.")
    .WithTerminalAccess(new TerminalOptions {
        AllowedCommands = new[] { "git", "dotnet", "npm" },
        WorkingDirectory = "/app",
        MaxSessionDuration = TimeSpan.FromMinutes(5)
    });

This powers the Hazina Orchestration demo – a web-based terminal where AI can execute real commands.

In the next post, we’ll explore Social Content Providers – connecting to WordPress, LinkedIn, and more.

Frequently Asked Questions

← Terug naar overzicht