用途:面向 openai-agents(Python)而非 TypeScript SDK 的开发技能,覆盖智能体、多智能体 handoffs、function tools、guardrails、sessions、streaming 与 tracing。
主要能力与用法:实现前先解析已安装包及其 provider 集成,当前 SDK 文档与匹配源码标签优先于静态示例。模型需从当前 OpenAI 模型目录与选型指南中选择,并核对其工具、推理设置与 provider 可用性。wheel 不含文档,离线可读已安装源码:版本用 importlib.metadata.version("openai-agents"),公开导出看 agents/init.py,文档源为仓库标签 v<version> 下的 docs/。
核心形态:Runner.run_sync 在运行中的事件循环内会抛错,应使用 await Runner.run(...);Runner.run_streamed(...) 本身不 await,需消费其 stream_events() 异步迭代器至完成。示例经 openai-agents 0.22.3 核对,其他版本需在已安装源码中确认名称。示例使用 Responses(SDK 默认 API)。
集成决策:除非任务需要,保留项目现有 provider、模型与存储;在 provider 配置或实时文档中核实模型 ID 与能力;产品关键选择显式配置。原生 provider/client 支持适用时优先;LiteLLM/Any-LLM 为可选集成。专家接管用 handoffs,管理者在委派后继续用 agent.as_tool();固定流水线无需额外智能体。副作用须在工具内授权,指令、输出 schema 与护栏不能替代授权或幂等。向不可信客户端暴露多轮智能体前,先确定历史归属、审批/恢复与追踪数据策略。
验证:检查变更的工具、多轮历史、审批/拒绝与失败恢复;用已安装的 agents.testing(0.22.3 已验证)离线编排,配合 RunConfig(tracing_disabled=True)。运行项目检查,并将缺少 provider 访问与已验证 SDK 行为分开报告。
限制:模型可用性与实时响应未经离线 SDK 检查测试;SDK 模型/设置默认值可能变化。