第八课：官方 Agents SDK（可选）

当前状态

本课需要真实 OPENAI_API_KEY，当前学习阶段已主动跳过。它不影响前七课和第九课。

源码：08-official-sdk.ts

没有密钥时运行：

npm run lesson:08

程序会安全提示并退出，不会发起真实请求。

本课作用

前七课已经亲手实现：

正在绘制流程图…

官方 SDK 的 run() 会接管这段循环：

const agent = new Agent({
  name: "天气助手",
  instructions: "回答天气问题时必须使用天气工具。",
  tools: [weather],
});

const result = await run(agent, "北京天气怎么样？");

为什么放在后面

如果一开始只学习 SDK 调用，很容易知道“怎么用”，却不知道内部发生了什么。

完成前七课后，再看官方 SDK 可以清楚对应：

• Agent：模型配置、指令和工具集合；
• tool()：工具名称、说明、参数结构和执行函数；
• run()：模型与工具之间的运行循环；
• history/session：对话记忆；
• approval/guardrail：安全控制；
• handoff/agent-as-tool：多 Agent 协作。

本课结论

SDK 是对已经学过的运行循环、工具协议、记忆和安全边界的正式封装。