آپدیت Python SDK کدکس 0.154؛ نصب و قابلیت‌ها

4 دقیقه مطالعه

11 September 2026

نصب Python SDK کدکس ۰.۱۵۴ با pip و پیش‌نیازهای اجرای آن

برای نصب Python SDK کدکس نسخه ۰.۱۵۴، ابتدا باید Python 3.10 یا بالاتر روی سیستم شما نصب باشد. سپس در ترمینال این دستور را اجرا کنید:

pip install --upgrade openai-codex==0.154.0

این نصب، بسته اجرایی هماهنگ openai-codex-cli-bin==0.154.0 را نیز در اختیار محیط قرار می‌دهد. بهتر است پیش از نصب، یک محیط مجازی پایتون بسازید تا وابستگی‌های کدکس با پروژه‌های دیگر تداخل پیدا نکنند.

Python نسخه ۳.۱۰ یا بالاتر
pip به‌روز و دسترسی به ترمینال
CLI کدکس نسخه ۰.۱۵۱ یا جدیدتر برای قابلیت‌های تازه

پس از نصب، نسخه بسته را بررسی کنید و در صورت نیاز، راهنمای اتصال ابزارهای هوش مصنوعی در پایتون را برای آماده‌سازی پروژه ببینید. در زمان ارتقا، تنظیمات و وابستگی‌های محیط مجازی را نیز بررسی کنید؛ این کار عیب‌یابی خطاهای نصب و ناسازگاری نسخه‌ها را ساده‌تر می‌کند.

python -m pip show openai-codex

<پ>اگر از مسیر سفارشی برای Codex CLI استفاده می‌کنید، سازگاری آن با نسخه‌های جدید را پیش از فعال‌سازی قابلیت‌های تازه بررسی کنید. برای کاربرانی که رابط ساده‌تری می‌خواهند، گپ‌جی‌پی‌تی می‌تواند گزینه‌ای کاربردی برای استفاده روزمره از ابزارهای هوش مصنوعی باشد.

اجرای هم‌زمان و افزودن پیام خارجی در فراخوانی‌های sync و async

Python SDK کدکس ۰.۱۵۴ امکان کنترل منعطف‌تر گردش کارهای چندمرحله‌ای را در فراخوانی‌های هم‌زمان و غیرهم‌زمان فراهم می‌کند. توسعه‌دهندگان می‌توانند هنگام ساخت یا ادامه یک turn، پیام خارجی را وارد کرده و رویدادهای هر جریان را مستقل دریافت کنند.

این قابلیت برای اپلیکیشن‌هایی مفید است که باید هم‌زمان به ورودی کاربر، خروجی ابزارها و رخدادهای سرویس‌های دیگر واکنش نشان دهند؛ بدون آن‌که منطق نشست را از ابتدا بسازند.

ExternalMessage می‌تواند یک turn تازه را آغاز کند یا به turn فعال معمولی متصل شود.
فراخوانی‌های run() و turn() در حالت sync و async از پیام خارجی پشتیبانی می‌کنند.
هر مصرف‌کننده جریان رویداد مستقل خود را می‌گیرد؛ بنابراین نمایش وضعیت و ثبت لاگ دقیق‌تر می‌شود.

برای نمونه، فرض کنید یک سامانه پشتیبانی با کدکس پاسخ اولیه را تولید می‌کند، اما نتیجه جست‌وجوی پایگاه دانش یا پاسخ یک ابزار داخلی کمی بعد می‌رسد. با افزودن ExternalMessage، آن داده می‌تواند به گفت‌وگوی فعال وارد شود تا مدل پاسخ را با زمینه کامل‌تر ادامه دهد. این الگو در پردازش صف، گردش کار ایجنت‌ها و ابزارهای برنامه‌نویسی کاربرد دارد.

نکته مهم امنیتی این است که پیام خارجی فقط در سطح ابزار اعتبار دارد و به‌تنهایی مجوز کاربر ایجاد نمی‌کند؛ پس پیش از اجرای عملیات حساس، احراز هویت و سطح دسترسی را در برنامه خود بررسی کنید. برای پیاده‌سازی درخواست‌های غیرهم‌زمان در پایتون، راهنمای اتصال APIهای هوش مصنوعی با پایتون نیز می‌تواند مکمل خوبی باشد.

