Galosys.Foundation.Agents.AI 26.7.26.2

Galosys.Foundation.Agents.AI

Microsoft Agent Framework (MAF) v1.13 薄包装模块。提供模块自动发现和 AddAIAgent() DI 便利扩展，所有编排/中间件能力直接委托给 MAF。

快速入门

安装

确保 Directory.Packages.props 中已配置 MAF 包版本：

<PackageVersion Include="Microsoft.Agents.AI" Version="1.13.0" />
<PackageVersion Include="Microsoft.Agents.AI.OpenAI" Version="1.13.0" />
<PackageVersion Include="Microsoft.Agents.AI.Anthropic" Version="1.13.0-preview.260703.1" />
<PackageVersion Include="Microsoft.Agents.AI.Workflows" Version="1.13.0" />

注册 Agent

using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
using OpenAI;

// 编程式创建 AIAgent
var client = new OpenAIClient(new ApiKeyCredential("sk-xxx"),
    new OpenAIClientOptions { Endpoint = new Uri("https://api.openai.com/v1") });

builder.Services.AddAIAgent(sp =>
    client.GetChatClient("gpt-4o")
        .AsAIAgent(name: "assistant", instructions: "You are a helpful assistant."));

使用 Agent

public class ChatService
{
    private readonly AIAgent _agent;

    public ChatService(AIAgent agent) => _agent = agent;

    public async Task<string> Chat(string message)
    {
        var session = await _agent.CreateSessionAsync();
        var response = await _agent.RunAsync(message, session, null);
        return response.Text;
    }
}

多 Agent 编排（使用 MAF Workflows）

using Microsoft.Agents.AI.Workflows;

// 顺序编排
var workflow = AgentWorkflowBuilder.BuildSequential(
    writerAgent, reviewerAgent);
var result = await workflow.RunAsync("Write a blog post", ct);

// 并发编排
var concurrent = AgentWorkflowBuilder.BuildConcurrent(
    new[] { agent1, agent2, agent3 });
var result = await concurrent.RunAsync("Research topic", ct);

// Handoff 模式
var handoffBuilder = AgentWorkflowBuilder
    .CreateHandoffBuilderWith(triageAgent)
    .HandoffTo(salesAgent, "sales")
    .HandoffTo(supportAgent, "support");
var workflow = handoffBuilder.Build();

Middleware（替代旧的 Step 模式）

// MAF DelegatingAIAgent 实现自定义中间件
public class LoggingAgent : DelegatingAIAgent
{
    private readonly ILogger _logger;

    public LoggingAgent(AIAgent inner, ILogger<LoggingAgent> logger)
        : base(inner) => _logger = logger;

    public override async Task<AgentResponse> RunAsync(
        string input, AgentSession? session, AgentRunOptions? options,
        CancellationToken ct = default)
    {
        _logger.LogInformation("Request: {Input}", input);
        var response = await base.RunAsync(input, session, options, ct);
        _logger.LogInformation("Response: {Text}", response?.Text);
        return response;
    }
}

工具调用

MAF AIAgent.RunAsync() 原生支持 Function Calling。通过 ChatOptions.Tools 传入工具定义即可。

依赖

Provider 支持