Agents API برای ساخت عامل‌های اجرایی
Agents API دسترسی برنامه‌ها به مهارکننده کدکس را از طریق یک API مدیریت‌شده توسط OpenAI فراهم می‌کند. تغییر اصلی این است که مدیریت نشست، هماهنگ‌سازی، فشرده‌سازی کانتکست و بازیابی خطا بر عهده سرویس قرار می‌گیرد، درحالی‌که برنامه همچنان ابزارها و محیط اجرا را انتخاب می‌کند.
Agents API دسترسی برنامه‌ها به مهارکننده کدکس را از طریق یک API مدیریت‌شده توسط OpenAI فراهم می‌کند. تغییر اصلی این است که مدیریت نشست، هماهنگ‌سازی، فشرده‌سازی کانتکست و بازیابی خطا بر عهده سرویس قرار می‌گیرد، درحالی‌که برنامه همچنان ابزارها و محیط اجرا را انتخاب می‌کند.
کدکس حالا به یک لایه اجرایی قابل‌فراخوانی از داخل برنامه تبدیل می‌شود
Agents API برای برنامه‌هایی طراحی شده است که می‌خواهند عامل‌های مبتنی بر مهارکننده کدکس را از مسیر یک API اجرا کنند. عامل می‌تواند در سندباکس کد اجرا کند، فایل‌ها را تغییر دهد، به سرورهای MCP وصل شود و خروجی‌های قابل‌استفاده تولید کند. برنامه نیز ابزارهای موردنیاز و محیط اجرا را در اختیار عامل می‌گذارد؛ بنابراین مرز میان منطق محصول و زیرساخت اجرای عامل روشن‌تر می‌شود، اما کنترل کامل محیط همچنان بخشی از طراحی برنامه باقی می‌ماند. این معماری زمانی اهمیت بیشتری پیدا می‌کند که کار از یک درخواست کوتاه فراتر برود و به نشست‌های پایدار، رویدادهای قابل‌پیگیری و چند مرحله اجرای وابسته نیاز داشته باشد.
چهار مفهوم، مسیر اجرای کار را از تعریف عامل تا خروجی قابل‌پیگیری مشخص می‌کنند
Agents API بر چهار مفهوم اصلی بنا شده است: عامل، محیط، نشست، و رویدادها و آیتم‌ها. عامل شامل مدل، دستورها، ابزارها و سرورهای MCP است. محیط می‌تواند یک سندباکس یا رایانه در اختیار عامل بگذارد تا فایل‌ها را بخواند، مهارت‌ها را بارگذاری کند و فرمان‌ها را اجرا کند. نشست، نمونه‌ای پایدار از عامل است که در طول کار به ورودی پاسخ می‌دهد و وضعیت خود را میان نوبت‌ها حفظ می‌کند. برنامه می‌تواند خروجی را به‌صورت جریانی دریافت کند یا با وب‌هوک پیشرفت عامل را دنبال کند و بعداً وظیفه دیگری به همان نشست بفرستد. این وضعیت پایدار همچنین امکان حذف نشست‌ها و خروجی‌های منتشرشده را فراهم می‌کند و زمینه را برای مدیریت چرخه عمر کار آماده‌تر می‌سازد.
مهارکننده مدیریت‌شده، کارهای طولانی را با حافظه و تفویض ساختاریافته پیش می‌برد
مهارکننده کدکس مدیریت‌شده می‌تواند مهارت‌ها و دستورهای مرتبط را اعمال کند، کارهای قبلی را برای مدیریت پنجره کانتکست خلاصه کند و بخشی از کار را به عامل‌های فرعی بسپارد. در یک تنظیم نمونه، مدل gpt-6-astra، محیط self_hosted، مسیر کاری /workspace و سقف چهار عامل فرعی تعریف شده است؛ بااین‌حال این مقادیر، نمونه پیکربندی‌اند و به‌تنهایی تضمین‌کننده عملکرد یا ظرفیت عملیاتی مشخصی نیستند. اتصال MCP در نمونه از انتقال HTTP و نشانی ارائه‌شده توسط OpenAI استفاده می‌کند و شبکه سندباکس می‌تواند فعال، غیرفعال یا محدود باشد. همین انتخاب‌ها نشان می‌دهند که پیاده‌سازی یک عامل اجرایی فقط به انتخاب مدل مربوط نیست؛ ابزار، دسترسی شبکه، محل اجرا، وضعیت نشست و شیوه ردیابی رویدادها هم در رفتار نهایی نقش دارند.
هزینه و حاکمیت داده، پیش از هر پیاده‌سازی جدی باید روشن شوند
مصرف مدل بر اساس نرخ API همان مدل محاسبه می‌شود، ابزارهای OpenAI نرخ استاندارد دارند و سندباکس‌های میزبانی‌شده توسط OpenAI با نرخ استاندارد کانتینر محاسبه می‌شوند. اشتراک‌ها برای پرداخت API قابل‌استفاده نیستند؛ نکته‌ای که در واکنش‌های جامعه نیز به‌عنوان تفاوت مهم میان تجربه اشتراکی کدکس و مسیر API مطرح شده است. از سوی دیگر، Agents API فقط از داده‌مکانی در ایالات متحده پشتیبانی می‌کند و Zero Data Retention در آن فعال نیست؛ حتی استفاده از سندباکس خودمیزبان این محدودیت را تغییر نمی‌دهد. واکنش‌های جامعه بیشتر حول همین بده‌بستان‌ها شکل گرفته است: انعطاف API در برابر تجربه سندباکس SDK، نیاز به دیده‌شدن نوبت‌های برانگیخته‌شده از بیرون در برنامه کدکس، نگرانی درباره مصرف بالاتر سقف استفاده، و تردید نسبت به میزان اتکاپذیری دسترسی شبکه محدود. برخی نیز اجرای محلی عامل با سندباکس دوردست و امن را ترجیح داده‌اند و برخی دیگر در حال بررسی این هستند که در آینده تفاوت میان نقطه‌پایان مدل و مهارکننده عامل تا چه اندازه باقی می‌ماند. بنابراین برای کاربردهای سلامت، استفاده از این API باید پس از بررسی دقیق محل پردازش داده، سیاست نگهداری، مسیرهای دسترسی شبکه و هزینه هر نشست انجام شود؛ نکته‌ای که ارزش فنی قابلیت‌های اجرایی را از الزامات حاکمیتی آن جدا نمی‌کند.
مشخصات
- مدل نمونه: gpt-6-astra
- حداکثر هم‌زمانی نمونه: ۴ عامل فرعی
- محیط نمونه: self_hosted
- مسیر فضای کاری: /workspace
- انتقال MCP: HTTP
- داده‌مکانی: فقط ایالات متحده
- نگهداری صفر داده: پشتیبانی نمی‌شود
منابع
- OpenAI Developers — OpenAI
- Epho — Epho