Amazon Bedrock Workshop 版本演进与模块重构实录：从 RELEASE_NOTES 看 2024-2025 的迭代路线

示例工程【免费下载链接】amazon-bedrock-workshopThis is a workshop designed for Amazon Bedrock a foundational model service.项目地址https://gitcode.com/GitHub_Trending/am/amazon-bedrock-workshop点击查看免费下载本指南以 RELEASE_NOTES.md 为骨架梳理 Amazon Bedrock Workshop 从 2024 年初到 2025 年中的版本演进历程并对照当前仓库的实际结构逐条印证发布说明中的每一行变更在代码与 Notebook 中的落点。读完本文你将掌握该 Workshop 各模块文本生成、Knowledge Bases/RAG、模型定制、Agents、分布式推理引擎的迭代脉络、为何 Converse API 与跨区域推理CRIS成为模块 1 的核心以及模型选型、环境迁移Classic Notebook → JupyterLab和自动化测试机制背后的工程决策。一、版本时间线与演进主线RELEASE_NOTES.md 以倒序方式记录了若干关键发布节点按时间正序可整理为下表时间版本主题核心动作2024-02-10结构大调整建立工作分支BR-workshop-v2启动 Major structural changes2024-02-15基础化改造移除bedrock utils文件夹依赖Notebook 全部改用默认 boto3bedrock/bedrock-runtimeLangChain、NeMo 等开源示例迁出独立目录提出补充 Fine-tuning 示例的需求2024-05-10模型选型调整改写 pre-req NotebookTitan Text Premier、Titan Embeddings v2、Claude Haiku v2 验证通过重构01_Text_generation下 00-04 号 Notebook 的模型分配2024-05-20稳定性回退文本生成回退到 Titan LargeRAG 基础测试回退到 Claude 2.1修复 utility 文件每 30 秒打印 Done! 的问题修复 RAG 目录中的%store等问题2024-08-08运行环境迁移Workshop 迁移到 SageMaker Studio 的新 JupyterLab发布短链接启用每周自动化测试保证所有 Lab 可运行2024-01-05新能力补齐新增 Nova Canvas Notebook、Nova Reel Notebook、inline agents2025-04-15全面重构最新移除 Module 0prerequisites全量重构 Module 1更新模型、markdown 说明、新增 Converse API / CRIS / function calling 等主题重构 Module 2 并重命名 Notebook刷新 Module 4刷新 Module 5Notebook 重命名/重排序两条主线贯穿始终一是模型与 API 的升级换代从 Invoke Model API 到 Converse API从单区域到跨区域推理二是运行环境的工程化去掉自定义 utils、迁入 JupyterLab、引入自动化回归测试。二、2025-04-15最新一次全面重构的源码印证2025-04-15 的发布说明是当前仓库形态的直接来源逐条对照仓库可见其实质落地情况。2.1 移除 Module 0prerequisites当前仓库根目录下已不存在独立的 Module 0 目录前置条件信息被收敛到 README.md 的 Getting started 一节SageMaker Studio JupyterLab 空间、CloudFormation 模板、IAM 权限bedrock:*为最低要求、模型访问说明。这与remove module 0 (prerequisites)的发布条目完全一致——前置内容从独立 Lab降级为文档说明。2.2 Module 1 全量重构Converse API 成为主角发布说明点名的新主题Converse API、CRIS、function calling在 01_Text_generation/01_text_and_code_generation_w_bedrock.ipynb 中均有完整实现Converse API 与 Invoke API 对比Notebook 先演示bedrock.invoke_model构造 Claude 专属的anthropic_version请求体再改用bedrock.converse传递统一的messages/inferenceConfig说明写一次代码可用于不同模型的设计动机。Converse API 请求结构Notebook 给出了带注释的完整 JSON 骨架包含modelId必填、messages必填含role与content、system可选系统指令、inferenceConfigtemperature0.0-1.0、topP0.0-1.0、maxTokens、stopSequences、toolConfigtoolstoolChoice.auto可直接复制使用。跨区域推理CRISNotebook 的模型字典直接使用了带前缀的推理配置文件 ID例如us.anthropic.claude-haiku-4-5-20251001-v1:0美国区域与global.anthropic.claude-haiku-4-5-20251001-v1:0全球并明确注释Claude Haiku 4.5 等新模型必须使用推理配置文件不支持无前缀的直接调用。代码中通过global. MODELS[Claude Haiku 4.5][3:]动态替换前缀同一份请求即可对比us.与global.两种路由的差异。Function Calling 全流程Notebook 定义get_weather工具toolSpecinputSchema.jsonrequired: [location]随后用handle_function_calling函数演示完整闭环识别toolUse→ 应用执行函数 → 以assistant角色的toolUse块和user角色的toolResult块回填对话 → 再次converse生成最终回复。代码明确区分了模型只负责决策、由应用负责执行的边界。2.3 Module 2 重构与 Notebook 重命名发布说明中的 rename notebooks 在当前 02_Knowledge_Bases_and_RAG 目录直接可见1_create-kb-and-ingest-documents.ipynb、2_managed-rag-with-retrieve-and-generate-api.ipynb、3_customized-rag-with-retrieve-api.ipynb、4_clean-up.ipynb编号即执行顺序README 也明确要求按命名顺序执行 Notebook。其中 1_create-kb-and-ingest-documents.ipynb 覆盖了 S3 数据源、OpenSearch Serverless 向量索引、Bedrock Knowledge Base 创建与文档摄取并给出了 SageMaker 执行角色所需的完整 IAM 策略清单IAMFullAccess、AWSLambda_FullAccess、AmazonS3FullAccess、AmazonBedrockFullAccess及自定义aoss:*策略。2.4 Module 4 与 Module 5 刷新04_Agents 当前以 05_agents.ipynb 为核心 Lab配套prereqsDynamoDB、Knowledge Base、prereqs_config.yaml与utilsAgentCore 内联策略、deploy_prereqs.sh体现markdown formatting 更新后更完整的预置部署说明。05_Distributed_Inference_Engine 目录下的 mantle_workshop_notebook.ipynb 即发布说明中notebook renaming / re-ordering的成果README 列出 9 个章节Setup Auth、Discover Models、Chat Completions、Responses API、Tool Use、Structured Output、Background Mode、Guardrails、Projects APIREADME 同时给出pip install openai requests boto3 aws-bedrock-token-generator与OPENAI_BASE_URL/OPENAI_API_KEY环境变量配置。三、2024 年的关键节点从稳定性回退到环境迁移3.1 模型选型的反复与回退2024-052024-05-10 的调整方向是升级pre-req Notebook 验证了 Titan Text Premier、Titan Embeddings v2、Claude Haiku v2文本生成模块改为混合使用 Claude 与 TTP。但 05-20 又出现了明显回退文本生成回退到 Titan Large原因是 03 号 Notebook 需要模型对不确定问题给出不确定的回答Titan Large 更符合演示预期、RAG 基础测试回退到 Claude 2.1。这一进一退说明Workshop 的模型选型优先服务于教学效果与确定性而非一味追新——这与模块 1 中temperature 设为 0.0 以获得确定性输出的做法一脉相承。3.2 基础化改造去掉 bedrock utils2024-02-15该版本将此前依赖自定义bedrock utils文件夹的做法彻底移除All notebooks now just use default boto3 bedrock/bedrock-runtime。当前 02_Knowledge_Bases_and_RAG/utility.py 仍是目录内唯一工具文件05-20 的发布说明曾提到修复其每 30 秒打印 Done! 的问题改为仅输出进度点而各 Notebook 的导入基本收敛为boto3botocore.exceptions.ClientError印证了降低学习门槛、贴近原生 SDK的方向。3.3 运行环境迁移与自动化测试2024-08-08Workshop 从 SageMaker Classic Studio Notebook 迁移到新 JupyterLab当前 README.md 的 Prerequisites 一节正是这一决定的延续。引入每周自动化测试保证所有 Lab 可运行这是 Workshop 类仓库从一次性讲义走向可回归的工程资产的关键一步配合短链接方便分享降低了参会者的进入成本。3.4 多模态与多模型覆盖2024-01-05发布说明记录的 Nova Canvas Notebook、Nova Reel Notebook 与 inline agents对应当前 03_Model_customization 的丰富结构bedrock-fine-tuningTitan Image Generator、Claude Haiku、Meta Llama、Nova Canvas/understanding、bedrock-reinforcement-fine-tuningNova、Qwen、GPT-OSS 的 RFT 示例含 reward-functions 目录下的gsm8k_rew_func.py等、model_distillation含 S3 输入蒸馏与历史调用蒸馏、on_demand_inferenceNova Micro。需注意 03_Model_customization/README.md 的明确提示模型定制任务因配额限制无法在 AWS 托管的活动账号中运行AWS 活动参与者应将其作为参考实操需使用自有账号。四、版本演进背后的工程原则综合 RELEASE_NOTES.md 与仓库现状可以总结出该 Workshop 持续迭代的四条原则教学优先于炫技模型回退、temperature0、为演示刻意保留不确定回答均以教学预期为准绳。统一 API 优先Converse API 因其跨模型一致的请求结构成为模块 1 主线Invoke API 仅作为入门对照保留降低多模型切换成本。环境标准化从移除自定义 utils、迁入 JupyterLab到 CloudFormation 一键部署 README.md 中描述的 SageMaker Studio 域与 JupyterLab 空间再到每周自动化测试都是让学员把时间花在学习而非环境调试的工程化努力。能力持续扩展从纯文本生成到 Nova 多模态、Reinforcement Fine-Tuning、蒸馏、AgentCore、分布式推理引擎Project Mantle模块覆盖始终跟随 Amazon Bedrock 服务能力的前沿。五、结语RELEASE_NOTES 不仅是变更日志更是一份浓缩的架构决策记录它展示了如何在一个面向开发者的动手 Workshop 中平衡模型新特性、教学稳定性与工程可维护性。对读者而言若想快速理解当前仓库的模块边界与设计动机从 RELEASE_NOTES.md 的 2025-04-15 条目出发按模块对照 01_Text_generation、02_Knowledge_Bases_and_RAG、03_Model_customization、04_Agents、05_Distributed_Inference_Engine 五条目录逐层下钻是最高效的阅读路径而依赖安装则统一以仓库根目录的 pyproject.toml 为准Notebook 中通过%pip install -e ..或%pip install -e ..[lab2]安装对应模块的附加依赖。赞分享示例工程【免费下载链接】amazon-bedrock-workshopThis is a workshop designed for Amazon Bedrock a foundational model service.项目地址https://gitcode.com/GitHub_Trending/am/amazon-bedrock-workshop点击查看免费下载相关推荐Pencil Project终极指南零基础快速掌握免费开源UI设计工具Pencil Project终极指南零基础快速掌握免费开源UI设计工具 你是否曾经为昂贵的原型设计工具而苦恼或者因为复杂的界面而放弃学习新的设计软件今天桌面应用alt-tab-macos 版本演进全解从 changelog 看 macOS 窗口切换器的架构迭代与技术路线alt tab macos 版本演进全解从 changelog 看 macOS 窗口切换器的架构迭代与技术路线 本篇技术指南以仓库根目录的 changelog桌面应用Tabby IntelliJ 插件版本演进全解析从 CHANGELOG 看 AI 编程助手的迭代路线Tabby IntelliJ 插件版本演进全解析从 CHANGELOG 看 AI 编程助手的迭代路线 导读 本文以仓库中 clients/intellij/人工智能大模型本地部署模型推理服务后端RAG交互助手上一篇fwupd安全机制详解确保固件更新的完整性与可靠性下一篇Soundflower跨平台音频路由工具的技术魅力创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考