第2章 · 核心架构与组件

第 2 章 · 核心架构与组件

章节摘要：跑通之后，拆开看内部。本章逐个讲透五大核心组件：架构总览（组件如何协同）、Agent（智能体如何定义）、Runner（运行器如何执行）、模型集成（怎么接模型）、工具（能力如何扩展）。学完本章，你能独立设计一个智能体应用。

阅读收获

阅读完本章，你应当能够：

1. 画出 SDK 的架构总览
2. 熟练配置 Agent
3. 理解 Runner 的执行机制
4. 接入与管理模型
5. 设计工具扩展能力

核心概念速览

一句话记住本章：架构是"定义 + 执行"的两层结构——Agent 定义"做什么"，Runner 执行"怎么做"，模型与工具是两边的耗材。

核心架构总览

子章节导航

2.1 架构设计总览

组件地图与数据流：一次请求如何走完整个系统。先看地图再学局部。

2.2 智能体 Agent 核心

Agent 的配置项：指令、工具、模型、动态行为。这是"行为质量"的源头。

2.3 运行器 Runner 机制

Runner 的执行流程、运行模式与结果处理。理解它，才算真正会用 SDK。

2.4 模型集成与管理

默认模型、自定义模型、多模型管理。模型选型直接关系成本与效果。

2.5 工具与能力扩展

工具类型、工具集、错误处理与动态工具。工具让智能体从"会说"变"会做"。

子章节之间的逻辑关系

总览(2.1) → Agent(2.2) → Runner(2.3) → 模型(2.4) → 工具(2.5)
   地图          定义          执行          引擎        手脚
​

先看地图，再逐个拆组件，最后理解"手脚"如何扩展。五个组件中，Agent 与 Runner 是一对"定义与执行"，模型与工具是它们依赖的两类外部资源。

本章实践任务

学完本章，建议完成一个"组合实验"：用 2.2 的 Agent 配置方式，把第 1 章跑通的示例升级成"带两个工具、指定模型、带温度参数"的完整配置；再分别用同步、异步、流式三种模式运行它，观察结果对象在不同模式下的差异。最后画一张自己的架构草图，标注每个组件在哪一层。做完这些，五个组件就不是"五个概念"，而是"五个你用过的工具"。

前置知识与后续延伸

• 前置：第 1 章的核心概念与入门示例
• 为后续铺垫：本章组件是第 3 章高级特性（追踪、协作、守护）的载体——Tracing 记录的就是 Runner 的执行过程，Handoffs 交接的就是 Agent，Guardrails 守护的也是 Agent 的输入输出