用途:面向使用 OpenAI Agents SDK(Python)构建生产级 AI 智能体的开发任务,提供可复用的工程约束与工作流,而非零散建议。适用场景包括客服分流、内部助手、深度研究、辩论/头脑风暴、并行探索与优化等。
主要能力:围绕六大核心原语展开——Agent(LLM 可配置封装,含 name、instructions、model、tools、handoffs、guardrails、output_type)、Runner(think→act→observe 循环,提供 run_sync 与异步 run,强调设置 max_turns 防止死循环)、Tools(@function_tool 将 Python 函数转为工具,SDK 自动读取名称、docstring 与类型注解;内置 WebSearchTool、FileSearchTool、CodeInterpreterTool;支持 agent.as_tool)、Handoff(完整控制权转移,与 as_tool 的委托-回收语义区分)、Guardrails(input_guardrail/output_guardrail,触发 tripwire 抛异常)、Tracing。还覆盖多智能体模式(集中式、层级式、去中心化、Swarm 并行)、动态与确定性编排、SQLiteSession 持久记忆与滑动窗口摘要。
使用方式:安装并配置密钥:pip install openai-agents,export OPENAI_API_KEY="sk-..."。先阅读 SKILL.md,再按需加载引用文件;遵循有序指引与决策规则,不孤立摘取片段。可通过 LitellmModel 接入 DeepSeek、Anthropic、Gemini、Llama 等 OpenAI 兼容模型。
限制与注意:反模式包括不设 max_turns、指令含糊、单智能体工具过多(建议 5–8 个)、写操作缺少人工审批、无会话管理与缺少错误处理;去中心化流程需手动轮询,SDK 不自动管理。产出需明确假设、风险与后续工作;文档本身未提供收费与价格信息。