进阶·6 分钟阅读·
OpenAI Agents SDK：从第一个 Agent 到工具调用
先用最小 Python 示例理解 Agent、Runner、工具和追踪，再决定是否继续做多 Agent、会话记忆或沙盒执行。
AgentOpenAIPython工具调用
完成后你将能够
- ✓创建并运行一个最小 Agent
- ✓为 Agent 增加一个边界清晰的函数工具
- ✓用追踪结果复盘一次工具调用和最终回答
步骤 1
先跑通最小 Agent
按照官方 quickstart 创建虚拟环境、安装 Agents SDK，并把 API Key 放在当前终端会话里。第一版只定义一个名称和 instructions 明确的 Agent，再用 Runner 执行一次普通问答。
这一步的目标不是马上做复杂自动化，而是确认三件事：模型可以被调用、最终输出能被程序拿到、失败时能看到清楚的报错。
步骤 2
只加一个可验证工具
选择一个输入输出都容易判断的函数作为工具，例如查询固定知识、计算金额或读取本地样例数据。把工具描述写具体，避免模型在不该调用时也调用。
运行时观察模型什么时候决定调用工具、传入什么参数、工具返回后如何组织回答。不要把多个外部 API 一次性接进去，否则很难定位问题。
步骤 3
用追踪复盘边界
完成第一次运行后查看 trace，重点看用户输入、工具调用、模型输出和错误处理是否符合预期。把失败样例也加入测试，例如参数缺失、工具返回空值或问题超出工具范围。
如果任务主要是对话和工具编排，继续学习 sessions、handoffs 和 guardrails；如果任务要读写真实文件或运行命令，再进入 sandbox agents。