eShopSupport

一个 .NET 示例应用程序，展示了在 .NET 中构建 AI 解决方案的常见用例和开发实践（特别是生成式 AI）。此示例演示了一个基于服务架构、使用 .NET Aspire 的电子商务网站客户支持应用程序。它支持以下 AI 用例：

• 文本分类：根据内容应用标签
• 基于消息内容的情感分析
• 大量文本的摘要生成
• 合成数据生成：为示例创建测试内容
• 包含聊天历史和建议回复的聊天机器人交互

此示例还展示了以下开发实践：

• 在本地使用小型本地模型开发解决方案
• 使用有据可依的问答数据评估 AI 回答的质量
• 将 Python 项目作为 .NET Aspire 解决方案的一部分加以利用
• 将应用程序（包括小型本地模型）部署到云端（即将推出）

架构

入门

先决条件

• 配备 Nvidia GPU 的设备（请参阅 在 CPU 上运行的变通方法）
• 克隆 eShopSupport 仓库：https://github.com/dotnet/eshopsupport
• 安装并启动 Docker Desktop
• 安装 Python 3.12.5

Windows（配备 Visual Studio）

• 安装 Visual Studio 2022 版本 17.10 或更高版本
  • 选择以下工作负载：
    • ASP.NET 和 Web 开发 工作负载。
    • Python 开发 工作负载。
    • .NET Aspire SDK 组件，位于 单独组件 中。

Mac、Linux 及未安装 Visual Studio 的 Windows

• 安装最新的 .NET 8 SDK

• 使用以下命令安装 .NET Aspire 工作负载：

  dotnet workload update
  dotnet workload install aspire
  dotnet restore eShopSupport.sln
  

• （可选）安装 Visual Studio Code，并添加 C# Dev Kit 扩展

安装 Python 依赖项

在终端中，进入克隆后的仓库根目录，运行以下命令：

pip install -r src/PythonInference/requirements.txt

注意： 如果上述命令在 Windows 上无法运行，请使用以下命令：

py -m pip install -r src/PythonInference/requirements.txt

运行解决方案

[!警告] 请确保 Docker 已启动。

• （仅限 Windows）从 Visual Studio 运行应用程序：

  • 在 Visual Studio 中打开 eShopSupport.sln 文件
  • 确保 AppHost 是您的启动项目
  • 按 Ctrl-F5 启动 .NET Aspire

• 或者从终端运行应用程序：

  dotnet run --project src/AppHost
  

  然后在控制台输出中查找类似以下内容的行，以获取用于打开 Aspire 仪表板的 URL：

  登录仪表板的地址为：http://localhost:17191/login?t=uniquelogincodeforyou
  

您可能需要先安装 ASP.NET Core HTTPS 开发证书，然后关闭所有浏览器标签页。更多信息请访问 https://aka.ms/aspnet/https-trust-dev-cert

贡献

本项目已采用 Microsoft 开源行为准则。有关更多信息，请参阅 行为准则常见问题解答，或发送电子邮件至 opencode@microsoft.com 提出任何其他问题或意见。

示例数据

示例数据定义在 seeddata 中。所有产品、描述、品牌、手册、客户以及支持工单名称均为虚构，并使用包含的 DataGenerator 项目，通过 GPT-35-Turbo 生成。

eShopSupport 快速上手指南

eShopSupport 是一个基于 .NET Aspire 构建的示例应用，展示了如何在 .NET 中开发生成式 AI（Generative AI）解决方案。该项目模拟了一个电商网站的客户支持系统，涵盖了文本分类、情感分析、文本摘要、合成数据生成以及带有历史记录的聊天机器人等核心 AI 场景。

环境准备

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

硬件要求

• GPU: 推荐配备 NVIDIA GPU 的设备以获得最佳性能。
  • 注：若无 GPU，可参考 CPU 运行变通方案，但性能可能受限。

软件依赖

• Docker Desktop: 必须安装并启动。下载地址
• Python: 必须安装 Python 3.12.5。下载地址
  • 国内用户建议通过镜像源安装或使用国内镜像配置 pip。
• .NET 8 SDK: 需要最新版本。下载地址

开发工具（任选其一）

选项 A：Visual Studio (仅限 Windows)

• 版本：Visual Studio 2022 v17.10 或更高。
• 需勾选的工作负载：
  • ASP.NET and web development
  • Python Development
  • 在“单个组件”中勾选 .NET Aspire SDK

选项 B：命令行 + VS Code (跨平台)

• 安装 .NET Aspire 工作负载：

  dotnet workload update
  dotnet workload install aspire
  

• (可选) 安装 Visual Studio Code 并配置 C# Dev Kit 扩展。

安装步骤

1. 克隆项目

git clone https://github.com/dotnet/eshopsupport
cd eshopsupport

2. 安装 Python 依赖

在项目根目录打开终端，运行以下命令安装推理所需的 Python 包：

pip install -r src/PythonInference/requirements.txt

Windows 用户注意：如果上述命令失败，请使用以下替代命令：

py -m pip install -r src/PythonInference/requirements.txt

3. 恢复 .NET 依赖

dotnet restore eShopSupport.sln

基本使用

启动应用

方法一：使用 Visual Studio (Windows)

1. 打开 eShopSupport.sln 文件。
2. 确保将 AppHost 设置为启动项目。
3. 按 Ctrl+F5 启动 .NET Aspire 仪表盘。

方法二：使用命令行 (跨平台) 在终端中运行：

dotnet run --project src/AppHost

访问应用

启动成功后，控制台会输出类似以下的日志，其中包含 .NET Aspire 仪表盘的登录地址：

Login to the dashboard at: http://localhost:17191/login?t=uniquelogincodeforyou

1. 复制该 URL 并在浏览器中打开。
2. 登录仪表盘后，您可以查看各个微服务（如 AI 推理服务、数据库等）的状态。
3. 点击仪表盘中的 Web 前端服务链接 即可进入电商支持系统进行体验（测试聊天机器人、查看工单情感分析等）。

提示：首次运行可能需要安装 ASP.NET Core HTTPS 开发证书。若遇到证书信任问题，请参考 官方文档 安装证书并重启浏览器。