惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

V
Vulnerabilities – Threatpost
aimingoo的专栏
aimingoo的专栏
B
Blog
H
Hackread – Cybersecurity News, Data Breaches, AI and More
GbyAI
GbyAI
阮一峰的网络日志
阮一峰的网络日志
Engineering at Meta
Engineering at Meta
IT之家
IT之家
V
Visual Studio Blog
The Cloudflare Blog
酷 壳 – CoolShell
酷 壳 – CoolShell
A
About on SuperTechFans
博客园 - 聂微东
Blog — PlanetScale
Blog — PlanetScale
N
News and Events Feed by Topic
A
Arctic Wolf
WordPress大学
WordPress大学
小众软件
小众软件
C
CERT Recently Published Vulnerability Notes
Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
D
Darknet – Hacking Tools, Hacker News & Cyber Security
F
Fortinet All Blogs
CTFtime.org: upcoming CTF events
CTFtime.org: upcoming CTF events
Y
Y Combinator Blog
T
Threat Research - Cisco Blogs
Latest news
Latest news
Simon Willison's Weblog
Simon Willison's Weblog
Cyberwarzone
Cyberwarzone
S
Schneier on Security
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
L
Lohrmann on Cybersecurity
Stack Overflow Blog
Stack Overflow Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
P
Privacy International News Feed
J
Java Code Geeks
Spread Privacy
Spread Privacy
宝玉的分享
宝玉的分享
I
Intezer
L
LangChain Blog
Hacker News - Newest:
Hacker News - Newest: "LLM"
G
GRAHAM CLULEY
博客园 - 叶小钗
博客园 - 三生石上(FineUI控件)
The GitHub Blog
The GitHub Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
N
News and Events Feed by Topic
AWS News Blog
AWS News Blog
Attack and Defense Labs
Attack and Defense Labs
Security Archives - TechRepublic
Security Archives - TechRepublic
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO

博客园_首页