مدیریت تاریخچه نشست با resume، fork و include_turns

در کدکس ۰.۱۵۴، مدیریت تاریخچه نشست انعطاف‌پذیرتر شده است. گزینه‌های resume و fork به شما اجازه می‌دهند هنگام ادامه یا انشعاب یک نشست، مشخص کنید چه بخش‌هایی از سوابق ذخیره‌شده در پاسخ بازگردد؛ این انتخاب، پاسخ برگشتی را تغییر می‌دهد، نه زمینه‌ای را که مدل در اختیار دارد.

resume: ادامه کار از یک نشست ذخیره‌شده
fork: ساخت مسیر جداگانه بر اساس نشست قبلی
include_turns=True: افزودن نوبت‌های گفتگو به تاریخچه خوانده‌شده

برای خواندن تاریخچه کامل‌تر، می‌توانید از thread.read(include_turns=True) استفاده کنید. همچنین در عملیات resume یا fork، پارامتر include_turns تعیین می‌کند نوبت‌های گفتگو در داده بازگشتی نمایش داده شوند یا نه. بنابراین اگر فقط به فراداده یا نتیجه نهایی نیاز دارید، تاریخچه محدودتر کافی است؛ اما برای بازسازی روند یک کار یا بررسی تصمیم‌های قبلی، نمایش نوبت‌ها کاربرد بیشتری دارد.

این قابلیت برای پروژه‌هایی مناسب است که چند مسیر آزمایشی، گفت‌وگوی طولانی یا گردش‌کار قابل بازگشت دارند. پیش از استفاده، توجه کنید انتخاب تاریخچه روی محتوای پاسخ اثر می‌گذارد و ممکن است با خروجی مورد انتظار شما یکسان نباشد. برای آشنایی بیشتر با ابزارهای توسعه هوش مصنوعی، راهنمای به‌روزرسانی Codex CLI را نیز ببینید.

نکات مهاجرت به کدکس ۰.۱۵۴ و سازگاری نسخه CLI

مهاجرت به Python SDK کدکس ۰.۱۵۴ فقط با ارتقای بسته پایتون تمام نمی‌شود؛ نسخه CLI و کدهای مصرف‌کننده رویدادها نیز باید هماهنگ باشند. در زمان ارتقا، به‌ویژه اگر مسیر اجرای Codex را سفارشی کرده‌اید، سازگاری آن را با CLI نسخه ۰.۱۵۱ یا بالاتر بررسی کنید.

دسترسی‌های قدیمی مانند hook.command را به hook.root.command تغییر دهید.
پیش از خواندن فیلدهای وابسته به نوع هوک، مقدار hook.root.handler_type را بررسی کنید.
در اعلان‌ها، فیلدهای نام‌گذاری‌شده را بخوانید و به‌جای params از payloadهای نوع‌دار استفاده کنید.

نسخه جدید برخی اعلان‌هایی را که قبلاً ناشناخته بودند، با payloadهای مشخص ارائه می‌کند؛ بااین‌حال داده‌های نامعتبر همچنان ممکن است در قالب UnknownNotification برسند. همچنین handleهایی که دیر به یک turn متصل می‌شوند، رویدادهای قبل از نقطه اتصال را بازپخش نمی‌کنند؛ بنابراین خروجی جمع‌آوری‌شده می‌تواند ناقص باشد و اتصال پس از پایان turn احتمالاً خطای TransportClosedError ایجاد می‌کند.

برای حفظ تاریخچه ذخیره‌شده، هنگام خواندن thread از include_turns=True استفاده کنید و تفاوت بین تاریخچه بازگردانده‌شده و context مدل را در تست‌ها در نظر بگیرید. یک محیط آزمایشی، بررسی لاگ‌ها و اجرای تست‌های sync و async پیش از انتشار، ریسک مهاجرت را کاهش می‌دهد. برای اجرای ساده‌تر گردش‌کارهای هوش مصنوعی نیز می‌توانید از رابط کاربرپسند و چندمنظوره گپ‌جی‌پی‌تی کمک بگیرید.