BotSharp UI

项目定位#

BotSharp UI 是 SciSharp 组织下 BotSharp 多 Agent 框架的官方前端项目，定位于 AI Agent 的集中式管理前端，解决企业在使用 BotSharp 后端框架构建多 Agent 系统时缺乏统一可视化操作平面的问题。本仓库仅包含前端界面，所有 LLM 调用、RAG 检索、MCP 工具集成、多渠道消息路由等核心能力均由后端 BotSharp（C# / .NET Core）提供。

核心能力#

Agent 构建与管理#

• 节点式可视化构建：Node-based 交互方式，可快速搭建新 AI 助手
• Agent 生命周期管理：创建、配置、管理已有 Agent 实例

对话与实时交互#

• 对话会话管理：管理对话会话与历史记录
• WebSocket 实时通信：支持 Realtime Session，低延迟流式交互
• 推理过程展示：支持展示 Agent 的 Thinking / 推理过程（refine thinking content）

其他特性#

• 内置高级搜索功能
• 原生支持中文国际化
• 提供容器化部署支持（Dockerfile）
• 支持多环境配置（.env、.env.local、.env.production）
• 原生支持 Azure Static Web Apps 部署

前端架构#

基于 SvelteKit v2 的现代 SPA 应用，使用 Vite 作为构建工具。技术构成为 Svelte (48.4%)、SCSS (41.8%)、JavaScript (9.8%)。前端与后端完全解耦，通过 RESTful API（常规请求）和 WebSocket（实时会话）与 BotSharp .NET 后端通信，构建产物为纯静态文件，可独立部署。

后端依赖（BotSharp）#

BotSharp 后端采用 C# / .NET Core，插件化 + Pipeline 流式执行设计，插件完全解耦。核心模块包括 Plugin Loader、Hooking、Authentication、Agent Profile、Conversation & State、Routing & Planning、Templating、File Repository、Caching、Rich Content、LLM Provider。支持的 LLM 包括 OpenAI (GPT-3.5/4o/o1)、Google Gemini 2、Anthropic Claude、DeepSeek V3、LLaMA 3、HuggingFace 等；存储支持 MongoDB、LiteDB、腾讯 COS；内置 RAG、向量搜索、多 Agent 路由规划、MCP 工具集成；消息渠道覆盖 Facebook Messenger、Slack、Telegram 等。

安装与部署#

前置条件：需先运行 BotSharp 后端服务（默认地址 http://localhost:5015/）

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

生产构建：

npm run build
npm run preview

Azure 部署：

npm run build -- --mode production
npm install -g @azure/static-web-apps-cli
swa deploy ./build/ --env production --deployment-token {token}

配置体系#

• 根目录 .env 为默认配置，.env.local 可覆盖默认值（不纳入版本控制），.env.production 用于生产环境
• 通过 --mode CLI 参数切换环境配置文件
• 通过环境变量指定 BotSharp 后端 API 地址

适用场景#

• 企业内部 AI Agent 的构建与管理平台
• 多 Agent 协作系统的可视化调试与测试
• LLM Agent 对话过程的审计与推理链路展示
• 配合后端实现 RAG 知识库管理、MCP 工具管理等场景的统一入口

待确认信息#

• .env 文件具体配置字段未详细列出，后端 API 地址对应的环境变量名待确认
• 最新 Release 标记为 r2.0-agent-utility，未采用标准语义化版本号
• 在线 Demo 地址未在 README 中给出具体可访问链接
• WebSocket 连接路径与消息协议格式未在材料中体现
• Agent 推理过程展示的技术实现细节尚不明确