## 本文教大家使用AgentFramework集成Agent Skill智能体技能

## 1.基础知识

**代理技能** 是指令、脚本和资源的可移植包，可提供代理的专用功能和域专业知识。 技能遵循开放规范并实现渐进式披露模式，以便代理在需要时仅加载所需的上下文。

在需要时使用代理技能：

封装领域专业知识 - 将专业知识（费用策略、法律工作流、数据分析管道）捕获为可重用且可移植的包。
扩展代理功能 - 为代理提供新功能，而无需更改其核心指令。
确保一致性 - 将多步骤任务转换为可重复的可审核工作流。
启用互作性 - 在不同的代理技能兼容产品中重复使用相同的技能。
技能结构
技能是一个目录，包含一个 SKILL.md 文件，并且可以选择包括用于存放资源的子目录：

```csharp
expense-report/
├── SKILL.md                          # Required — frontmatter + instructions
├── scripts/
│   └── validate.py                   # Executable code agents can run
├── references/
│   └── POLICY_FAQ.md                 # Reference documents loaded on demand
└── assets/
    └── expense-report-template.md    # Templates and static resources
```
SKILL.md 格式
该文件 SKILL.md 必须包含 YAML 前置数据，后跟 Markdown 内容： 

```csharp
name: expense-report
description: File and validate employee expense reports according to company policy. Use when asked about expense submissions, reimbursement rules, or spending limits.
license: Apache-2.0
compatibility: Requires python3
metadata:
  author: contoso-finance
  version: "2.1"
---

```