Plist 二进制格式 Milvus 和 PGVector,哪个更好? OpenClaw 已过时?在 VS Code 中运行 Hermes Agent! 第30篇文章:一个大三计科生的自白 Manim如何在数学公式中完美显示中文? Docker 部署 RocketMQ 5 并发编程核心概念辨析 C#事务处理最佳实践:别再让“主表存了、明细丢了”的破事发生 CLI 是什么?为什么大厂突然集体卷命令行? 【从0到1构建一个ClaudeAgent】协作-自主Agent UIImageView 设置图片不生效的原因排查 最小二乘问题详解20:无先验约束下的增量式SFM自由网平差 痞子衡嵌入式:大话双核i.MXRT1180之XIP应用里借助MU实现可靠Flash IAP的方法 AI Chat 封装, SemanticKerne.AiProvider.Unified 已发布 Windows下右键编辑js文件无法打开记事本——在注册表中使用环境变量 在后台服务中使用 Scoped 服务,为什么总是报错? H200 安装驱动并使用sglang启动模型 wireshark 抓包Trap上报告警内容 我用 AI 辅助开发了一系列小工具(2):图片压缩工具 [A Primer On MC and CC] 2.1 Memory Consistency 1 - 指令重排序和 SC 模型 Oracle数据库SCN推进技术详解与实践指南 玩转控件:封装个带图片的Label控件 Claude Code 4.7 真正该升级的不是模型,而是你的工作流 前端小白一句话,AI 帮我做了个颜值拉满的桌面媒体播放器。当代码不再是门槛,一句话编程就是现实。 5. WorkBuddy: 小龙虾的灵魂三件套,让你的小龙虾不只是工具 SQLite 分片方案实战:三种分片策略的深度对比 告别简陋 UI!一款基于 Fluent Design 和基于 WinUI 的开源免费、现代化的 Avalonia UI 控件库 关于二进制排列组合枚举的总结 AI开发-python-LangGraph框架(3-27-LangGraph从零实现大模型智能决策工作流) ElasticSearch主分片和副本分片概念详解 【002】HTTPS 粗解:证书、TLS 握手与对后端配置的影响 Hermes Agent 一周暴涨五万 Star,但我劝你别急着追 明明连接的是Redis的DB0,为什么能查到DB3的数据? 【从0到1构建一个ClaudeAgent】协作-Agent团队 熟悉电子元器件之后,电子小白下一步该怎么走? MAF快速入门(23)通过C#类定义Skills .NET 高级开发 | 手写一个对象映射框架 FastAPI数据库ORM怎么选?我肝了三个Demo后,终于不再纠结了 mysqldump 参数拾遗:在遗忘与铭记之间 C# .NET 周刊|2026年3月5期 Claude code入门 - 陈彦斌 一文学习入门 ThingsBoard 开源物联网平台 GitHub 热门项目 | 2026年04月16日 如何为GIT设置全局勾子,为每次提交追加信息 Number.isFinite和isFinite与isNaN()和Number.isNaN的区别 PortSwigger SQL注入LAB2 推荐一个测试人必备的Skills,从功能到性能全搞定(附详细实操和安装下载方式) 筑基期:掌握Odoo基础核心知识点02(Odoo XML 开发方式详解) GLM模型这么火,咱们用vllm也咧一个呗! 深入理解 AbortController:从底层原理到跨语言设计哲学 字符串学习笔记 多租户系统框架的基础模块设计和分析设计 Apache SeaTunnel Zeta 为什么能做到“又快又稳”? AI开发-python-LangGraph框架(3-26-LangGraph基本概念及第一个简单样例) Vue 3 组件通信,别只会用 Props 和 Emits 了,这几个狠活儿你得看看 ElasticSearch7.X版本配置密码 用Manim实现动态交点计算--从一个动点问题说起 团结引擎+Addressable+Instant Game打包抖音小游戏 function call 实战:让 LLM 自动判断 pod 异常、调用日志工具并完成故障分析 bubseek —— 让 Agent 的足迹,变成团队的洞察 通过 C# 读取并导出 PDF 书签 如何用 GitHub Actions 实现 Steam 自动化发布 【从0到1构建一个ClaudeAgent】并发-后台任务 .NET 高级开发 | 定制 ASP.NET Core 框架 电子小白:什么是运算放大器(运放) zero2Agent:面向大厂面试的 Agent 工程教程,从概念到生产的完整学习路线 堆上的ORW HC32F460 USB CDC通信异常:非对齐访问异常排查 20260413-Hyperbridge 攻击事件:发生在默克尔山上的验证绕过 那些喊着AI 要淘汰你的人,正在靠你的焦虑赚大钱! 深度学习进阶(八)Swin Transformer 最小二乘问题详解19:带先验约束的增量式SFM优化与实现 SnapTranslate 3.0 正式发布:全局划词翻译 + 完整英语学习闭环,一站式搞定查词、记词、复习 工作的意义、工作的困难认知再思考 .NET + AI 进阶实战:基于类的技能开发 - 打造可治理的 Agent 能力模块 【从0到1构建一个ClaudeAgent】规划与协调-技能 上周热点回顾(4.6-4.12) 电子小白的工具三件套:面包板、杜邦线、万能板 单表五亿数据的查询优化 | Mysql、StarRocks 2. WorkBuddy:从“我是谁”到“帮我干活” C# 如何减少代码运行时间:7 个实战技巧 基于HelixToolkit.SharpDX 渲染3D模型 - 笺上知微 从零开始的双臂具身VLA起源及现阶段发展综述 - SkyXZ 记对 xonsh shell 的使用, 脚本编写, 迁移及调优 - pluvium27 受够了Vibe Coding的失控?换个起点,让AI事半功倍 从开始配置漏洞环境到漏洞复现流程 - 難しい 关于10年工作经验的程序员对OpenClaw的实战经验分享以及看法 - 虚无境 Any metadata 的内存布局 C# .NET 周刊|2026年3月2期 - InCerry 我帮你测过了,测试圈排名第二的 Skill 依然很牛逼 Skill Discovery | 无监督技能发现的经典工作总结 - MoonOut 上下文工程是什么?过时了么?一文讲明白! - 一枫说码 开了 TUN 模式还是直连?90% 的人都踩过这个坑 AScript扩展多种脚本语言 - rockey627 AI 学习笔记:Agent 的记忆机制 你能被装进一个文件里吗?——7 万人把同事"蒸馏"成了 AI - 我没有三颗心脏 Claude Code 通关手册(七):给 AI 装上技能包——Skills 完全指南 - 暮色之狐 在浏览器中快速编辑代码:VSCode Web 集成实践 - Newbe36524 蒸馏自己 skill?基于 Deepseek 的蒸馏器,丐版蒸馏方式,简单便捷 - To_Carpe_Diem Spring AI Aliababa和AgentScope,哪个更好? - 苏三说技术
MAF快速入门(24)整合多个Skill来源
EdisonZhou · 2026-04-20 · via 博客园_首页

