OpenAI Agents SDK

Stars

面向生产级 Agent 应用的轻量编排框架,统一 Agent、Tool、Handoff、Guardrail、Tracing 与 MCP 接入,支持构建可观测的多 Agent 工作流。

Agents · Tools · HandoffsTracingMCP
AGENT GRAPH · IDENTITY MODEL

同名,不应该意味着同一个实体

显示名称用于阅读,稳定身份用于建图。把两者拆开,图才能忠实表达真实工作流。

BEFORE · LABEL AS ID
Agent · searchTool · search
search
错误合并 / 自环
AFTER · IDENTITY + LABEL
agent_01label: searchtool_02label: search
两个实体,两个稳定 ID
错误现象

节点被合并,边变成自环

同名 Agent、Tool 与 MCP Server 以显示名为键,导致 Graphviz 合并节点或产生伪自环。

建模判断

Label 只能负责可读性

显示名称服务于阅读,但不能承担实体身份;图遍历、节点注册和边生成需要共享稳定的唯一标识,同时保留原始名称作为可读标签。

身份重构

实体 ID 贯穿遍历与建边

以对象身份注册节点,把显示名降为 label,并重构遍历与边生成链路,确保不同类型或不同实例即使同名也不会被错误合并。

图的语义

可视化重新对应真实工作流

生成的工作流图能够真实表达实体关系,避免错误节点、漏边和伪自环影响调试与架构理解。

OpenAI Agents SDK 官方编排与追踪界面
这张编排图集中展示 Agent、工具调用、Handoff 与追踪关系,使多智能体工作流中的控制流、任务交接和可观测链路能够被快速理解与定位。