[## Shell SKILL 文件夹](https://github.com/junkai-li/NetCoreKevin/tree/master/Kevin/kevin.Module/kevin.AI.AgentFramework/Skills)
[https://github.com/junkai-li/NetCoreKevin/tree/master/Kevin/kevin.Module/kevin.AI.AgentFramework/Skills](https://github.com/junkai-li/NetCoreKevin/tree/master/Kevin/kevin.Module/kevin.AI.AgentFramework/Skills)



**基本设置**
创建一个指向包含您技能的目录的FileAgentSkillsProvider，并将其添加到代理的上下文提供者中。
源代码地址：[https://github.com/junkai-li/NetCoreKevin/blob/master/Kevin/kevin.Module/kevin.AI.AgentFramework/AIAgentService.cs](https://github.com/junkai-li/NetCoreKevin/blob/master/Kevin/kevin.Module/kevin.AI.AgentFramework/AIAgentService.cs)

```csharp
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;

// Discover skills from the 'skills' directory
        var skillsProvider = new FileAgentSkillsProvider(
            skillPaths: [Path.Combine(AppContext.BaseDirectory + "/Skills", "expense-report-skills"), 
                Path.Combine(AppContext.BaseDirectory + "/Skills", "system-ops-skills")],
            options: new FileAgentSkillsProviderOptions
            {
                SkillsInstructionPrompt = """
                                        你可以使用以下技能获取领域知识和操作指引。
                                        每个技能提供专业指令、参考文档和可执行脚本
                                        它们如下:
                                        {0}

                                        使用 `expense-report` 这个技能用于 按照NetCoreKevin科技公司政策填写和审核员工费用报销。适用于费用报销、报销规则、收据要求、支出限额或费用类别等相关问题。 

                                        使用 `system-ops` 这个技能 工作流程：
                                        1. 当用户任务匹配技能描述时，使用 `load_skill` 加载该技能的完整指令
                                        2. 技能指令中会标明可用脚本及其执行命令
                                        3. 使用 `run_shell` 工具执行技能中标注的命令
                                        4. 需要时使用 `read_skill_resource` 读取参考资料。
                                        重要原则：先加载知识，再执行操作。

                                        """
            });

// Create an agent with the skills provider
AIAgent agent = new AzureOpenAIClient(
    new Uri(endpoint), new DefaultAzureCredential())
    .GetResponsesClient(deploymentName)
    .AsAIAgent(new ChatClientAgentOptions
    {
        Name = "SkillsAgent",
        ChatOptions = new()
        {
            Instructions = "You are a helpful assistant.",
              // 🔑 能力层：工具
                        Tools = new List<AITool>() {
                    AIFunctionFactory.Create(KevinBasicAI.GetNetCoreKevinInfo,new AIFunctionFactoryOptions{ Name = "GetNetCoreKevinInfo",Description = "获取NetCoreKevin框架的介绍信息" }),
                    AIFunctionFactory.Create(ShellTools.RunShell,new AIFunctionFactoryOptions{ Name = "RunShell",Description = "执行 Shell 命令。通过操作系统原生 Shell 执行命令（Windows 用 cmd，Linux/Mac 用 bash）。包含安全护栏：危险命令阻止、输出截断（50KB）、超时控制（60秒）。" })
                    };
        },
                      
              
        AIContextProviders = [skillsProvider],
    });
```
**自定义系统提示**
默认情况下，技能提供程序会注入系统提示，其中列出了可用的技能，并指示代理使用 load_skill 和 read_skill_resource。 可以自定义此提示：

```csharp
var skillsProvider = new FileAgentSkillsProvider(
    skillPath: Path.Combine(AppContext.BaseDirectory, "skills"),
    options: new FileAgentSkillsProviderOptions
    {
        SkillsInstructionPrompt = """
            You have skills available. Here they are:
            {0}
            Use the `load_skill` function to get skill instructions.
            Use the `read_skill_resource` function to read skill files.
            """
    });
```

## Tools工具
ShellTools.cs

```csharp
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Diagnostics;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace kevin.AI.AgentFramework.Tools
{
    public class ShellTools
    {
        // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
        // run_shell — 一个 Shell 工具做一切（含安全护栏）
        // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

        // 🛡️ 安全护栏 1：危险命令黑名单
        private static string[] dangerousPatterns = [
            "rm -rf /", "rm -rf /*",       // 删除根目录
        "sudo ",                        // 提权
        "shutdown", "reboot",           // 系统操作
        "> /dev/",                      // 设备写入
        ":(){ :|:& };:",                // Fork bomb
        "mkfs.",                        // 格式化
        "dd if=",                       // 磁盘覆写
        "format ",                      // Windows 格式化
        "del /f /s /q",                 // Windows 递归删除
    ];

        [Description("执行 Shell 命令。通过操作系统原生 Shell 执行命令（Windows 用 cmd，Linux/Mac 用 bash）。包含安全护栏：危险命令阻止、输出截断（50KB）、超时控制（60秒）。")]
        public static string RunShell(
            [Description("要执行的 Shell 命令。例如：'pwsh -File /path/to/script.ps1' 或 'dir'")] string command,
            [Description("命令执行的工作目录（可选）。如果不指定，使用当前目录。")] string? workingDirectory = null)
        {
            try
            {
                // 🛡️ 安全护栏 1：危险命令检查
                if (dangerousPatterns.Any(d => command.Contains(d, StringComparison.OrdinalIgnoreCase)))
                {
                    return "❌ 安全拦截：检测到危险命令，已阻止执行。";
                }

                Console.WriteLine($"🔧 正在执行 Shell 命令：{command}");

                // 🔑 跨平台 Shell 适配：
                //   Windows → cmd /c "command"   （原生命令提示符）
                //   Linux/Mac → bash -c "command" （原生 Bash）
                //
                // 为什么不直接用 pwsh？
                //   SKILL.md 中的命令已经是 "pwsh -File ..."
                //   如果 RunShell 也用 pwsh -Command 包裹 → pwsh 套 pwsh（冗余嵌套）
                //   用原生 shell 分发 → pwsh -File 直接执行，零嵌套 
                var isWindows = OperatingSystem.IsWindows();
                var processInfo = new ProcessStartInfo
                {
                    FileName = isWindows ? "cmd" : "bash",
                    Arguments = isWindows ? $"/c {command}" : $"-c \"{command.Replace("\"", "\\\"")}\"",
                    RedirectStandardOutput = true,
                    RedirectStandardError = true,
                    UseShellExecute = false,
                    CreateNoWindow = true
                };

                // 设置工作目录
                if (!string.IsNullOrWhiteSpace(workingDirectory) && Directory.Exists(workingDirectory))
                {
                    processInfo.WorkingDirectory = workingDirectory;
                }

                using var process = Process.Start(processInfo);
                if (process == null)
                {
                    return "❌ 无法启动 Shell 进程";
                }

                var stdout = process.StandardOutput.ReadToEnd();
                var stderr = process.StandardError.ReadToEnd();

                // 🛡️ 安全护栏 3：超时控制（60秒）
                if (!process.WaitForExit(60_000))
                {
                    process.Kill(entireProcessTree: true);
                    return "❌ 命令执行超时（60秒），已强制终止。";
                }

                var result = new StringBuilder();
                if (!string.IsNullOrWhiteSpace(stdout))
                {
                    result.AppendLine(stdout.Trim());
                }
                if (!string.IsNullOrWhiteSpace(stderr))
                {
                    result.AppendLine($"⚠️ stderr: {stderr.Trim()}");
                }
                if (process.ExitCode != 0)
                {
                    result.AppendLine($"⚠️ 退出码: {process.ExitCode}");
                }

                var output = result.Length > 0 ? result.ToString() : "(命令执行成功，无输出)";

                // 🛡️ 安全护栏 2：输出截断（50KB）
                const int maxOutputLength = 50_000;
                if (output.Length > maxOutputLength)
                {
                    output = output[..maxOutputLength] + "\n... (输出已截断，超过 50KB 上限)";
                }

                return output;
            }
            catch (Exception ex)
            {
                return $"❌ 执行失败: {ex.Message}";
            }
        }
    }
}

```

## 效果图
AI使用Shell命名进行相关电脑本机操作
![0771883eab1c3ef226633caaca1f9312.png](https://developer.qcloudimg.com/http-save/yehe-2532455/d8bf005e2639ac49e3666f26beb77de4.png) 
![e1a266b4a079f3d5fea3f8a83bb11318.png](https://developer.qcloudimg.com/http-save/yehe-2532455/6b5cace02eceba2cd6fa747a7f26d6e8.png) 
## 参考源代码： NetCoreKevin框架下的kevin.AI.AgentFramework模块
基于.NET构建的企业级SaaSAI智能体应用架构，采用前后端分离设计，具备以下核心特性： 
- AI智能体框架RAG检索增强
- AI知识库 
- AI智能体技能集成
- -RabbitMQ消息队列 
- 一库多租户解决方案
- 多级缓存机制
- CAP事件集成
- SignalR实时通信
- 领域驱动设计  
- 等等......
- 项目地址：github：[https://github.com/junkai-li/NetCoreKevin](https://github.com/junkai-li/NetCoreKevin) 
Gitee: [https://gitee.com/netkevin-li/NetCoreKevin](https://gitee.com/netkevin-li/NetCoreKevin)
## 参考文献：
https://learn.microsoft.com/zh-cn/agent-framework/agents/skills?pivots=programming-language-csharp

代理技能 是指令、脚本和资源的可移植包，可提供代理的专用功能和域专业知识。 技能遵循开放规范并实现渐进式披露模式，以便代理在需要时仅加载所需的上下文。

.Net基于AgentFramework中智能体Agent Skill集成Shell命令实现小龙虾mini版

本文介绍了如何使用AgentFramework集成智能体技能(Agent Skill)。Agent Skill是可移植的功能包，包含指令、脚本和资源，用于扩展代理的专业能力。文章详细说明了技能的结构，包括必须的SKILL.md文件和可选资源目录。通过创建FileAgentSkillsProvider并添加到代理上下文，可实现技能集成。同时提供了自定义系统提示的方法，以及执行Shell命令的工具类

人工智能

后端

编程语言

AgentFramework集成AgentSkill技能教程：学习如何封装领域专业知识、扩展代理功能，通过SKILL.md文件配置技能结构，使用FileAgentSkillsProvider加载技能目录。提供ShellTools工具执行安全命令，支持跨平台操作，包含危险命令拦截、输出截断等安全机制。适用于费用报销、系统运维等场景，基于.NET构建企业级AI智能体应用架构。

消息队列

智能体

Windows

Linux

2026新春采购季

message-queue-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AgentFramework集成AgentSkill技能教程：学习如何封装领域专业知识、扩展代理功能，通过SKILL.md文件配置技能结构，使用FileAgentSkillsProvider加载技能目录。提供ShellTools工具执行安全命令，支持跨平台操作，包含危险命令拦截、输出截断等安全机制。适用于费用报销、系统...

.Net基于AgentFramework中智能体Agent Skill集成Shell命令实现小龙虾mini版-腾讯云开发者社区-腾讯云

.Net基于AgentFramework中智能体Agent Skill集成Shell命令实现小龙虾mini版

.Net基于AgentFramework中智能体Agent Skill集成Shell命令实现小龙虾mini版

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