Agents 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/agents/ 角度:Agent 定义、instructions、tools、handoffs、output_type 采用原因:适合支撑 SDK 的对象中心。
Agent orchestration 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/multi_agent/ 角度:agents as tools、handoffs、LLM orchestration、code orchestration 采用原因:适合支撑多 Agent 控制模式。
Tools 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/tools/ 角度:function tools、built-in tools、MCP、agents as tools 采用原因:适合支撑工具对象与子 agent 工具化。
Handoffs 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/handoffs/ 角度:delegation、active agent 切换 采用原因:适合支撑 handoff 作为一级对象。
Running agents 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/running_agents/ 角度:Runner.run、streaming、per-run controls、run loop 采用原因:适合支撑生命周期与 run loop。
Results 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/results/ 角度:RunResult、RunState、resumable state、to_input_list、to_state 采用原因:适合支撑结果与恢复对象。
Context management 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/context/ 角度:RunContextWrapper、依赖注入、local context vs LLM context、nested tool state 采用原因:适合支撑输入契约与运行上下文。
Guardrails 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/guardrails/ 角度:input/output guardrails、tool guardrails、tripwire 采用原因:适合支撑治理对象。
Human-in-the-loop 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/human_in_the_loop/ 角度:needs_approval、interruptions、RunState resume 采用原因:适合支撑审批与恢复机制。
Sessions 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/sessions/ 角度:session lifecycle、conversation history、session backends、compaction 采用原因:适合支撑会话状态对象。
Tracing 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/tracing/ 角度:trace、span、observability、group_id、sensitive data 采用原因:适合支撑观测对象。
Home 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/ 角度:少原语、Swarm 升级、SDK 总体定位 采用原因:适合支撑整个框架的总设计哲学。
Models 作者/机构:OpenAI Agents SDK 年份:2026 URL:https://openai.github.io/openai-agents-python/models/ 角度:provider-agnostic、Responses API、OpenAI-compatible providers 采用原因:适合支撑 SDK 与 OpenAI 生态之间“深集成但不封闭”的边界。
New tools for building agents 作者/机构:OpenAI 年份:2025 URL:https://openai.com/index/new-tools-for-building-agents/ 角度:Responses API、Agents SDK、built-in tools、observability 采用原因:适合支撑 SDK 的官方产品化定位。
A practical guide to building agents 作者/机构:OpenAI 年份:2025 URL:https://openai.com/business/guides-and-resources/a-practical-guide-to-building-ai-agents/ 角度:manager vs handoff、agent 系统设计建议 采用原因:适合支撑
agents as tools与handoff的适用边界。核心源码:agent.py / run.py 作者/机构:OpenAI Agents SDK 年份:2026 源码路径:
/tmp/openaiagents.4LGvPf/repo/src/agents/agent.py、/tmp/openaiagents.4LGvPf/repo/src/agents/run.py角度:Agent 对象、Runner.run 生命周期、AgentRunner 采用原因:适合支撑“runtime 对象被产品化”的实现证据。核心源码:run_state.py / result.py 作者/机构:OpenAI Agents SDK 年份:2026 源码路径:
/tmp/openaiagents.4LGvPf/repo/src/agents/run_state.py、/tmp/openaiagents.4LGvPf/repo/src/agents/result.py角度:RunState、RunResult、恢复、审批、序列化 采用原因:适合支撑Session与RunState的严格区分。核心源码:run_context.py / memory/session.py / guardrail.py 作者/机构:OpenAI Agents SDK 年份:2026 源码路径:
/tmp/openaiagents.4LGvPf/repo/src/agents/run_context.py、/tmp/openaiagents.4LGvPf/repo/src/agents/memory/session.py、/tmp/openaiagents.4LGvPf/repo/src/agents/guardrail.py角度:local context、session 协议、guardrail 对象边界 采用原因:适合支撑输入契约、会话层和治理层的分层。
附录 G:分章资料清单