اگر صاحب یک فروشگاه آنلاین با ووکامرس هستید، احتمالاً همین حالا هم عامل‌های هوش مصنوعی (AI Agents) در حال بررسی موجودی کالاهای شما هستند. اما مشکل اینجاست که اکثر این مدل‌ها برای فهمیدن قیمت و جزئیات، بر استخراج داده‌ها از HTML رندر شده (Web Scraping) تکیه می‌کنند. این فرآیند چون ساختار سایت‌ها پیچیده و متغیر است، اغلب منجر به نمایش قیمت‌های نادرست و خطاهای موجودی می‌شود.
برای حل این بحران، ابزار KaliCart Bridge به‌عنوان یک افزونه رایگان در دایرکتوری وردپرس (با جست‌وجوی عبارت "KaliCart Bridge") منتشر شد تا جایگزینی ماشین‌خوان و پایدار برای استخراج داده‌های شکننده فراهم کند. فروشگاه‌های سنتی برای چشم انسان طراحی شده‌اند، نه برای توکن‌های (Tokens) — یعنی واحدهای کوچکی از متن که یک مدل زبانی پردازش می‌کند. وقتی یک عامل سعی می‌کند صفحه محصول را تحلیل کند، باید چیدمان بصری سایت را مهندسی معکوس کند تا قیمت و وضعیت موجودی را پیدا کند. دقیقاً در همین لایه انتزاع است که اکثر خطاهای خرید هوش مصنوعی رخ می‌دهد. با انتقال تعامل از لایه نمایش (Presentation Layer) به لایه داده (Data Layer)، فروشندگان تضمین می‌کنند که مدل‌ها دقیقاً همان حقیقتی را می‌بینند که در پایگاه داده ثبت شده است.
معماری اکتشاف-محور (Discovery-First)
همان‌طور که در تحلیل‌های قبلی ما درباره‌ی استانداردهای ارتباطی مدل‌های زبانی اشاره کردیم، ساختاریافته بودن داده‌ها تنها راه عبور از توهمات است. طبق مستندات این پروژه، سیستم بر محور یک سند اکتشافی واحد می‌چرخد که در مسیر /wp-json/kalicart/v1/discovery قرار دارد. عامل هوش مصنوعی به‌جای حدس زدن نقاط دسترسی (Endpoints)، ابتدا این سند را دریافت می‌کند تا قابلیت‌ها و قوانین کاتالوگ فروشگاه را یاد بگیرد.
یک پاسخ نمونه از این سند اکتشافی، ساختار زیر را فاش می‌کند:
document_kind: "kalicart_merchant_bridge"schema_version: "1.0"plugin_version: "1.0.101"capabilities: جست‌وجو (Search)، موجودی (Availability) و سیاست‌های ارسال (Shipping Policy) فعال هستند، اما سبد خرید (Cart)، پرداخت (Checkout)، تراکنش‌ها (Payments) و تغییرات داده (Mutations) صراحتاً روی مقدارfalseتنظیم شده‌اند.
این سند صراحتاً تعریف می‌کند که این پل ارتباطی «فقط-خواندنی» (Read-only) است. چون این لایه صرفاً یک سطح خواندنی روی کاتالوگ است، هرگز با سفارش‌ها یا جابه‌جایی پول درگیر نمی‌شود. بنابراین، اختیار پرداخت به‌طور کامل و سخت‌گیرانه در دست فروشگاه ووکامرس باقی می‌ماند و عامل هوش مصنوعی در همان لحظه اول می‌داند چه دسترسی‌هایی دارد و در چه مواردی مجاز به فرض یا اقدام نیست.
تازگی داده‌ها (Data Freshness) ستون اصلی این طراحی است. به نقل از توسعه‌دهندگان، این افزونه در لحظهٔ ارسال پرس‌وجو، مستقیماً از پایگاه داده زنده ووکامرس می‌خواند. سند اکتشافی این موضوع را از طریق شیء freshness تأیید می‌کند، جایی که منبع داده را live_woocommerce_database و وضعیت آن را is_realtime: true ذکر می‌کند. این رویکرد نیاز به ایندکس‌های جداگانه یا اسنپ‌شات‌های همگام‌سازی شده را از بین می‌برد و تضمین می‌کند قیمتی که مدل دریافت می‌کند، همان قیمت لحظه‌ای و واقعی در فروشگاه است.
نقشه نقاط دسترسی (The Endpoint Map)
سند اکتشافی تمام سطوح خواندنی موجود را به عامل معرفی می‌کند. نقاط دسترسی در دسترس عبارتند از:
/wp-json/kalicart/v1/discovery(نقطه ورود و شناسایی)/wp-json/kalicart/v1/catalog/search(جست‌وجوی محصولات)/wp-json/kalicart/v1/catalog/products(لیست کلی محصولات)/wp-json/kalicart/v1/catalog/product/{id}(جزئیات تک‌تک محصولات)/wp-json/kalicart/v1/catalog/categories(فهرست دسته‌بندی‌ها)/wp-json/kalicart/v1/catalog/meta(متاداده‌ها)/wp-json/kalicart/v1/mcp(درگاه پروتکل کانتکست مدل)
نکته بسیار مهم این است که هیچ کلید API مورد نیاز نیست. کاتالوگ عمومی، عمومی است؛ یعنی همان اطلاعاتی که یک انسان در ویترین فروشگاه می‌بیند، برای ماشین نیز در دسترس است، با این تفاوت که برای ماشین ساختاریافته شده است.
حل مشکل توهم در جست‌وجو (Search Hallucination)
یکی از بزرگ‌ترین شکست‌های جست‌وجوی عامل‌محور، تمایل مدل‌ها به انباشتن چندین ویژگی در یک رشته جست‌وجوی واحد است. برای مثال، یک عامل ممکن است عبارت «تی‌شرت آبی مردانه زیر ۵۰ دلار» را جست‌وجو کند، که در یک کاتالوگ ساختاریافته معمولاً منجر به صفر نتیجه می‌شود.
KaliCart Bridge برای جلوگیری از این توهم، یک قانون سخت‌گیرانه برای ساخت پرس‌وجو اجرا می‌کند:
- پارامتر
qباید «فقط و فقط» شامل اسم ساده محصول (هسته یا Spine) باشد. - هر ویژگی (مانند دسته‌بندی، جنسیت، رنگ، قیمت) «باید» در فیلتر ساختاریافته مخصوص به خود قرار گیرد و هرگز نباید داخل
qباشد. - انباشتن ویژگی‌ها در
qمنجر به بازگشت صفر نتیجه می‌شود. - مثال‌های صحیح:
?q=t-shirt&gender=male&max_price=50یا?q=costume&gender=female&color=blue.
مدل‌سازی داده با دقت بالا (High-Fidelity)
فراتر از جست‌وجو، این افزونه داده‌ها را به‌گونه‌ای مدل می‌کند که هیچ ابهامی باقی نماند. یک پاسخ واقعی برای جست‌وجوی ?q=t-shirt&max_price=50 این عمق را نشان می‌دهد. قیمت در اینجا صرفاً یک رشته متنی نیست، بلکه به فیلدهای مجزای current (فعلی)، regular (عادی)، sale (تخفیفی) و یک پرچم on_sale تقسیم شده است. همچنین شامل یک رشته نمایش (مانند "20,00 €") و یک کدگذاری صریح (encoding: decimal_major_units) است تا از هرگونه سردرگمی بین واحدهای اصلی و جزئی ISO جلوگیری شود.
سطوح موجودی کالا با یک معیار «اطمینان» (Confidence) مدیریت می‌شوند. در مواردی که فروشنده موجودی عددی را ردیابی نمی‌کند، API یک یادداشت برای عامل (agent_note) می‌فرستد: «فروشنده تعداد عددی موجودی را نمایش نمی‌دهد. کالا را برای خرید موجود فرض کن، اما آن را به‌عنوان تعداد تأیید شده موجودی در نظر نگیر». این تفکیک دقیق مانع از آن می‌شود که مدل‌ها وعده‌های دروغین بدهند؛ مثلاً ادعا نکنند که «دقیقاً ۵ عدد از این کالا موجود است» در حالی که فقط می‌دانند وضعیت کالا in_stock است.
دسته‌بندی‌ها نیز دقیقاً از تنظیمات بومی ووکامرس فروشنده حفظ می‌شوند. این پل ارتباطی، تاکسونومی خود فروشنده و مسیرهای کامل (مانند "Moda > Uomo") را ارائه می‌دهد، به‌جای اینکه یک تاکسونومی جهانی و اجباری را بر فروشگاه تحمیل کند.
استدلال مبتنی بر شواهد (Evidence-Required Reasoning)
این افزونه یک قرارداد رفتاری به نام «استدلال مبتنی بر شواهد» را معرفی می‌کند. این قانون طراحی شده تا توهم (Hallucination) را از نظر ساختاری دشوارتر کند. طبق این قرارداد، هر ادعایی که یک عامل درباره محصول می‌کند، باید به یک فیلد عینی در کاتالوگ قابل ردیابی باشد.
منابع مورد نیاز برای ارائه شواهد عبارتند از:
product_url(آدرس محصول)price.current(قیمت فعلی)stock.in_stock(وضعیت موجودی)stock.confidence(میزان اطمینان به موجودی)
این قرارداد صراحتاً ذکر می‌کند: «قیمت‌ها، موجودی یا تخمین‌های ارسال را بدون ذکر فیلد منبع ارائه نکنید». اگر عامل فیلد مورد نظر را در اختیار نداشته باشد، اجازه ندارد وعده‌ای را از خودش ابداع کند.
اتصال: REST و MCP
برای توسعه‌دهندگان، این پل دو روش اتصال ارائه می‌دهد. اول، یک REST API استاندارد برای فراخوانی‌های مستقیم HTTP. دوم، برای کسانی که از فریم‌ورک‌های پیشرفته عامل استفاده می‌کنند، پشتیبانی از پروتکل کانتکست مدل (Model Context Protocol یا MCP) از طریق JSON-RPC 2.0 فراهم شده است.
وقتی MCP فعال باشد، این پل مجموعه‌ای از ابزارهای خاص را ارائه می‌دهد:
search_products(جست‌وجوی محصولات)get_product(دریافت محصول)list_products(لیست محصولات)list_categories(لیست دسته‌بندی‌ها)get_meta(دریافت متاداده‌ها)
این به توسعه‌دهندگان اجازه می‌دهد ترنسپورت مورد نیاز خود را انتخاب کنند (REST برای فراخوانی‌های مستقیم یا MCP برای فریم‌ورک‌های یکپارچه) در حالی که همان تضمین‌های «فقط-خواندنی» حفظ شود.
مرز خودمختاری (The Boundary of Autonomy)
در حالی که این پل داده‌ها را مدیریت می‌کند، تعمداً در مرحله پرداخت متوقف می‌شود. نسخه فعلی می‌تواند یک سبد خرید ووکامرس ایجاد کند و یک checkout_url برای انسان فراهم کند تا تراکنش را به پایان برساند.
پرداخت کاملاً خودکار (Autonomous Checkout) — جایی که یک عامل دارای مجوز پیش‌تأیید شده باشد و خرید را از ابتدا تا انتها تکمیل کند — در نقشه راه (Roadmap) قرار دارد. این قابلیت منوط به پشتیبانی ووکامرس و درگاه‌های پرداخت از قراردادهای سازگار با AP2 و تأیید پرداخت برنامه‌نویسی شده است. تا آن زمان، مرز امن این است: مدل‌ها می‌خوانند، انسان‌ها پرداخت می‌کنند.
این رویکرد پارادایم را تغییر می‌دهد؛ به‌جای اینکه فروشنده بخواهد ماشین را محدود کند، این «دامنه داده» (Domain) است که ماشین را محدود می‌کند. با ارائه یک قرارداد صلب و سخت، صاحب فروشگاه دقیقاً کنترل می‌کند که یک AI چه چیزی را ببیند و چه ادعایی کند، بدون اینکه امنیت سایت را به خطر اندازد.
برای پیاده‌سازی این سیستم، صاحبان فروشگاه می‌توانند عبارت "KaliCart Bridge" را در دایرکتوری افزونه‌های وردپرس جست‌وجو و فعال کنند و سپس ابزار اکتشافی عامل خود را به نقطه اتصال /wp-json/kalicart/v1/discovery هدایت کنند.
گام بعدی شما
- اگر فروشگاه ووکامرسی دارید، افزونه "KaliCart Bridge" را نصب کنید تا کاتالوگ شما برای عامل‌های AI قابل دسترس شود.
- نقطه اتصال
/wp-json/kalicart/v1/discoveryرا به ابزارهای اکتشافی عامل خود معرفی کنید. - در صورت استفاده از فریم‌ورک‌های پیشرفته، اتصال MCP را برای دسترسی سریع‌تر به ابزارهای
search_productsفعال کنید.
اما تأثیر این استانداردسازی بر آینده موتورهای جست‌وجوی AI بسیار عمیق‌تر است — به تحلیل ما درباره پروتکل MCP مراجعه کنید.
گفتگو