开源AI智能体应用框架

将大语言模型连接到您现有的业务导向型应用

"对话即平台（CaaP）就是未来，因此我们已经通过BotSharp AI BOT平台构建工具为.NET开发者提供了完整的工具集来构建CaaP，这再合适不过了。它尽可能地释放您自有机器人的学习能力，并精确控制AI处理流程中的每一步。"

BotSharp 是一个用于构建AI机器人平台的开源机器学习框架。该项目涉及自然语言理解、计算机视觉和音频处理技术，旨在推动信息系统中智能机器人助手的发展与应用。开箱即用的机器学习算法使普通程序员能够更快速、更轻松地开发人工智能应用。

BotSharp 使用C#编写，运行在跨平台的.Net Core框架上，采用插件化和流水线执行的设计，实现了插件之间的完全解耦。C#是一种企业级编程语言，广泛应用于信息管理相关系统的业务逻辑开发，对企业的开发者更加友好。BotSharp直接使用C#中的机器学习算法，这不仅充分利用了C#这种强类型语言的优势，也使得在系统范围内重构代码变得更加容易。

BotSharp 严格遵循组件化原则，将平台构建所需的各个部分解耦开来。因此，您可以选择不同的UI/UX界面，或更换不同的LLM提供商。所有这些组件都基于统一的接口进行了模块化设计。BotSharp 提供了一个高级的智能体抽象层，可以高效地管理企业中的复杂应用场景，使企业开发者能够高效地将AI集成到业务系统中。

一些特性

• 内置多智能体及带状态管理的对话功能。
• 支持多种LLM规划方法，以应对从简单到复杂的不同任务。
• 内置RAG相关接口，支持基于记忆的向量检索。
• 支持多个AI平台（ChatGPT 3.5/ 4o/ o1、Gemini 2、LLaMA 3、Claude Sonnet 3.5、DeepSeek V3、HuggingFace）。
• 允许多个具有不同职责的智能体协作完成复杂任务。
• 在一处即可构建、测试、评估和审计您的LLM智能体。
• 内置由SvelteKit编写的BotSharp UI。
• 抽象出标准的富内容数据结构，可与Facebook Messenger、Slack和Telegram等流行的消息渠道集成。
• 提供RESTful Open API和WebSocket实时通信功能。
• 内置MCP集成：可视化管理MCP，实现大模型对工具的调用。支持mcp.so等主流服务。

快速开始

1. 运行后端服务

 PS D:\> git clone https://github.com/dotnetcore/BotSharp
 PS D:\> cd BotSharp
 # 对于Windows
 PS D:\BotSharp\> dotnet run --project .\src\WebStarter\WebStarter.csproj -p SolutionName=BotSharp
 # 对于Linux
 $ dotnet run --project ./src/WebStarter/WebStarter.csproj -p SolutionName=BotSharp

2. 运行Admin UI项目，参考BotSharp UI。

PS D:\> git clone https://github.com/SciSharp/BotSharp-UI
PS D:\> cd BotSharp-UI
PS D:\> npm install
PS D:\> npm run dev

访问 http://localhost:5015/

带有UI的在线演示

核心模块

核心模块主要由抽象层和框架功能的实现组成，同时包含一些常用工具。

• 插件加载器
• 钩子机制
• 认证
• 智能体档案
• 对话与状态管理
• 路由与规划
• 模板引擎
• 文件仓库
• 缓存
• 富内容
• LLM提供商

插件

BotSharp采用组件化设计，内核保持最小化，业务功能则由外部组件实现。模块化的架构也使得贡献者能够更好地参与其中。以下是内置插件：

数据存储

• BotSharp.Core.Repository
• BotSharp.Plugin.MongoStorage
• BotSharp.Plugin.LiteDBStorage
• BotSharp.Plugin.TencentCos

LLMs

• BotSharp.Plugin.Planner
• BotSharp.Plugin.AzureOpenAI
• BotSharp.Plugin.OpenAI
• BotSharp.Plugin.AnthropicAI
• BotSharp.Plugin.DeepSeekAI
• BotSharp.Plugin.GoogleAI
• BotSharp.Plugin.MetaAI
• BotSharp.Plugin.HuggingFace
• BotSharp.Plugin.LLamaSharp
• BotSharp.Plugin.SemanticKernel
• BotSharp.Plugin.SparkDesk

消息/渠道

• BotSharp.OpenAPI
• BotSharp.Plugin.ChatHub
• BotSharp.Plugin.MetaMessenger
• BotSharp.Plugin.Twilio
• BotSharp.Plugin.TelegramBots
• BotSharp.Plugin.WeChat

RAGs

• BotSharp.Plugin.KnowledgeBase
• BotSharp.Plugin.Qdrant

视觉

• BotSharp.Plugin.PaddleSharp

工具

