rk Commerce — مشاور خرید هوش مصنوعی شاپیفای

پلتفرم تجارت هوش مصنوعی

بازگشت به پروژه‌ها
مطالعه موردی

یک دستیار خرید مبتنی بر RAG برای فروشگاه‌های شاپیفای — یک ویجت چت فروشگاهی به همراه یک داشبورد تحلیلی برای فروشنده، که طوری ساخته شده تا به‌جای حدس زدن، از پاسخ دادن امتناع کند.

پشته فناوری

PythonFastAPINext.jsTypeScriptShopify PolarisShopify Theme App ExtensionPostgreSQLpgvectorOpenAI EmbeddingsClaude API
01

جداسازی مستأجران، اجرا‌شده نه فرض‌شده

هر پرس‌وجو روی داده محصولات محدود به یک فروشگاه است، این محدودیت با row-level security در Postgres اجرا می‌شود — نه با قرارداد کدنویسی برنامه. دلیل این تصمیم: لایه repository نمی‌تواند SQL خام را کنترل کند، و SQL خام دقیقاً همان چیزی است که یک بهینه‌سازی جست‌وجوی برداری در آینده به سراغش می‌رود، پس مرز جداسازی جایی قرار دارد که هیچ میان‌بر آینده‌ای نتواند از آن عبور کند.

02

فقط GraphQL، عمداً

هر فراخوانی به Admin API شاپیفای از طریق GraphQL انجام می‌شود، عمداً — REST Admin API از آوریل ۲۰۲۵ برای اپلیکیشن‌های عمومی جدید منسوخ اعلام شد، پس هیچ فراخوانی REST در هیچ جای کدبیس وجود ندارد.

03

همگام‌سازی خودتصحیح‌گر

همگام‌سازی کامل کاتالوگ در زمان نصب از Bulk Operations API شاپیفای استفاده می‌کند؛ وبهوک‌های تدریجی پس از آن آن را به‌روز نگه می‌دارند. تنها قاعده‌ای که اهمیت دارد: هر همگام‌سازی، وضعیت معتبر محصول را دوباره از طریق GraphQL می‌خواند به‌جای اعتماد به فیلدهای خود payload وبهوک — یعنی همگام‌سازی‌های دسته‌ای و وبهوکی روی یک مسیر کد واحد جمع می‌شوند، و رسیدن نامرتب وبهوک‌ها خودتصحیح‌گر می‌شود (یک بازخوانی که چیزی پیدا نکند، محصول را به‌صورت محلی حذف می‌کند، فارغ از اینکه کدام وبهوک شلیک شده).

04

چت مستند و صادق

ویجت فروشگاهی به‌طور کامل از طریق درخواست امضاشده App Proxy خود شاپیفای احراز هویت می‌شود — کلاینت هرگز شناسه فروشگاه خودش را ارسال نمی‌کند، چون هر فراخواننده‌ای که بتواند آن را جعل کند می‌تواند جای یک فروشگاه دیگر را بگیرد. بازیابی یک آستانه فاصله دارد که نقش خط «نمی‌دانم» اپلیکیشن را بازی می‌کند: زیر آن آستانه، خریدار به‌جای حدس مدل، یک امتناع صادقانه دریافت می‌کند و این مورد ثبت می‌شود تا فروشنده ببیند کاتالوگش چه چیزی را کم دارد.

05

مقایسه‌گری که از حدس زدن امتناع می‌کند

مقایسه سایز بین برندها («من در زارا سایز مدیوم می‌پوشم») به‌جای تخمین زدن، کاملاً رد می‌شود، چون سایزبندی فروشندگان استاندارد نیست و پیامد یک حدس اشتباه یک مرجوعی است. میزان اطمینان بر اساس اینکه چقدر شواهد واقعی از مقایسه پشتیبانی کرده‌اند محاسبه می‌شود، و هرچه آن را پایین آورده باشد، به‌صورت یک هشدار با کلمات ساده به خریدار نشان داده می‌شود، نه پنهان‌شده پشت یک عدد امتیاز.

06

گزارش‌های هفتگی صادقانه برای فروشنده

درصدهای روند زمانی که هنوز یک خط پایه آماری واقعی وجود ندارد، گزارش نمی‌شوند، به‌جای گزارش چیزی گمراه‌کننده مثل «۲۰۰٪ رشد» بر اساس یک نمونه تک‌رقمی.