developing-openai-agents-sdk-agents
使用 OpenAI Agents SDK 构建生产级智能体应用的完整指南与工具集。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：developing-openai-agents-sdk-agents。 它的用途是：使用 OpenAI Agents SDK 构建生产级智能体应用的完整指南与工具集。 完整的 Skill 内容见：https://321skill.com/skills/developing-openai-agents-sdk-agents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在用 OpenAI Agents SDK 开发一个客服机器人，需要让它在无法回答时自动转接给人工坐席，该怎么实现？” 它会引导你进入 `workflows/implement-handoff.md` 工作流，详细讲解如何设置智能体间的委托机制。或者，当你说“我的智能体调用工具时总出错，如何排查？”，它会建议你参考 `workflows/debug-agent.md` 和 `references/anti-patterns.md` 来定位常见问题。
介绍
这个 Skill 旨在解决开发者在构建基于 OpenAI Agents SDK 的智能体应用时，面临的架构设计、工具集成、多智能体编排、调试优化等系统性挑战。它不是一个简单的 API 速查手册，而是一套包含从零构建、功能增强到生产部署全流程的工程化指南。
Skill 以工作流（workflows）为核心组织内容，例如“构建新智能体”、“添加工具”、“实现智能体交接”、“调试智能体行为”等。每个工作流都提供了清晰的步骤、示例和验证标准。开发者可以根据当前开发阶段，选择对应的工作流按图索骥，高效完成开发任务。
它非常适合正在或计划使用 OpenAI Agents SDK 进行智能体开发的工程师，包括全栈开发、智能体开发、后端开发以及需要搭建复杂自动化流程的项目经理。无论是新手入门还是老手优化现有项目，都能从中找到结构化的指导。
使用建议是，先阅读 SKILL.md 了解核心原则，再根据具体任务进入对应的工作流。对于复杂项目，可结合 references/ 下的领域知识（如架构、反模式、测试策略）进行深度设计。注意，它侧重于 SDK 的应用开发方法论，而非底层模型原理或简单的 API 调用。
核心特点
与侧重于 API 速查的 `openai-agent-sdk-skill` 不同，本 Skill 是面向开发过程的、工作流驱动的工程指南，提供了从创建、调试、优化到部署智能体的完整路径和最佳实践。
注意事项
不适合仅需快速查询 OpenAI Agents SDK 某个 API 用法或简单示例的场景。
常见问题
如何从头开始创建一个新的智能体？
使用 workflows/build-new-agent.md 指南，遵循从定义目标、设置环境到编写核心逻辑的步骤。
智能体行为异常如何调试？
参考 workflows/debug-agent.md，其中提供了日志分析、上下文检查和工具调用追踪等方法。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/developing-openai-agents-sdk-agents/raw/index.md 读取 developing-openai-agents-sdk-agents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/developing-openai-agents-sdk-agents/raw/index.md（查看排版版本）