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），以最佳化效能與安全性。