大家好,我是Edison。

最近我一直在跟着圣杰的《.NET+AI智能体开发进阶》课程学习MAF开发智能体应用,我强烈推荐你也上车跟我一起出发!

MAF 1.1.0 对 Agent Skill 的补全绝对是工程化的典范,今天我们来看看如何整合多个Skill来源实现企业级多技能控制。

1 企业级需求:多个Skill来源管控

在写Agent Skill的时候,我就在想企业级应用中应该需要一个Skill管控,维护一些中央可复用Skill推送到各个员工的Agent中,而各个员工也会自己写一些自己任务的Skill 或者 重写远程Skill来覆盖实现自己的任务

这种多级Skill来源的控制设计已经在MAF中被考虑进来了,我们可以通过自定义AgentSkillsSource来实现,这意味着我们可以从任何地方为Agent提供Skill,包括但不限于:HTTP API、数据库、配置中心等等。

2 快速开始:整合多个来源Skill

这里我们来做一个企业HR助手,整合以下多个来源的Skill并实现角色管控Skill可见。

  1. 全局技能库(假设通过Remote HTTP API来获取):它是所有员工通用的政策和流程;

  2. 本地技能库(假设通过InMemory来获取):它是各个员工自己定制的任务技能

  3. 用户角色技能(假设通过自定义Source来获取):根据当前用户角色做动态过滤

在这个案例中,我们想要实现只有 全局通用技能 + 角色专属技能 对Agent可见,且本地的同名称技能可以覆盖远程的全局技能。

本文案例使用的模型为:Qwen3.5-35B-A3B

准备工作

在开始之前,我们创建了一个控制台应用,并安装了以下NuGet包:

<PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.1.0" />

假设我们的企业员工角色定义有三种:员工、经理 和 HR管理员

public enum EmployeeRole
{
    Employee,
    Manager,
    HRAdmin
}

为了方便实现Skill的角色过滤,我们实现一个方法来判断:

public static class UserRoleHelper
{
    public static bool IsSkillVisibleTo(AgentSkill skill, EmployeeRole role)
    {
        var name = skill.Frontmatter.Name;
        // 管理技能仅经理和HR可见
        if (name.StartsWith("manager-") && role == EmployeeRole.Employee) 
            return false;
        // HR管理技能仅HR可见
        if (name.StartsWith("hr-admin-") && role != EmployeeRole.HRAdmin) 
            return false;
        return true;
    }
}

可以看到,我们这里针对管理技能仅能经理和HR可见,而HR相关技能则仅能HR可见。

实现远程SkillSource

这里我们定义一个企业的远程SkillSource,模拟从远程API拉取统一定义的技能。

在实际项目中,通常会使用HttpClient来访问一个注册中心来实现。

