当前位置：首页 > news >正文

【Semantic Kernel核心组件】Plugin：连接AI与业务逻辑的桥梁

news 来源：原创 2025/8/20 8:33:50

一、Plugin是什么？为什么它是SK的核心？

一、Plugin的核心机制与Python实现

1. 插件类型：语义函数与本地函数

语义函数（Semantic Function）

本地函数（Native Function）

2. Plugin的注册与调用

二、高级应用：自动化编排（Planner）

智能任务分解示例

三、关键特性详解

1. 参数自动映射机制

2. 安全约束实践

四、调试技巧

1. 查看已注册插件

2. 参数验证日志

五、Python vs C#实现差异

附录代码

mathplugin.py

native_function.py

一、Plugin是什么？为什么它是SK的核心？

在Semantic Kernel（SK）框架中，Plugin（插件） 是连接大语言模型（LLM）与确定性代码的核心组件。它通过将自然语言语义与程序函数绑定，实现了从“不确定的AI推理”到“确定性的业务逻辑”的转化。例如，用户可以通过自然语言指令“购买3斤苹果”，触发SK调用后台的库存扣减和支付接口。

Plugin的设计哲学：

确定性增强：LLM生成的文本具有不确定性（如“购买水果”可能对应多种操作），而Plugin通过预定义的函数和参数约束，将模糊指令转化为精准动作。
模块化复用：每个Plugin可独立开发、测试和部署，支持跨项目复用。例如电商、客服、数据分析等场景可共享通用插件。

一、Plugin的核心机制与Python实现

1. 插件类型：语义函数与本地函数

语义函数（Semantic Function）

通过自然语言模板定义意图识别逻辑（需安装 semantic-kernel 包）：

from semantic_kernel.skill_definition import sk_functionclass IntentPlugin:@sk_function(description="根据用户输入判断是否为购买请求",name="classify_intent")def classify_intent(self, input: str) -> str:# 调用LLM进行意图分类return "购买请求" if "买" in input else "其他请求"

本地函数（Native Function）

直接操作业务系统（示例含库存管理）：

class InventoryPlugin:def __init__(self):self.stock = {"苹果": 100, "香蕉": 50}  # 模拟库存@sk_function(description="从库存中扣除商品数量",name="deduct_stock",input_description="商品名称和数量, 例如 item='苹果', quantity=2")def deduct_stock(self, item: str, quantity: int) -> str:if item not in self.stock:raise ValueError(f"商品{item}不存在")self.stock[item] -= quantityreturn f"库存更新：{item}剩余{self.stock[item]}件"

2. Plugin的注册与调用

import semantic_kernel as sk
from semantic_kernel.planning import ActionPlanner# 初始化Kernel
kernel = sk.Kernel()
kernel.import_skill(IntentPlugin(), "IntentPlugin")
kernel.import_skill(InventoryPlugin(), "InventoryPlugin")# 自然语言触发插件
async def process_order():context = kernel.create_new_context()context["input"] = "我要买3斤苹果"# 步骤1：意图识别intent = await kernel.run_async(kernel.skills["IntentPlugin"]["classify_intent"],input_context=context)print(intent.result)  # 输出：购买请求# 步骤2：执行库存操作if "购买" in intent.result:result = await kernel.run_async(kernel.skills["InventoryPlugin"]["deduct_stock"],input_context=sk.ContextVariables({"item": "苹果", "quantity": "3"}))print(result.result)  # 输出：库存更新：苹果剩余97件# 运行示例
import asyncio
asyncio.run(process_order())

二、高级应用：自动化编排（Planner）

智能任务分解示例

# 定义天气预报插件
class WeatherPlugin:@sk_function(description="获取城市天气",name="get_weather")def get_weather(self, city: str) -> str:# 模拟API调用return f"{city}天气：25℃ 晴"# 注册插件并创建Planner
kernel.import_skill(WeatherPlugin(), "WeatherPlugin")
planner = ActionPlanner(kernel)# 自动生成执行计划
async def plan_demo():goal = "查询北京天气并告诉我库存里还有多少苹果"plan = await planner.create_plan_async(goal)print("生成计划步骤：")for step in plan._steps:print(f"- {step.description}")# 执行计划result = await plan.invoke_async()print("\n执行结果：", result.result)

