面向初学者的生成式 AI .NET 课程

实用课程，教你如何在 .NET 中构建生成式 AI 应用程序

欢迎来到 面向初学者的生成式 AI .NET，这是专为 .NET 开发人员设计的实践课程，带你进入生成式 AI 的世界！

这不是一个典型的“给你一些理论，祝你好运”的课程。本存储库专注于 实际应用 和 实时编码，帮助 .NET 开发人员充分利用生成式 AI。

这是一门 动手实践、实用性强 并且旨在 有趣 的课程！

别忘了 给这个仓库加星标 (🌟)，以便稍后更容易找到它。

➡️ 通过 派生此仓库 获取你自己的副本，并在你的个人仓库中找到它。

✨ 最新动态

我们不断改进此课程，加入最新的 AI 工具、模型和实用示例：

• 🚀 Microsoft Agent Framework 达到候选发布版本！

  Microsoft Agent Framework 已达到 候选发布版本 (1.0.0-rc1) —— 这是一个用于在 .NET 中构建代理和多代理系统的框架。我们的示例正在迁移到 RC API。在此期间，探索 25+ 个涵盖控制台应用程序、Web 聊天、多代理工作流和 Foundry 集成的 Agent Framework 示例。

  👉 探索 Agent Framework 示例

• 🤖 使用 Agent Framework 的 Claude 模型

  将来自 Microsoft Foundry 的 Claude 模型 与 Microsoft Agent Framework 集成！三个全面的示例展示了：

  • 使用 ChatClientAgent 与 Claude 进行基本控制台聊天
  • 通过线程序列化/反序列化实现对话持久性
  • 具有现代 UI 的交互式 Blazor Web 聊天应用程序
  • 自定义 ClaudeToOpenAIMessageHandler 以实现无缝 API 桥接
  • 支持 Claude Haiku、Sonnet 和 Opus 模型

  👉 探索 Claude MAF 示例

  另外还有一个基础的 Claude 集成示例：

  👉 通过 Microsoft Foundry 使用 Claude 的 BasicChat

在我们的最新动态存档中查看所有以前的更新

🚀 简介

生成式 AI 正在改变软件开发，而 .NET 也不例外。本课程旨在通过以下方式简化学习过程：

• 每节课配有 5-10 分钟的短视频。
• 提供可以运行和探索的完整 .NET 代码示例。
• 集成工具，包括 GitHub Codespaces，以便快速设置和缩短编码时间。你可以使用 Azure OpenAI 服务 / Microsoft Foundry 或 Ollama 进行本地模型托管。

你将学习如何将生成式 AI 集成到 .NET 项目中，从基本的文本生成到使用 Azure OpenAI 服务 和 带有 Ollama 的本地模型 构建完整的解决方案。

📦 每节课包含

• 短视频：快速概述本节课内容（5-10 分钟）。
• 完整代码示例：功能齐全，随时可以运行。
• 分步指导：简单的说明，帮助你学习和实现这些概念。
• 深入参考资料：本课程侧重于 GenAI 的实际实现，若需深入了解理论部分，我们还提供了 面向初学者的生成式 AI - 课程 中的解释链接。

🗃️ 课程

#	课程链接	描述
01	生成式 AI 简介	什么是生成式 AI，以及它与传统编程的区别 为什么 .NET 是 AI 开发的一等公民（first-class citizen） Microsoft AI 技术栈及其各部分的作用 如何在 GitHub Codespaces 中运行示例或配置本地开发环境
02	生成式 AI 技术	如何创建具有上下文和记忆的聊天对话 文本嵌入（text embeddings）的工作原理及其重要性 如何处理包括图像和文档在内的不同内容类型 如何使用 Microsoft.Extensions.AI 抽象调用 AI 模型
03	AI 模式与应用	如何构建理解语义的语义搜索 如何实现检索增强生成（Retrieval Augmented Generation, RAG） 如何创建能够处理和理解文档的应用程序 何时使用每种模式以及如何将它们结合使用
04	使用 Microsoft Agent Framework 的 AI 代理	代理与聊天机器人有何不同 如何构建使用工具并采取行动的代理 如何协调多个代理协同工作 如何与模型上下文协议（Model Context Protocol, MCP）集成
05	负责任的 AI	如何识别和缓解 AI 应用中的偏见 如何实施内容安全和防护措施 如何在系统中构建透明性和可解释性 针对代理系统的伦理考量