public sealed class SimulatedRemoteApiSkillsSource : AgentSkillsSource
{
    private readonly string _apiEndpoint;
    public SimulatedRemoteApiSkillsSource(string apiEndpoint)
    {
        _apiEndpoint = apiEndpoint;
    }
    public override async Task<IList<AgentSkill>> GetSkillsAsync(CancellationToken cancellationToken = default)
    {
        Console.WriteLine($"📡 [RemoteApiSource] 从 {_apiEndpoint} 拉取技能列表...");
        await Task.Delay(500, cancellationToken); // 模拟网络延迟
        var entries = GetMockGlobalSkills();
        var skills = new List<AgentSkill>();
        foreach (var entry in entries)
        {
            try
            {
                var skill = new AgentInlineSkill(entry.Name, entry.Description, entry.Instructions);
                skills.Add(skill);
            }
            catch (ArgumentException ex)
            {
                Console.WriteLine($"⚠️ [RemoteApiSource] 跳过非法技能 '{entry.Name}': {ex.Message[..Math.Min(60, ex.Message.Length)]}");
            }
        }
        Console.WriteLine($"✅ [RemoteApiSource] 已成功加载 {skills.Count} 个远程技能");
        return skills;
    }
    private static IList<SkillApiEntry> GetMockGlobalSkills()
    {
        return new List<SkillApiEntry>
        {
            new("expense-report",  "(全局v1)企业费用报销政策",    "全局版报销规则:..."),
            new("hr-onboarding",   "(全局)新员工入职流程",         "入职材料清单:..."),
            new("leave-policy",    "(全局)请假制度和申请流程",      "年假/病假/事假规则:..."),
            new("manager-review",  "(全局)绩效评估指南",           "季度评估流程:..."),
            new("hr-admin-audit",  "(全局)HR 审计和合规",          "合规审查清单:..."),
        };
    }
}

这里SkillApiEntry模型的定义如下:

public sealed record SkillApiEntry(
  string Name, 
  string Description, 
  string Instructions, 
  string[]? Tags = null);

实现远程Skills的缓存化

远程Skills具有时效性,需要定期更新来同步,因此弄一个带TTL(Time-To-Live)缓存的装饰器,它可以强制Agent客户端定期刷新远程Skills来保持同步。

public sealed class CachingSkillsSource : AgentSkillsSource
{
    private readonly AgentSkillsSource _innerSource;
    private readonly TimeSpan _ttl;
    private IList<AgentSkill>? _cache;
    private DateTime _cacheExpiresAt = DateTime.MinValue;
    private readonly SemaphoreSlim _lock = new(1, 1);
    
    public CachingSkillsSource(AgentSkillsSource innerSource, TimeSpan ttl)
    {
        _innerSource = innerSource;
        _ttl = ttl;
    }
    
    public override async Task<IList<AgentSkill>> GetSkillsAsync(CancellationToken cancellationToken = default)
    {
        if (_cache != null && DateTime.UtcNow < _cacheExpiresAt)
        {
            Console.WriteLine($"⚡ [CachingSource] 命中缓存(过期时间: {_cacheExpiresAt.ToLocalTime():HH:mm:ss})");
            return _cache;
        }
        await _lock.WaitAsync(cancellationToken);
        try
        {
            // 双重检查锁(避免并发刷新)
            if (_cache != null && DateTime.UtcNow < _cacheExpiresAt)
                return _cache;
            Console.WriteLine("🔄 [CachingSource] 缓存未命中,从内层 Source 刷新...");
            _cache = await _innerSource.GetSkillsAsync(cancellationToken);
            _cacheExpiresAt = DateTime.UtcNow.Add(_ttl);
            Console.WriteLine($"✅ [CachingSource] 缓存已更新,{_cache.Count} 个技能,有效至 {_cacheExpiresAt.ToLocalTime():HH:mm:ss}");
            return _cache;
        }
        finally
        {
            _lock.Release();
        }
    }
    
    public void InvalidateCache() { _cache = null; _cacheExpiresAt = DateTime.MinValue; }
    public bool IsCacheValid => _cache != null && DateTime.UtcNow < _cacheExpiresAt;
}

实现本地Skills

这里我们定义一些本地Skills,通过Inline Skill的方式增加一个本地任务技能 和 覆盖一个同名的远程仅能。