输出示例：

生成计划步骤：
WeatherPlugin.get_weather
InventoryPlugin.deduct_stock
执行结果：北京天气：25℃ 晴，库存更新：苹果剩余97件

三、关键特性详解

1. 参数自动映射机制

# 输入自然语言时自动提取参数
context = sk.ContextVariables("用户说：请买5个香蕉")
result = await kernel.run_async(kernel.skills["InventoryPlugin"]["deduct_stock"],input_context=context
)
# 自动提取 item="香蕉", quantity=5

2. 安全约束实践

@sk_function(description="支付接口",name="process_payment",input_description="金额必须为1-10000之间的整数"
)
def process_payment(self, amount: int) -> str:if not 1 <= amount <= 10000:raise ValueError("金额超出允许范围")# 调用支付API...

四、调试技巧

1. 查看已注册插件

print("已注册插件：", [skill.name for skill in kernel.skills.values()])
# 输出：['IntentPlugin', 'InventoryPlugin', 'WeatherPlugin']

2. 参数验证日志

# 设置调试模式
export LOGLEVEL=DEBUG
# 错误示例：
# ValueError: 商品'橘子'不存在 (当库存无该商品时)

五、Python vs C#实现差异

特性	Python实现	C#实现
装饰器语法	`@sk_function`	`[KernelFunction]`属性
异步处理	`async/await`	`async/await`
类型提示	强制类型注解（如`str`, `int`）	强类型参数声明
异常处理	Python原生异常体系	C# Exception类

通过Python实现的SK Plugin，开发者可以快速构建以下场景：

电商机器人：30行代码实现"购买X个Y商品"的完整链路
智能客服：自动路由用户问题到对应处理模块

附录代码

mathplugin.py

import math
from semantic_kernel.skill_definition import sk_functionclass Math:@sk_function(description="描述一个平方根",name="Sqrt",input_description="取平方根")def square_root(self,number:str)->str:return str(math.sqrt(float(number)))math_instance=Math()result=math_instance.square_root("14")
print(f"14的平方根是{result}")

native_function.py


import os
import asyncio
import semantic_kernel as sk
from mathplugin import Math    #导入mathplugin.py中的Math类
from semantic_kernel.connectors.ai.open_ai import OpenAIChatCompletionasync def main():#1/初始化内核kernel=sk.Kernel()#2/配置模型服务kernel.add_chat_service("chat_completion",OpenAIChatCompletion(model_id="qwen-max",api_key=os.getenv("DASHSCOPE_API_KEY"),endpoint="https://dashscope.aliyuncs.com/compatible-mode/v1"))#3/导入数学插件math_plugin=kernel.import_skill(Math(),skill_name="mathplugin")#4/调用插件函数result=await kernel.run_async(math_plugin["Sqrt"],input_str="800")print(f"800的平方根是{result}")asyncio.run(main())

运行结果

14的平方根是3.7416573867739413
800的平方根是28.284271247461902

【Semantic Kernel核心组件】Plugin：连接AI与业务逻辑的桥梁

目录一、Plugin是什么？为什么它是SK的核心？ 一、Plugin的核心机制与Python实现 1. 插件类型：语义函数与本地函数语义函数（Semantic Function） 本地函数（Native Function） 2. Plugin的注…...

编程日记 2025/8/20 8:33:50

《基于神经网络实现手写数字分类》

《基于神经网络实现手写数字分类》一、主要内容： 1、通过B站陈云霁老师的网课，配合书本资料，了解神经网络的基本组成和数学原理。 2、申请云平台搭建实验环境 3、基于5个不同的实验模块逐步理解实验操作步骤，并实现不同模块代码…...

编程日记 2025/8/20 19:27:23

车载诊断架构 --- 车载诊断概念的深度解读

我是穿拖鞋的汉子，魔都中坚持长期主义的汽车电子工程师。老规矩，分享一段喜欢的文字，避免自己成为高知识低文化的工程师：周末洗了一个澡，换了一身衣服，出了门却不知道去哪儿，不知道去找谁，漫无目的走着，大概这就是成年人最深的孤独吧! 旧人不知我近况，新人不知我过…...

