openai-agent-sdk-skill

openai-agent-sdk-skill 为使用 TypeScript 和 JavaScript 环境中的 OpenAI Agents SDK 开发智能应用程序的开发者提供了一个全面的框架。此技能旨在协助软件工程师和 AI 开发者编排复杂的代理工作流、多代理协作以及反应式语音接口。无论您是开发内部研究机器人、客户支持分流系统还是自动化程序工具，此技能都能提供必要的模板和结构化指导，协助您高效入门。它强调使用 Zod 等现代标准进行模式验证，并提供直接的整合模式，涵盖 MCP（模型上下文协议）、流式输出以及专业代理之间复杂的移交机制等先进功能。

• 提供从创建、配置到部署 OpenAI Agents 的全生命周期支持。

• 内置工具定义支持，包括函数工具、上下文感知工具以及如网页搜索、文件搜索和电脑使用等托管工具。

• 针对多代理系统的进阶编排模式，具备带有输入过滤和工具覆盖功能的移交逻辑。

• 使用 Zod 模式实现结构化输出生成的指导，确保响应的类型安全。

• 提供关于输入和输出防护栏的实践指导，以维护生产环境中的可靠性和安全性。

• 支持先进的代理功能，包括实时语音交互以及与向量数据库整合的 RAG 工作流。

• 启动新项目时，请遵循提供的基于 npm 的初始化和依赖管理 CLI 设置。

• 请务必优先使用配置指南中建议的模型 (gpt-5-nano)。

• 在开发期间使用代理属性表来正确配置名称、指令和模型设置。

• 利用移交功能在专业代理之间路由复杂请求，以保持职责的清晰分离。

• 确保结构化输出严格使用 Zod 定义，以防止下游组件中的运行时序列化错误。

• 实现工具时，请区分本地函数执行与托管服务型工具（如 webSearchTool 或 codeInterpreterTool），以优化性能与安全性。