Agents SDK لایهٔ کد-محور OpenAI برای ساخت agentهای چندمرحلهای است؛ وقتی یک پاسخ کافی نیست و orchestration مهم میشود.
اکوسیستم OpenAI
Agents SDK
Agents SDK برای ساخت agentهایی است که با tool، context و handoff کار میکنند و trace کامل از اجرای خود دارند.
Toolkit رسمی برای orchestration، handoff و trace
خلاصه عملی
تعریف و شروع
شروع سریع
از quickstart رسمی شروع کن، یک agent ساده بساز و بعد handoff و ابزارها را اضافه کن.
- SDK رسمی
- یک task واقعی
- دسترسی به docs رسمی
اول یک agent تکگامی با یک tool بساز و trace را ببین؛ بعد اگر جریان پیچیدهتر بود handoff و guardrail را اضافه کن.
قابلیتها
قابلیتهای اصلی
agent
تعریف رفتار و نقش agent.
tool
وصلکردن agent به ابزارها و actionها.
handoff
واگذاری task بین agentها یا مراحل.
guardrail / tracing
کنترل و مشاهدهٔ اجرای agent.
تفاوت
این بخش را کی انتخاب کنیم
Agents SDK ↔ Responses API
Responses API لایهٔ اجراست؛ Agents SDK لایهٔ orchestration و handoff.
Agents SDK ↔ ChatGPT
ChatGPT surface آماده است؛ Agents SDK برای ساخت agentهای قابلردیابی.
Agents SDK ↔ Codex
Codex برای coding workflow است؛ Agents SDK برای هماهنگسازی taskهای چندمرحلهای.
شروع
نصب و شروع عملی
با یک agent ساده شروع کن
اولین قدم در Agents SDK ساخت یک agent تکگامی با یک tool ساده است.
- SDK رسمی
- یک task مشخص
- دسترسی به docs رسمی
اول یک agent ساده بساز، trace را ببین و بعد handoff یا چند agent را اضافه کن.
مثال
مثال واقعی
Agents SDK
Toolkit رسمی برای orchestration، handoff و trace
- وقتی task تو چندمرحلهای است و به handoff نیاز دارد.
- وقتی میخواهی اجرای agent را trace و debug کنی.
- وقتی Responses API بهتنهایی برای orchestration کافی نیست.
Agents SDK برای ساخت agentهایی است که با tool، context و handoff کار میکنند و trace کامل از اجرای خود دارند.
خطاهای رایج
اشتباهات رایج
مرز محصول و API را روشن نگه دار
این component یک لایه مشخص در اکوسیستم است، نه کل اکوسیستم.
اول یک workflow کوچک بساز
بهجای مسیرهای پیچیده، با یک task کوچک و واقعی شروع کن.
لینک رسمی را جایگزین implementation نکن
docs مرجع هستند، اما باید در محصول خودت هم تست شوند.
رسمی
لینکهای رسمی
اکوسیستم
اجزای مرتبط
منابع