编程日记 2025/8/17 7:46:47

四、探索LangChain：连接语言模型与外部世界的桥梁

一、什么是 LangChain LangChain 是一个开源的软件框架，旨在帮助开发者高效构建和部署基于**大型语言模型（LLM）**的应用程序。它通过提供一系列工具、组件和接口，简化了从模型调用、提示工程到复杂应用开发的全流程，使得开发者能够快速将 LLM 集成到实际场景中。 1. 核心…...

编程日记 2025/8/19 14:39:18

LangChain4j中的Chat与语言模型API详解：构建高效对话系统的利器

LangChain4j中的Chat与语言模型API详解：构建高效对话系统的利器引言：大模型时代的开发利器在人工智能快速发展的今天，大型语言模型（LLM）已成为构建智能应用的核心组件。LangChain4j作为Java生态中领先的LLM集成框架…...

编程日记 2025/8/17 21:41:32

C++中const与constexpr的区别

在C中，const和constexpr都用于定义常量，但它们的用途和行为有显著区别： ### 1. **初始化时机** - **const**：表示变量是只读的，但其值可以在**编译时或运行时**初始化。 cpp const int a 5; // 编译…...

编程日记 2025/8/20 19:29:14

长亭2月公开赛Web-ssrfme

环境部署拉取环境报错： 可以尝试拉取一下ubuntu:16.04，看是否能拉取成功将wersion："3"删掉我拉去成功之后，再去拉取环境，成功！ 访问环境测试ssrf 源码 <?php highlight_file(__file__…...

编程日记 2025/8/20 19:12:10

AI日报 - 2025年4月18日

🌟 今日概览(60秒速览) ▎🤖 AGI探讨 | 专家激辩AGI定义与实现时间点，Causal AI被视为关键一步，o3模型预测2027年实现引关注。 Causal AI强调因果关系而非模式；专家清单推荐不同模型适用场景；AGI定义及何时…...

编程日记 2025/8/17 19:56:06

Spring IoC 详解

在 Spring IoC& DI 详解中对 IoC已经有了介绍，下面对 IoC 进行详细介绍。 IoC，即控制反转，在之前我们编写程序的时候，我们都是自己 new 出来一个对象，然后自己去管理这个对象，但是这有时候有些麻烦&a…...

编程日记 2025/8/20 19:24:02

oracle查询当前用户所有字段和表

在 Oracle 数据库中，可以通过查询数据字典视图来获取某个表的字段（列）信息。以下是常用的查询方法： 查询当前用户下的表字段如果您想查看当前用户下某个表的字段信息，可以查询 USER_TAB_COLUMNS 视图： SE…...

编程日记 2025/8/20 19:24:00

ACL(访问控制列表）

ACL(访问控制列表） 1、基础内容访问控制列表ACL(Access ControlList)是由一条或多条规则组成的集合。所谓规则，是指描述报文匹配条件的判断语句，这些条件可以是报文的源地址、目的地址、端口号等。通过一系列规则来匹配报文，如…...

编程日记 2025/8/20 19:24:01

1.建堆（向上调整） 1.1大堆 #include<stdio.h> void swap(int *p1,int *p2) {int temp *p1;*p1 *p2;*p2 temp; } void Ajustup(int *a,int child)//向上调整 {int parent (child - 1) / 2;while (child > 0){if (a[child] > a[parent]…...

编程日记 2025/8/20 19:24:03

在Linux下安装Gitlab

在Cenos7下安装GitLab 在ssh下安装官方安装文档:https://gitlab.cn/install/?versionce 1. 使用阿里YUM 镜像云下载 https://mirrors.aliyun.com/repo/Centos-7.repo替换 /etc/yum.repos.d/CentOS-Base.repo在目录/etc/yum.repos.d/下执行如下命令： curl …...

编程日记 2025/8/19 2:03:40

【算法】快速排序、归并排序（非递归版）

目录一、快速排序（非递归） 1.原理 2.实现 2.1 stack 2.2 partition(array,left,right) 2.3 pivot - 1 > left 二、归并排序（非递归） 1.原理 2.实现 2.1 gap 2.1.1 i 2*gap 2.1.2 gap * 2 2.1.3 gap < array.…...

编程日记 2025/8/20 19:25:49

如何自学机器学习？零基础到实战的完整路径

机器学习作为人工智能的核心领域，已成为技术人必备的硬实力。本文为自学者梳理出一条从零基础到项目落地的系统学习路线，涵盖知识框架、工具链与实战技巧。一、构建三大基础模块（1-2个月） 数学基石：线性代数重点掌握…...

编程日记 2025/8/18 17:17:10

PHP开发环境搭建(Hbuider+phpstudy)

目录 1.Hbuider下载 Hbuider的网址 2.Hbuilder的安装 1-首先找到刚刚下载的安装包 2-然后进行解压 3-进入解压后的文件夹HBuilderX，找到HBuilderX这一项，双击打开 4-选择你喜欢的风格,任意选择一个就可以了 5-选择你选快捷键的方案 6-点击开始体验就可了…...

编程日记 2025/8/20 19:26:22

【4.1.-4.20学习周报】

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档文章目录摘要Abstract一、方法介绍1.1HippoRAG 1.2HippoRAG2二、实验2.1实验概况2.2实验代码2.3实验结果总结摘要本博客介绍了论文《From RAG to Memory: Non-Parametri…...

编程日记 2025/8/20 19:29:14

vim笔记

vim三种模式切换命令常用复制粘贴...

编程日记 2025/8/20 19:28:19

【JAVA】基础知识“抽象类”详解，从入门到理解~

目录 1. 抽象类 1.1 什么是抽象类❓ 1.2 为什么需要抽象类❓ 1.3 抽象类语法 1.4 抽象类特征 ① 抽象类是被abstract修饰的 ② 被abstract修饰的方法称为抽象方法，这个方法可以没有具体的实现 ③ 当一个类中含有抽象方法的时候，该类必须使用abst…...

编程日记 2025/8/20 19:27:51

docker 启动mysql9认证失败

docker compose 启动mysql9认证失败随着mysql更新到了9版本，在docker中相较于8减少了一些体积，很吸引人尝试， 但是在使用原本的配置文件拉起mysql，连接时却提示权限认证失败 1045 - Access denied for user root172.18.0.1 (…...

编程日记 2025/8/19 13:21:40

【Axure绘制原型】图片切割、交互动效、热区、动态面板、元件显示隐藏、表单元件、表格、内联框架

切割功能：将图片切成多部分。通过移动鼠标可以调整两条虚线的位置，点击。虚线相当于切割刀，被虚线分离的部分将变成单独的图切割后的图片： 交互交互动效的构成： 目标：谁触发交互（元…...

编程日记 2025/8/20 19:27:24

DeepSeek智能时空数据分析（一）：筛选特定空间范围内的POI数据

时空数据分析很有用，但是GIS/时空数据库技术门槛太高时空数据分析在优化业务运营中至关重要，尤其在数据驱动决策的当下，其价值正随大模型时代的到来进一步凸显。然而，三大挑战仍制约其发展：技术门槛高，需…...

编程日记 2025/8/18 15:29:37

使用mybatisPlus自带的分页方法+xml实现数据分页

：因为需要实现多表关联分页，原本想的是直接使用selectpagehelper，但是pagehelper只对xml文件生效；后面发现可以直接使用mybatisplus自带的分页，不依靠pagehelper实现多表关联分页； 实现类：关键…...

编程日记 2025/8/20 15:27:52

第六节：React Hooks进阶篇-自定义Hook设计

实战题：实现一个useWindowSize或useFetch 自定义 Hook 设计实战：useWindowSize 与 useFetch 实现详解一、useWindowSize：实时监听窗口尺寸 1. 基础实现（TypeScript 版） import { useState, useEffect } from react…...

编程日记 2025/8/17 20:43:09

Mybatis--XML映射文件配置和动态SQL

XML文件配置 MyBatis中文网动态SQL...

编程日记 2025/8/17 18:20:17

【Java学习笔记】位运算

位运算一、原码，反码，补码 (1) 二进制的最高位是符号位：0 表示正数，1 表示负数（怎么记？ 1旋转一下变成-） (2) 正数的原码、反码、补码都一样（三码合一） (3) 负数的反码…...

编程日记 2025/8/20 19:28:18

循环队列的实现

循环队列实现一个循环队列：C语言代码解析与设计思路1. 循环队列的基本概念2. 数据结构设计3. 初始化队列4. 入队操作5. 出队操作6. 获取队列头部和尾部元素7. 判断队列是否为空或满8. 释放队列资源9. 总结实现一个循环队列：C语言代码解析与设计思路在…...

编程日记 2025/8/20 2:06:42

案例驱动的 IT 团队管理：创新与突破之路：第五章创新管理：从机制设计到文化养成-5.2 技术决策民主化-5.2.1案例：架构设计评审的“七人决策制“

👉 点击关注不迷路 👉 点击关注不迷路 👉 点击关注不迷路文章大纲案例驱动的 IT 团队管理：创新与突破之路 - 第五章创新管理：从机制设计到文化养成5.2 技术决策民主化5.2.1 案例：架构设计评审的“七人决…...

编程日记 2025/8/20 19:27:52

数据库—MySQL游标详解笔记

一、游标是什么？ 游标（Cursor） 是数据库中用于逐行遍历查询结果集的数据库对象。它允许开发者像操作指针一样逐行读取数据，适用于需要对查询结果逐行处理的复杂业务逻辑。核心特点： 逐行操作：类似编程中…...

编程日记 2025/8/20 1:51:15

Genspark：重新定义AI搜索与代理的全能型工具

在当今快速发展的AI技术领域，搜索工具正在经历前所未有的变革。Genspark，这家由前百度高管景鲲和朱凯华创立的AI公司，为我们带来了全新的AI代理引擎体验。作为一位专注于AI工具分享的博主，今天我将为大家详细介绍这款强大的工具&a…...

编程日记 2025/8/20 19:28:20

深入理解设计模式之模板方法模式 1d87ab8b42e98069b6c2c5a3d2710f9a

深入理解设计模式之模板方法模式深入理解设计模式之模板方法模式在软件开发的漫长征程中，我们常常会遇到各种复杂的业务逻辑，其中部分逻辑具有相似的流程框架，但在具体细节上又有所不同。这种情况下，模板方法模式就如同一位得…...

编程日记 2025/8/19 2:03:46

Cursor + MCP，实现自然语言操作 GitLab 仓库

本分分享如何使用 cursor mcp 来操作极狐GitLab 仓库，体验用自然语言在不接触极狐GitLab 的情况下来完成一些仓库操作。极狐GitLab 是 GitLab 在中国的发行版，关于中文参考文档和资料有： 极狐GitLab 中文文档极狐GitLab 中文论坛极狐GitL…...

编程日记 2025/8/17 1:45:25

界面开发框架DevExpress XAF实践：如何在Blazor项目中集成.NET Aspire？(一)

DevExpress XAF是一款强大的现代应用程序框架，允许同时开发ASP.NET和WinForms。DevExpress XAF采用模块化设计，开发人员可以选择内建模块，也可以自行创建，从而以更快的速度和比开发人员当前更强有力的方式创建应用程序。 .NET As…...

编程日记 2025/8/17 20:07:20

【C++】特化妙技与分文件编写 “雷区”

目录目录非类型模板参数非类型模板参数vs宏代换模板的特化函数模板的特化函数模板特化的坑类模板特化全特化偏特化模板分离编译原理解决方案 end 目录非类型模板参数模板参数可分为类型形参和非类型形参。类型形参： 出现在模板参数列表中，跟在…...

编程日记 2025/8/17 20:24:36

qt+mingw64+cmake+libqrencode项目编译和搭建成功记录

最近要使用高拍仪拍照获取照片，然后识别照片中的二维码数据、使用QZxing只能识别出一个条码、另外一个条码准备测试用其他的开源项目（如libqrencode-4.1.1）来进行测试，故进行本文的项目环境搭建测试，最后成功。本机开…...

编程日记 2025/8/17 14:24:08

观察者设计模式详解：解耦通知机制的利器

在面向对象设计中，设计模式为我们提供了通用的解决方案，以应对常见的开发问题。观察者设计模式是其中非常经典且实用的一种模式，广泛应用于GUI系统、事件处理、消息推送等场景。今天，我们就深入探讨观察者模式的概念、结构和特点&…...

编程日记 2025/8/17 20:19:34

Vim使用完全指南：从基础到高效编辑

Vim使用完全指南：从基础到高效编辑一、Vim简介与基本概念 Vim（Vi IMproved）是从vi发展出来的一个功能强大的文本编辑器，以其高效性和灵活性著称，特别适合程序开发和系统管理任务。与常规文本编辑器不同，…...

编程日记 2025/8/17 18:20:24

C语言——数组

在C语言中，数组是一组相同类型元素的集合，并且每个数据都有自己对应的一个序号，我们称之为数组下标或者索引。接下来我们就来看看数组是如何定义的吧！ 目录 1.一维数组 1.1 定义与初始化 1.2 一维数组的使用 1.3 一维数组在内…...

编程日记 2025/8/17 20:31:03

电商|基于java+vue的农业电商系统(源码+数据库+文档)

农业电商系统目录基于java的农业电商系统一、前言二、系统设计三、系统功能设计系统功能实现前台： 后台： 四、数据库设计五、核心代码六、论文参考七、最新计算机毕设选题推荐八、源码获取： 博主介绍：✌️…...

编程日记 2025/8/17 19:54:50

ServletContextAttributeListener 的用法笔记250417

ServletContextAttributeListener 的用法笔记250417 以下是关于 ServletContextAttributeListener 的用法详解，涵盖核心方法、实现场景、注意事项及最佳实践，帮助您有效监听应用级别属性（ServletContext）的变化： 1. 核…...

编程日记 2025/8/20 0:32:38

iptables 防火墙

目录熟悉Linux防火墙的表，链结构理解数据包匹配的基本流程学会编写iptables规则前言在当今信息化时代,网络安全已成为企业和个人不可忽视的重要议题。随着网络攻击手段的不断升级,构建一个坚固的网络安全防线显得尤为迫切。在Linux系统中,iptables作为一款…...

编程日记 2025/8/17 20:08:56

【厦门大学】DeepSeek大模型及其企业应用实践

DeepSeek大模型及其企业应用实践前言1. 大模型：人工智能的前沿1.1 大模型的概念1.2 大模型的发展历程1.3 人工智能与大模型的关系1.4 大模型的分类 2. 大模型产品2.1 国外的大模型产品2.2 国内的大模型产品2.3 主流大模型“幻觉”评测 3. 大模型的行业应用3.1 自然…...

编程日记 2025/8/20 11:01:00

解锁智能制造：PLC远程下载如何让设备运维效率提升10倍？

一、2025年远程运维的三大变革驱动力政策强制： 欧盟CE新规要求：2025年起工业设备必须具备远程审计接口中国等保2.0：工业控制系统远程访问需达到三级防护技术成熟： 5G专网边缘计算实现ms级响应算法自动诊断PLC程序异常&#x…...

编程日记 2025/8/20 5:22:58

卷积神经网络CNN（李宏毅）

目录怎么把一张影响当成一个模型输入？ 同样的 pattern出现在图片不同的位置。第三个问题：Pooling： 阿尔法Go是怎么下围棋的： CNN不能处理的问题 CNN专门用在影像辨识方面怎么把一张影响当成一个模型输入？ 一张…...

编程日记 2025/8/17 20:56:35

URL / GET请求中文UTF-8编码JS转化

以长颈鹿为例 decodeURIComponent 将编码转为中文 encodeURIComponent 会对整个参数字符串转义（包括 :// 等符号）。 encodeURI 仅转义非合法 URL 字符（不转义 :/?& 等保留字符）。 decodeURIComponent("%E9%95%BF%E9…...

编程日记 2025/8/17 20:48:35

Flink 内部通信底层原理

Flink 集群内部节点之间的通信是用 Akka 实现，比如 JobManager 和 TaskManager 之间的通信。而 operator 之间的数据传输是用 Netty 实现。 RPC 框架是 Flink 任务运行的基础，Flink 整个 RPC 框架基于 Akka 实现。一、相关概念 RPC（Remote Procedure Call）概念定义：…...

编程日记 2025/8/19 9:27:54