چرا APIهای سختگیر برای هوش مصنوعی برندهان؟
خلاصهٔ کاملتر
وقتی یه ایجنت هوش مصنوعی داره کد مینویسه، بزرگترین دشمنش ابهامه، نه پیچیدگی. اگه API پلتفرمی که باهاش کار میکنه صریح و قابلتأیید نباشه، ایجنت وارد یه چرخهی بیپایان آزمونوخطا میشه که هم کُنده، هم گرونه.
هر فریمورک یه طیف داره؛ یه سر طیف APIهای سختگیر (تایپشده، اسکیمادار، سرویسکانتینری) و سر دیگه APIهای شل (کلیدهای رشتهای، قراردادهای نامگذاری، هوکهای بدون تایپ). APIهای سختگیر اول هزینه دارن: بویلرپلیت بیشتر، یادگیری بیشتر. ولی APIهای شل هزینه رو عقب میاندازن: ابهام بیشتر، باگهایی که سختتر پیدا میشن. با ورود AI، این معادله عوض شده.
مشکل magic string چیه؟ هم دروپال هم وردپرس سالهاست از هوکهای رشتهای (magic-string hooks) استفاده میکنن. مثلاً در دروپال تابعی مثل mymodule_user_login مینویسی، یا در وردپرس یه رشته به add_action() پاس میدی. مشکل اینه که زبان برنامهنویسی هیچ راهی برای تأیید این رشتهها نداره. اگه اسم رو اشتباه بنویسی، سیستم بیسروصدا کدت رو نادیده میگیره؛ هیچ خطایی، هیچ هشداری، هیچ لاگی.
امضای تابع هم یه قرارداد نیست، یه «توافق ضمنی»ه. داکیومنت میگه هوک user_login یه آبجکت $user میگیره، ولی هیچچیزی این رو enforce نمیکنه. IDE و ابزارهای آنالیز استاتیک مثل PHPStan هم از این ارتباط خبر ندارن، پس نمیتونن بهت هشدار بدن.
راهحل چیه؟ استفاده از PHP attribute هایی مثل #[Hook('user_login')] روی یه سرویس ثبتشده. با این روش، کلاس باید وجود داشته باشه، امضای متد تایپچک میشه، و کانتینر وابستگیها رو بهصورت خودکار سیمکشی میکنه. IDE، آنالایزر، و ایجنت AI میتونن زنجیره رو از اتریبیوت تا پیادهسازی دنبال کنن. حلقهی فیدبک تنگ میمونه و آزمونوخطا به حداقل میرسه.
دروپال این مسیر رو از سالها پیش شروع کرده؛ دروپال ۸ در سال ۲۰۱۵ با معرفی روتینگ، سرویسها، و ایونتدیسپچر سیمفونی، بخش بزرگی از سیستم procedural hook رو کنار گذاشت. اتریبیوتمحوری در دروپال ۱۱.۱ هم اومد و مسیرهای procedural بیشتری رو حذف کرد. علاوه بر این، یه پروژهی چندساله روی اعتبارسنجی فایلهای YAML هم داشته این شلترین بخش سیستم رو قابل اعتمادتر میکنه.
وردپرس مسیر دیگهای رفته. اولویتش سازگاری با نسخههای قدیمی بوده، که باعث شده پلتفرم باثبات بمونه، ولی همون شُلی قدیمی رو هم نگه داشته. نتیجه؟ ایجنتهای AI وقتی با وردپرس کار میکنن، بیشتر وقتشون صرف حدسزدن قراردادها و debug کردن خطاهای ضمنی میشه.
در DrupalCon شیکاگو در مارس ۲۰۲۶، ابزارهای AI کدینگ یه سایت Lovable-generated رو در چند ساعت به دروپال مهاجرت دادن. APIهای سختگیر دروپال بود که ایجنت رو روی ریل نگه داشت.
نکات کلیدی:
- ایجنتهای AI با ابهام کُند میشن، نه پیچیدگی
- magic string هوکها هیچ فیدبک خطایی نمیدن و ایجنت رو گیج میکنن
- APIهای تایپشده و اتریبیوتمحور حلقهی فیدبک رو تنگ میکنن
- دروپال از سال ۲۰۱۵ روی سختگیری API سرمایهگذاری کرده
- وردپرس سازگاری با نسخههای قدیمی رو انتخاب کرد و شُلی API رو حفظ کرد
- این تفاوت معماری حالا مستقیماً روی سرعت و هزینهی توسعه با AI اثر میذاره




