三步跑通 Generative AI for Beginners：从环境配置到跑通第一个训练样本

三步跑通 Generative AI for Beginners从环境配置到跑通第一个训练样本【免费下载链接】generative-ai-for-beginners21 Lessons, Get Started Building with Generative AI项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginnersGenerative AI for Beginners 是微软 Cloud Advocates 开源的 21 课生成式 AI 课程覆盖 LLM 基础、提示工程、RAG、微调、AI Agent 等主题每课都配 Python 和 TypeScript 可运行示例。这份训练指南面向想系统上手 LLM 应用的开发者跟着做完你能交付一个配置好的开发环境、一份可用的 LLM 凭证以及至少一个跑通的生成式 AI 训练样本。环境配置与安装Python 3.10 起步最低要求只有一个Python ≥ 3.10pyproject.toml里写死的Node 只在跑 TypeScript 示例时需要。仓库带了 50 语言翻译全量 clone 体积不小推荐用 sparse checkout 跳过翻译目录git clone --filterblob:none --sparse https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners cd generative-ai-for-beginners git sparse-checkout set --no-cone /* !translations !translated_images依赖安装两条路。Python 侧pip install -r requirements.txt核心包是 openai、python-dotenv、tiktoken、azure-ai-inference。TypeScript 侧每个示例目录有独立的 package.json进目录执行npm install即可。想完全离线、不花 API 费也可以装 Foundry Local 或 Ollama 在本地跑开源模型课程第 19 课有实操。凭证准备.env 是这门课的数据集这门课不需要传统意义的训练数据集但每一课代码都依赖一份本地凭证文件.env作用等同数据集加载配置。仓库根目录有现成的.env.copy复制后填值cp .env.copy .env需要填的变量按供应商分组只填你用得到的那组就行OPENAI_API_KEY... AZURE_OPENAI_API_KEY... AZURE_OPENAI_ENDPOINThttps://resource.openai.azure.com AZURE_OPENAI_DEPLOYMENTgpt-4o-mini AZURE_OPENAI_EMBEDDINGS_DEPLOYMENTtext-embedding-3-small AZURE_INFERENCE_ENDPOINT... AZURE_INFERENCE_CREDENTIAL... HUGGING_FACE_API_KEY....env在 .gitignore 里凭证不会误提交。注意 GitHub Models 的GITHUB_TOKEN变量将在 2026 年 7 月底停用新账号直接用 Microsoft Foundry Models 替代。各供应商入口、费用差异详见仓库内00-course-setup/03-providers.md。第一次训练选对课程、跑通第一个样本仓库按00-course-setup到21-meta编号组织每课目录含 README讲解、python/notebook 与脚本、部分课还有 typescript/ 或 js-githubmodels/ 子目录。示例代码按供应商分前缀对号入座即可文件名前缀所需凭证说明aoaiAzure OpenAI endpoint key企业级场景需提前申请资源oaiOpenAI API key上手最快多模型可选githubmodelsFoundry Models endpoint key单 key 访问数百个模型免费额度可用hfHugging Face token开源模型运行方式VS Code 打开对应 .ipynb 选 Python kernel 执行或本地起 Jupyter 后浏览器里跑纯脚本直接python 文件名。TypeScript 示例先npm install再node app.js。第一次运行值得盯住的参数有四个文本生成模型官方推荐gpt-4o-mini便宜且响应快写入AZURE_OPENAI_DEPLOYMENT向量嵌入模型text-embedding-3-small搜索和 RAG 课08、15会用到API 版本AZURE_OPENAI_API_VERSION默认 2024-10-21是稳定 GA 版本不用动temperature控制输出随机性写作用法调高、事实问答调低04、05 课有专门练习看结果、再迭代评测与调优结果怎么验证三个层次lesson 自带的 solution notebook如08-building-search-applications/python/aoai-solution.ipynb可以和你的输出逐格对比shared/ 下的公共模块配套了 pytest 用例在根目录跑pytest即可确认环境没问题每课代码的 stdout 就是最直接的评测报告先看格式对不对再看内容质量。调优只有三件事值得先做固定变量temperature 和模型先锁死只改 prompt否则分不清是改提示有效还是模型波动同一 prompt 跑 3-5 次温度调高后输出稳定性会下降这是预期行为不是 bug结果不达预期时先改结构给角色设定、补上下文、加输出格式约束比换模型见效快出问题怎么办高频故障速查现象原因处理Codespace 容器构建卡住超 10 分钟构建资源排队Codespaces 菜单选 Rebuild Container终端报 python: command not found终端没挂上容器 shell点终端右上角 号选 bash 新建OpenAI 返回 401 Unauthorizedkey 错误或已过期重发 key 填回 .env确认没混用其他供应商的 key代码里 os.getenv 读出来是 None没跑 load_dotenv() 或 .env 不在工作目录确认 .env 在仓库根目录脚本开头有 load_dotenv()Notebook 提示 kernel 缺失没选内核Notebook 菜单选 Kernel → Python 3TypeScript 示例报找不到 openai 模块该课目录没装依赖进示例目录执行 npm install小结到这里Generative AI for Beginners 的训练闭环已经走通环境配好、凭证就位、第一个样本出结果。下一步建议从 06 文本生成开始做一个完整 Build 课程再按 08 搜索、11 Function Calling 的顺序扩展应用.env 里的凭证各课通用换课不用重新配置。【免费下载链接】generative-ai-for-beginners21 Lessons, Get Started Building with Generative AI项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考