public class SimulatedLocalApiSkillsFactory
{
    public static async Task<IList<AgentInlineSkill>> GetSkillsAsync(CancellationToken cancellationToken = default)
    {
        Console.WriteLine("🏠 [LocalApiFactory] 正在从本地获取技能列表...");

        var localSkills = new List<AgentInlineSkill>
        {
            // 覆盖全局 expense-report,使用 Contoso 定制规则
            new AgentInlineSkill("expense-report", "(Contoso定制v2)企业费用报销政策",
                """
                # Contoso 定制报销规则(2025版)
                - 差旅费上限提升至 8000 元/- 新增"远程协作设备补贴"类目,≤3000元免审批
                - 年末报销截止日期:12月25日
                """),
            // 新增:Contoso 特有的技能
            new AgentInlineSkill("contoso-benefits", "Contoso 员工福利计划详情", "福利:弹性办公、年度体检、学习补贴..."),
        };
        Console.WriteLine($"✅ [LocalApiFactory] 已成功加载 {localSkills.Count} 个本地技能");
        return localSkills;
    }
}

Agent客户端加载Skills

这里我们在Agent客户端加载本地 和 远程技能,同时对远程技能做1小时的缓存代理。

// ── Source 1:本地定制技能(覆盖全局版,注册顺序靠前 → 优先)──
var localCustomSkills = await SimulatedLocalApiSkillsFactory.GetSkillsAsync();
// ── Source 2:模拟全局技能库(Remote API,通用政策)──
var globalSource = new SimulatedRemoteApiSkillsSource("https://global-skills.contoso.com/api");
// ── Source 3:带缓存的远程 Source(生产环境推荐)──
var cachedGlobalSource = new CachingSkillsSource(globalSource, TimeSpan.FromMinutes(60));

构建针对角色的SkillsProvider工厂

这里我们用MAF提供的Builder模式来实现一个面向指定角色的SkillsProvider工厂方法:

AgentSkillsProvider BuildProviderForRole(EmployeeRole role)
{
    Console.WriteLine($"\n🔨 开始构建 {role} 角色的 Provider...");
    return new AgentSkillsProviderBuilder()
        // 本地定制优先(先注册 → first-wins)
        .UseSkills(localCustomSkills)
        // 全局技能库(带缓存)
        .UseSource(cachedGlobalSource)
        // 角色感知过滤
        .UseFilter(s => UserRoleHelper.IsSkillVisibleTo(s, role))
        // 自定义 Prompt:企业内部语气
        .UsePromptTemplate("""
            你是 Contoso 集团的企业服务助手。
            ## 你掌握的企业知识库
            {skills}
            ## 工作原则
            遇到政策性问题,**先加载该技能的详细指引**,再作答。请确保所有建议符合 Contoso 最新官方规定。
            {resource_instructions}
            {script_instructions}
            """)
        .Build();
}

测试验证各个角色的技能可见范围

这里通过下面的测试代码来创建三个角色使用的SkllsProvider,通过获取其Skills可见范围来进行验证:

// 验证三个角色看到的技能集合
foreach (var role in Enum.GetValues<EmployeeRole>())
{
    var provider = BuildProviderForRole(role);
    var srcField = typeof(AgentSkillsProvider).GetField("_source", BindingFlags.Instance | BindingFlags.NonPublic);
    var src = (AgentSkillsSource?)srcField?.GetValue(provider);
    var skills = src is null ? 
        new List<AgentSkill>() : (await src.GetSkillsAsync()).ToList();
    Console.WriteLine("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    Console.WriteLine($"👤 [{role}] 可见技能({skills.Count} 个):");
    foreach (var s in skills)
    {
        string origin = s.Frontmatter.Description.StartsWith("(Contoso") ? "(本地定制)" :
                        s.Frontmatter.Description.StartsWith("(全局") ? "(全局库)" : "(其他)";
        Console.WriteLine($"    • {s.Frontmatter.Name} {origin}");
    }
}

测试结果如下图所示:

image

3 小结

本文介绍了MAF如何整合多个Agent Skill Source实现企业级Skill管控 和 角色Skill可见性控制,这在企业级应用中是非常实用的特性和实践。不过,目前MAF的Agent Skills仍然属于实验性支持阶段,生产落地还需谨慎。

不过,目前MAF的Agent Skills仍然属于实验性支持阶段,生产落地还需谨慎。

示例源码

GitHub: https://github.com/EdisonTalk/MAFD

参考资料

圣杰,《.NET + AI 智能体开发进阶》(推荐指数:★★★★★)

Microsoft Learn,Agent Framework Tutorials