• BotSharp.Plugin.Dashboard
• BotSharp.Plugin.RoutingSpeeder
• BotSharp.Plugin.AudioHandler
• BotSharp.Plugin.ChartHandler
• BotSharp.Plugin.EmailHandler
• BotSharp.Plugin.ExcelHandler
• BotSharp.Plugin.FileHandler
• BotSharp.Plugin.ImageHandler
• BotSharp.Plugin.HttpHandler
• BotSharp.Plugin.SqlDriver
• BotSharp.Plugin.WebDriver
• BotSharp.Plugin.PythonInterpreter

UIs

• BotSharp.Plugin.ChatbotUI

路线图

• A2A
• MCP
• 实时
• 计算机使用
• 浏览器使用
• 数据库助手
• 代码解释器
• 对话管理
• 多智能体路由
• 知识库

文档

阅读文档：https://botsharp.readthedocs.io?wt.mc_id=AI-MVP-5005183

新的文档网站：https://botsharp.verdure-hiro.cn

如果您觉得这个项目对您有帮助，请给项目点个赞，我们将不胜感激。

SciSharp STACK 的成员项目，该组织是基于 .NET 的开源软件生态系统，专注于数学、科学和工程领域。

BotSharp 快速上手指南

BotSharp 是一个基于 .NET Core 的开源 AI Agent 应用框架，旨在帮助开发者将大语言模型（LLM）与企业现有业务系统无缝连接。它支持多 Agent 协作、RAG、视觉处理及多种主流 LLM 提供商，采用插件化架构，适合企业级开发。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、Linux 或 macOS（跨平台支持）。
• .NET SDK：安装 .NET 6.0 或更高版本（推荐 .NET 8.0）。
  • 下载地址：https://dotnet.microsoft.com/download
  • 国内加速镜像：清华大学 .NET 镜像
• Node.js：用于运行前端管理界面（BotSharp UI），建议安装 LTS 版本。
  • 下载地址：https://nodejs.org/
• Git：用于克隆代码仓库。

安装步骤

BotSharp 分为后端服务（.NET）和前端管理界面（SvelteKit）两部分，需分别启动。

1. 克隆并启动后端服务

打开终端（PowerShell 或 Bash），执行以下命令：

# 克隆主仓库
git clone https://github.com/dotnetcore/BotSharp
cd BotSharp

# Windows 启动命令
dotnet run --project .\src\WebStarter\WebStarter.csproj -p SolutionName=BotSharp

# Linux/Mac 启动命令
dotnet run --project ./src/WebStarter/WebStarter.csproj -p SolutionName=BotSharp

提示：首次运行时会自动下载 NuGet 包。若下载缓慢，可配置国内 NuGet 源： dotnet nuget add source https://api.nuget.cn/v3/index.json -n nuget.cn

2. 克隆并启动前端管理界面

新开一个终端窗口，执行以下命令：

# 克隆 UI 仓库
git clone https://github.com/SciSharp/BotSharp-UI
cd BotSharp-UI

# 安装依赖（推荐使用国内镜像源加速）
npm install --registry=https://registry.npmmirror.com

# 启动开发服务器
npm run dev

3. 访问系统

启动完成后，在浏览器中访问： http://localhost:5015/

您也可以在 Azure 在线演示环境 直接体验功能。

基本使用

BotSharp 的核心优势在于通过可视化界面或代码快速构建多 Agent 协作流程。以下是基于 Web 界面的最简使用流程：

1. 创建 Agent： 登录管理后台，进入 "Agent Builder"，点击新建 Agent。设置 Agent 的名称、角色描述（System Prompt）以及绑定的 LLM 提供商（如 Azure OpenAI, ChatGPT, DeepSeek 等）。

2. 配置知识库 (RAG)： 在 Agent 配置页启用 "Knowledge Base"，上传企业文档（PDF, Word, TXT 等）。系统将自动进行向量化处理，使 Agent 具备回答私有数据的能力。

3. 定义工具 (Tools)： 利用内置插件（如 SqlDriver, HttpHandler, PythonInterpreter），在界面上勾选 Agent 可调用的工具。例如，勾选 SqlDriver 后，Agent 即可通过自然语言查询数据库。

4. 测试与对话： 在右侧预览窗口输入指令，例如：“查询上个月销售额最高的产品并生成图表”。BotSharp 会自动规划任务，调用相应工具，并返回结果。

5. 集成到业务系统： 通过 BotSharp 提供的 RESTful API 或 WebSocket 接口，将构建好的 Agent 嵌入到您的 C# 业务系统、微信公众号、钉钉或 Slack 中。

// C# 代码调用示例（伪代码）
var client = new BotSharpClient("http://localhost:5015");
var response = await client.SendAsync(agentId: "sales-agent", message: "分析本周销售趋势");
Console.WriteLine(response.Content);

通过以上步骤，您即可利用 BotSharp 快速搭建具备记忆、规划及工具调用能力的企业级 AI 应用。