🌐 多语言支持

语言	代码	翻译版 README 链接	最后更新日期
简体中文	zh	中文翻译	2025-06-24
繁体中文	tw	中文翻译	2025-06-24
法语	fr	法语翻译	2025-06-24
日语	ja	日语翻译	2025-06-24
韩语	ko	韩语翻译	2025-06-24
葡萄牙语	pt	葡萄牙语翻译	2025-06-24
西班牙语	es	西班牙语翻译	2025-06-24
德语	de	德语翻译	2025-06-24

注意： 所有翻译均于 2025-06-24 更新以匹配原始内容。详情请参阅 PR #161。

🛠️ 所需条件

要开始学习，您需要：

1. 一个 GitHub 账户（免费即可！）用于将此仓库 派生（fork） 到您自己的 GitHub 账户。

2. 启用 GitHub Codespaces 以获得即时编码环境。您可以在仓库设置中启用 GitHub Codespaces。更多关于 GitHub Codespaces 的信息，请查看 此处。

3. 通过 派生此仓库 创建您的副本，或者使用页面顶部的 Fork 按钮。

4. 对 .NET 开发 的基本了解。更多关于 .NET 的信息，请查看 此处。

5. Azure Developer CLI (azd) — 在此安装（自动 Azure 设置所需）

6. 一个 Azure 账户 — 在此创建免费账户（免费账户即可！）

这就足够了。

我们设计了本课程，尽可能减少摩擦。为了帮助您快速上手，我们使用了以下方法：

• 在 GitHub Codespaces 中运行：只需单击一下，您就可以获得一个预配置的环境来测试和探索课程。
• 使用 Azure OpenAI / Microsoft Foundry：通过 Azure 访问强大的 AI 模型，适用于生产级场景。

当您准备扩展时，我们还提供了以下指南：

• 使用 Ollama 在本地硬件上运行模型，以增强隐私和控制。

---

🚀 使用 Azure 快速入门

自动化设置（推荐）

对于首次使用 Azure 的用户，我们提供了一个自动化设置脚本，用于部署所有必要的资源：

# 导航到仓库根目录
cd Generative-AI-for-beginners-dotnet

# 运行设置脚本
./setup.ps1

这将：

• ✅ 部署 Azure OpenAI 资源（gpt-5-mini, text-embedding-3-small）
• ✅ 创建必要的存储和支持服务
• ✅ 自动配置 .NET 用户密钥
• ✅ 显示您的 Azure OpenAI 终端节点和凭据

详细说明，请参阅 Azure 资源设置指南。

---

手动设置现有 Azure 账户

如果您已经拥有 Azure OpenAI 账户并已部署模型，请直接配置密钥：

# 设置共享密钥（所有示例均使用）
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:Endpoint" "https://<your-region>.openai.azure.com/"
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:Deployment" "gpt-5-mini"
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:EmbeddingDeployment" "text-embedding-3-small"

然后导航到任何示例并运行：

cd samples/CoreSamples/BasicChat-01MEAI
dotnet run app.cs

注意： Azure OpenAI 示例使用 az login 进行身份验证。在运行任何 Azure 示例之前，请先运行 az login。

更多手动设置选项，请参阅 Azure 资源设置指南。

---

🧹 资源清理

完成课程后，请清理 Azure 资源以避免持续收费：

./cleanup.ps1

这将：

• 删除所有 Azure 资源
• 清理本地配置
• 移除用户密钥

