项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- GitHub 账号(用于 Fork 仓库和创建 Codespace)
- Node.js LTS(仓库根目录包和 companion app 需要)
- Microsoft Foundry 项目并部署一个聊天模型
- 可用的模型 endpoint 和 API key
安装与启动步骤
-
1Fork 仓库
在 GitHub 仓库右上角点击 Fork,复制到自己的账号,便于运行和修改示例代码。
-
2创建 Codespace
在 Fork 后的仓库点击 Code,进入 Codespaces 标签,选择 Create codespace 创建在线环境。
-
3阅读设置指南
按 README 指引打开 docs/setup/README.md,完成课程环境配置。
-
4创建 Foundry 项目
在 Microsoft Foundry 中创建项目,并部署一个聊天模型供示例调用。
-
5配置端点与密钥
在仓库根目录的 .env 中填写模型 endpoint 和 API key,本地与 Codespaces 都需要配置。
-
6运行 companion app
参考 app/README.md 在本地运行应用,或继续使用 Codespaces 在线运行。
-
7完成实时检查
按设置指南做一次 companion app 实时检查,确认能正常调用聊天模型。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
endpoint | 是 | 模型服务端点,写入仓库根目录 .env。 | https://your-endpoint.example.com |
API key | 是 | 访问已部署聊天模型的密钥,写入仓库根目录 .env。 | sk-xxxxxxxx |
如何确认成功
按设置指南完成 companion app 实时检查,能正常调用聊天模型即表示配置成功。
常见问题
Q:必须使用 GitHub Codespaces 吗?
A:不是。README 说明也可在本地运行代码示例,但本地和 Codespaces 都需要完成模型配置。
Q:需要自己准备模型吗?
A:需要。按设置指南创建 Microsoft Foundry 项目、部署聊天模型,并配置 endpoint 和 API key。
Q:每节课依赖都一样吗?
A:不一定。README 说明每个 lesson package 有自己的依赖要求,需分别查看对应课程说明。
Q:没有 API key 能运行吗?
A:不能正常调用聊天模型。需先按课程设置指南完成 Foundry 项目和聊天模型部署。
注意事项
- 仓库根目录包和 companion app 需要 Node.js LTS。
- 本地开发和 Codespaces 都需要模型配置。
- README 未给出具体安装命令,请以 docs/setup/README.md 和 app/README.md 为准。
- 各 lesson package 的依赖要求可能不同,运行前查看对应课程目录。
核心亮点
- 用故事化任务串联知识点,比纯文档教程更有代入感,适合零基础起步
- 示例以 JavaScript 为主,前端/Node 开发者无需切换语言即可跑通 AI 应用
- 内容覆盖生成式 AI 基础到对话应用,并配套样例代码,可直接改造成自己的练习
不足之处
- 课程内容深度有限,偏入门体验,进阶的工程化与生产实践覆盖不足
- 示例依赖外部模型服务,学习者需自行准备 API 密钥,开箱即用性受影响
适用场景
- 前端开发者想快速了解如何用 JavaScript 调用大模型并做对话应用
- 高校或培训机构用作生成式 AI 入门工作坊的动手教材
- 个人开发者通过改示例代码,快速搭建自己的 AI 小项目原型
替代项目
microsoft/generative-ai-for-beginners、openai/openai-cookbook
同类项目推荐
learn-from-materials
开源
把PDF和论文变成能做题、能做笔记的学习网页
Turn PDFs, books and papers into interactive learning webpages|将复杂材料转化为可追···
awesome-awesome-ai
开源
一站式导航AI资源,告别收藏夹吃灰
An awesome list for collecting awesome lists related to AI.
groundhog
开源
拆解 Cursor 原理,手把手教你造 AI 编程助手
Groundhog's primary purpose is to teach people how Cursor and all these other coding···
machine-learning
开源
免费学AI,从入门到实战,社区共建资源库
Learn AI together, for free. AI learning and teaching resources for everyone.
