第1章 · 概述与入门

第 1 章 · openai-agents-python 概述与基础

章节摘要：认识工具先于使用工具。本章讲清 openai-agents-python 是什么、为什么值得用（官方原生、组件化、可观测）、能用在哪些场景，并带你完成环境搭建、跑通第一个智能体——"你好，世界"式的起步。

阅读收获

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

1. 说出 SDK 的定位与核心概念
2. 列举它的关键优势
3. 判断适用场景
4. 完成环境搭建
5. 跑通第一个智能体

核心概念速览

一句话记住本章：官方 SDK = 智能体开发的"标准零件箱"——Agent 是工人，Tools 是工具，Runner 是调度台。

SDK 学习地图

子章节导航

1.1 核心概念与发展历程

Agent、Runner、Tools 三个核心概念，以及 SDK 的发展背景。重点理解"官方 SDK 把工具调用循环封装进运行器"这件事，它是整套框架的设计原点。

1.2 关键优势与应用场景

官方原生、组件化、可观测三大优势与典型场景。学完你能判断：自己的项目该不该用 SDK，还是直接调 API 就够。

1.3 环境搭建与快速入门

安装、配置、跑通第一个智能体，再逐步加工具、加多智能体，用三个递进示例建立体感。

子章节之间的逻辑关系

是什么(1.1) → 好在哪(1.2) → 怎么用(1.3)
   概念          价值          动手
​

三节从"概念"到"动手"，完成入门闭环。1.1 回答"它是什么"，1.2 回答"凭什么选它"，1.3 回答"怎么跑起来"。跳过任何一节，后面的章节都会缺一块拼图。

本章实践任务

读完本章，建议动手完成三件事：第一，在本地环境跑通 1.3 的第一个智能体，看到自己的第一段智能体输出；第二，给智能体加一个自定义工具（比如查天气），感受"工具调用循环被 Runner 接管"的差别；第三，把 1.1 的概念表抄成自己的笔记，并试着向同事讲一遍"Agent、Runner、Tools 分别是什么"。这三件事做完，本章的知识才算真正变成你的。

前置知识与后续延伸

• 前置：Python 基础；对大模型 API（Chat Completions）有概念即可
• 为后续铺垫：本章的核心概念是第 2 章架构详解的基础——1.1 的 Agent/Runner/Tools 会在第 2 章逐个展开成完整组件