نمای کلی
Agents API در نسخهٔ بتا در دسترس است. این API به توسعه‌دهندگان امکان می‌دهد برنامه‌هایی با یک عامل Codex بسازند که OpenAI آن را مدیریت می‌کند و می‌تواند کارها را در چند مرحله انجام دهد و در همان نشست ادامه دهد.
برنامهٔ شما کار، ابزارها و پیکربندی را فراهم می‌کند. OpenAI نشست عامل و هماهنگی بین مدل و ابزارهای آن را مدیریت می‌کند.
یک عامل چه کارهایی می‌تواند انجام دهد؟
بسته به ابزارها و محیط اجرا، یک عامل می‌تواند کد اجرا کند، فایل‌ها را ویرایش کند، از اتصال‌های MCP استفاده کند و برای برنامهٔ شما فایل تولید کند. می‌توانید دستورالعمل‌های بیشتری بفرستید یا کار دیگری را در همان نشست ادامه دهید.
برای آشنایی با قابلیت‌های پشتیبانی‌شده و دیدن نمونه‌ها، به معرفی کلی Agents API مراجعه کنید.
چگونه شروع کنم؟
در پروژهٔ خود در پلتفرم OpenAI، یک کلید API برای برنامه ایجاد کنید. مجوزهای
api.agents.readوapi.agents.writeرا برای نشست‌ها و همچنینapi.responses.writeرا برای درخواست‌های مدل اعطا کنید.برای پیکربندی عامل، ایجاد نشست و ارسال کار، مراحل راهنمای شروع سریع را دنبال کنید.
رویدادهای نشست را دنبال کنید تا پیشرفت و نتایج را بررسی کنید. اگر می‌خواهید کار را ادامه دهید، شناسهٔ نشست را ذخیره کنید.
کلید API خود را خارج از سندباکس عامل نگه دارید. درخواست‌ها به هدر OpenAI-Beta: agents=v1 نیاز دارند. کیت‌های توسعهٔ نرم‌افزار OpenAI این هدر را خودکار اضافه می‌کنند.
آیا عامل من به سندباکس نیاز دارد؟
محیطی را انتخاب کنید که مناسب کارتان باشد:
بدون محیط: عامل به پرسش‌ها پاسخ می‌دهد یا از ابزارهای خارجی استفاده می‌کند، بدون اینکه به فرمان‌های داخلی شل یا فایل‌های فضای کاری نیاز داشته باشد.
سندباکس میزبانی‌شده توسط OpenAI: عامل باید اسکریپت اجرا کند یا با فایل‌ها کار کند و شما می‌خواهید OpenAI سندباکس آن را مدیریت کند.
سندباکس خودمیزبان: به زیرساخت، نرم‌افزار یا شبکهٔ خصوصی خودتان نیاز دارید. برنامهٔ شما چرخهٔ عمر محیط را مدیریت می‌کند.
برای جزئیات پیکربندی، به معماری Agents API مراجعه کنید.
کجا می‌توانم یک نشست را بررسی کنم؟
بخش گزارش‌ها را در داشبورد پلتفرم باز کنید، عامل‌ها را انتخاب کنید و شناسهٔ نشست را جستجو کنید. می‌توانید نوبت‌ها، فراخوانی‌های ابزار و فعالیت زیرعامل‌ها را بررسی کنید.
راهنمای مشاهده‌پذیری نیز نحوهٔ بررسی میزان مصرف ثبت‌شدهٔ توکن را توضیح می‌دهد.
اگر جریان رویدادها قطع شود، چه باید کرد؟
پیش از تلاش مجدد، نشست موجود و موارد ذخیره‌شدهٔ آن را بازیابی کنید. این کار کمک می‌کند پیش از ارسال کارهای بیشتر، آنچه را رخ داده است بررسی کنید.
کامل شدن یک نوبت به این معنا نیست که همهٔ ابزارها با موفقیت اجرا شده‌اند. نتیجهٔ گزارش‌شده را بررسی کنید. اینکه نشست در حالت بیکار باشد، به‌تنهایی نشان نمی‌دهد که کار با موفقیت پایان یافته است.
هزینهٔ مصرف چگونه محاسبه می‌شود؟
هزینهٔ درخواست‌های مدل بر اساس تعرفه‌های API مدل انتخاب‌شده محاسبه می‌شود. هزینهٔ ابزارهای OpenAI و سندباکس‌های میزبانی‌شده توسط OpenAI بر اساس تعرفه‌های مربوط به ابزار و کانتینر محاسبه می‌شود.
برای اطلاع از تعرفه‌های فعلی، به قیمت‌گذاری API مراجعه کنید.
داده‌ها و فایل‌های نشست چگونه مدیریت می‌شوند؟
Agents API وضعیت نشست را نگه می‌دارد تا کار در نوبت‌های بعدی ادامه پیدا کند. وقتی دیگر به نشست‌ها و خروجی‌های منتشرشده نیازی ندارید، می‌توانید آن‌ها را حذف کنید. پیش از حذف یک نشست، فایل‌های موردنیازتان را ذخیره کنید.
Agents API در حال حاضر فقط از ایالات متحده به‌عنوان محل اقامت داده پشتیبانی می‌کند. این API از عدم ذخیره داده پشتیبانی نمی‌کند، حتی وقتی از سندباکس خودمیزبان استفاده می‌کنید. برای جزئیات کنترل‌های داده، به مستندات Agents API مراجعه کنید.