semantic-kernel

把大模型塞进你的 .NET 应用，像写普通代码一样编排 AI 任务

Semantic Kernel 是微软推出的开源 SDK，旨在帮助开发者将大语言模型（LLM）快速集成到现有应用中。它解决了传统 AI 集成中提示词管理、上下文处理、插件调用和任务编排的复杂性，提供了一套统一的编程模型。核心能力包括：支持多种 LLM 提供商（如 OpenAI、Azure OpenAI、Hugging Face），通过语义函数（Semantic Function）和原生函数（Native Function）混合编排复杂工作流，内置记忆（Memory）系统用于存储和检索上下文，以及自动规划（Planner）能力来自动分解任务。它采用 C# 编写，与 .NET 生态深度集成，同时也提供 Python 和 Java 版本。适合构建企业级 AI 应用，如智能助手、自动化流程和知识管理系统。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 28591

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队microsoft

所属国家

官网地址https://aka.ms/semantic-kernel

GitHubhttps://github.com/microsoft/semantic-kernel

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署集成到应用中。

访问状态

是否开源是

开源协议MIT

主要语言C#

技术栈/模型ai,artificial-intelligence,llm,openai,sdk

GitHub 星标★ 28591

30天Star增速

HF 下载量

上线时间2023-02-27 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数7

使用教程

难度：进阶约 10 分钟部署方式：库/依赖 3 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 3.10 及以上（使用 Python 版 SDK）
.NET 10（使用 C# 版 SDK）
一个 Azure OpenAI 或 OpenAI 的 API Key
能访问 GitHub / 官网获取文档的网络环境

安装与启动步骤

1确认运行时版本

README 的 System Requirements 要求 Python 3.10+ 或 .NET 10，请先确认本机已安装对应版本，再选择语言版本接入。
2配置 Azure 密钥

若使用 Azure OpenAI 服务，按 README 说明导出环境变量 AZURE_OPENAI_API_KEY，值为你的 Azure 密钥。
```
export AZURE_OPENAI_API_KEY=AAA....
```
3配置 OpenAI 密钥

若直接使用 OpenAI，改为导出 OPENAI_API_KEY，示例值为 sk- 开头的密钥；二者按需选一个即可。
```
export OPENAI_API_KEY=sk-...
```

关键配置

配置项	必填	说明	示例
`AZURE_OPENAI_API_KEY`	否	Azure OpenAI 服务的访问密钥，使用 Azure 时必填	`AAA....`
`OPENAI_API_KEY`	否	OpenAI 官方服务的访问密钥，直连 OpenAI 时必填	`sk-...`

如何确认成功

README 未给出验证命令，设置好密钥后按官网 aka.ms/semantic-kernel 的 Quickstart 跑通首个示例即为成功。

常见问题

Q：Semantic Kernel 现在还能继续使用吗？

A：README 提示项目已由 Microsoft Agent Framework（MAF）接替，MAF 已发布 1.0 正式版；官方提供了从 Semantic Kernel 迁移的迁移指南。

Q：需要安装哪些运行时环境？

A：按 README 的 System Requirements，Python 版本需 3.10 以上，.NET 版本需 .NET 10，按你使用的语言选择其一。

Q：支持哪些模型提供商？

A：README 的安装部分只演示了 Azure OpenAI 和 OpenAI 两种密钥配置，其他提供商需查阅官方文档。

Q：为什么没有 pip install 或 dotnet add 命令？

A：README 节选中未提供任何包安装命令，Installation 部分只讲环境变量，因此需到官网文档获取具体安装方式。

注意事项

Semantic Kernel 已被 Microsoft Agent Framework 取代，新项目建议优先评估 MAF 并参考官方迁移指南。
README 未给出包安装命令与端口、路径等信息，本教程不含任何未证实的命令，请以官网 aka.ms/semantic-kernel 为准。
API Key 属于敏感信息，不要写入代码仓库，建议通过环境变量或密钥管理服务注入。

核心亮点

微软官方支持，与 .NET 生态无缝集成，C# 开发者上手快
支持多模型提供商，可灵活切换 OpenAI、Azure 等，避免锁定
提供语义函数与原生函数混合编排，能处理复杂业务逻辑

不足之处

文档和示例偏重基础，高级场景（如自定义规划器）资料较少
概念较多（函数、规划器、记忆），学习曲线较陡

适用场景

企业级智能客服，集成内部知识库和业务流程
自动化工作流，让 LLM 调用现有 API 完成任务
构建可扩展的 AI 助手，支持多模型切换和插件扩展

替代项目

LangChain、AutoGen、Haystack

项目介绍

semantic-kernel 是开发框架领域的开源项目，由 microsoft 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（28,591）位列前 2%，在开发框架分类的 795 个项目里位列前 2%。

近 41 天，它的 GitHub 星标从 28,444 增加到 28,591，净增 147。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署集成到应用中。

它主要面向的使用场景是：企业级智能客服，集成内部知识库和业务流程。同类可对比的替代方案包括 LangChain、AutoGen、Haystack。

上一篇：prompt-optimizer

下一篇：ai