更多内容，请参阅 Azure 资源设置指南 - 清理。

🤝 想要帮忙吗？

欢迎贡献！以下是您可以提供帮助的方式：

• 报告问题 或者在仓库中提交 bug。

• 改进现有的代码示例或添加新的示例，fork 本仓库并提出一些更改！

• 建议增加新课程或改进现有内容。

• 您有建议或者发现了拼写或代码错误？创建一个 Pull Request

详情请查看 CONTRIBUTING.MD 文件以了解如何参与。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🌐 其他课程

我们有许多其他内容可以帮助您的学习之旅。请查看：

生成式 AI 系列 (Generative AI Series)

---

核心学习

获取帮助

如果您遇到困难或对构建 AI 应用有任何疑问，请加入：

如果您对产品有反馈或在构建过程中遇到错误，请访问：

Generative AI for Beginners .NET 快速上手指南

本指南帮助中国开发者快速上手使用 Generative-AI-for-beginners-dotnet 工具库。

---

环境准备

在开始之前，请确保满足以下要求：

1. GitHub 账号：需要一个免费的 GitHub 账号。注册 GitHub
2. .NET 开发环境：具备基本的 .NET 开发知识。了解 .NET
3. Azure 账号：需要一个 Azure 免费账户。创建 Azure 免费账户
4. Azure Developer CLI (azd)：安装 Azure Developer CLI。安装 azd
5. GitHub Codespaces：启用 GitHub Codespaces 以获得预配置开发环境。了解 GitHub Codespaces

如果您在中国大陆，建议使用 Azure 中国区服务 或本地模型（如 Ollama）以加速开发。

---

安装步骤

1. Fork 项目仓库

点击页面顶部的 Fork 按钮，将项目仓库复制到您的 GitHub 账户中：

https://github.com/microsoft/Generative-AI-for-beginners-dotnet/fork

2. 使用 GitHub Codespaces（推荐）

直接在浏览器中启动预配置的开发环境：

1. 打开您的 Fork 仓库。
2. 点击 Code 按钮，选择 Open with Codespaces。

3. 本地环境配置（可选）

如果您更倾向于本地开发，请按照以下步骤操作：

克隆仓库

git clone https://github.com/<your-username>/Generative-AI-for-beginners-dotnet.git
cd Generative-AI-for-beginners-dotnet

自动化 Azure 配置（推荐）

运行以下脚本以自动部署 Azure 资源并配置环境：

# 导航到仓库根目录
cd Generative-AI-for-beginners-dotnet

# 运行自动化设置脚本
./setup.ps1

此脚本将完成以下任务：

• 部署 Azure OpenAI 资源（如 gpt-5-mini 和 text-embedding-3-small）
• 创建必要的存储和服务
• 自动配置 .NET 用户密钥
• 显示您的 Azure OpenAI 终端和凭据

手动配置 Azure（可选）

如果您已有 Azure OpenAI 资源，可以手动配置用户密钥：

# 设置共享密钥（所有示例通用）
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:Endpoint" "https://<your-region>.openai.azure.com/"
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:Deployment" "gpt-5-mini"
dotnet user-secrets set --id genai-beginners-dotnet "AzureOpenAI:EmbeddingDeployment" "text-embedding-3-small"

---

基本使用

以下是最简单的使用示例，展示如何运行一个基础聊天应用。

运行示例代码

1. 导航到示例目录：

   cd samples/CoreSamples/BasicChat-01MEAI
   

2. 运行应用程序：

   dotnet run app.cs
   

示例输出

运行后，您将看到一个简单的命令行界面，输入文本即可与 AI 模型交互。

---

清理资源

完成学习后，建议清理 Azure 资源以避免产生额外费用：

./cleanup.ps1

此脚本将：

• 删除所有 Azure 资源
• 清理本地配置
• 移除用户密钥

---

通过以上步骤，您可以快速上手 Generative-AI-for-beginners-dotnet 并开始构建生成式 AI 应用！