· 1 دقیقه مطالعه

UCP چیست؟ راهنمای کامل Universal Commerce Protocol برای فروشگاه‌های ایرانی

دیاگرام پروتکل UCP: مسیر اتصال ایجنت هوش مصنوعی به فروشگاه آنلاین
← بازگشت به بلاگ

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

UCP دقیقاً چیست؟

Universal Commerce Protocol یا به‌اختصار UCP، یک استاندارد باز است که به کسب‌وکارها اجازه می‌دهد قابلیت‌های تجاری خود — جست‌وجوی محصول، بررسی موجودی، سبد خرید و پرداخت — را به‌شکلی ساخت‌یافته و قابل‌فهم برای ماشین منتشر کنند. دقیقاً همان‌طور که فایل robots.txt به موتورهای جست‌وجو می‌گوید چه بخش‌هایی از سایت را بخزند، یا sitemap.xml نقشه‌ی صفحات را در اختیارشان می‌گذارد، فایل UCP هم یک نقشه‌ی راه تجاری برای ایجنت‌های هوش مصنوعی فراهم می‌کند.

چرا کسب‌وکارها به UCP نیاز دارند؟

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

  • کشف‌پذیری: ایجنت‌ها می‌دانند دقیقاً کجا باید دنبال قابلیت‌های شما بگردند (/.well-known/ucp)
  • دقت بالاتر: داده‌ی ساخت‌یافته یعنی خطای کمتر در قیمت، موجودی و مشخصات محصول
  • مزیت رقابتی زودهنگام: پذیرندگان اولیه بیشترین دیده‌شدن را در نتایج ایجنت‌ها خواهند داشت
  • استانداردسازی: به‌جای ساخت یک API اختصاصی برای هر ایجنت، یک‌بار پیاده‌سازی می‌کنید و همه می‌فهمند
نمودار گام‌به‌گام یک تراکنش UCP از کشف تا تایید سفارش
نمودار گام‌به‌گام یک تراکنش UCP از کشف تا تایید سفارش

ساختار فایل ucp.json

فایل اصلی UCP باید در آدرس https://yoursite.com/.well-known/ucp در دسترس باشد و به‌صورت JSON پاسخ دهد. این مسیر، محل استانداردی است که ایجنت‌ها همیشه ابتدا آن را بررسی می‌کنند — دقیقاً مثل رفتار موتورهای جست‌وجو با robots.txt.

فیلدهای اصلی فایل

  • protocol — نسخه‌ی پروتکل، مثلاً ucp/v1
  • merchant_name — نام کسب‌وکار شما
  • description — توضیح کوتاه درباره‌ی فعالیت شما
  • website — آدرس اصلی سایت
  • capabilities — فهرست قابلیت‌هایی که ایجنت می‌تواند فراخوانی کند
  • payment_methods — روش‌های پرداخت پشتیبانی‌شده
  • supported_languages و currency — زبان و واحد پول

قابلیت‌ها (Capabilities) چه هستند؟

هر قابلیت در UCP یک شیء کوچک با چهار بخش است: نام، توضیح، آدرس اندپوینت و متد HTTP. ایجنت با خواندن این اطلاعات می‌فهمد دقیقاً چطور باید درخواست بزند و چه پاسخی انتظار داشته باشد، بدون نیاز به مستندات جداگانه یا حدس‌زدن.

  • search_offers — جست‌وجو در محصولات یا خدمات
  • get_product_details — دریافت جزئیات کامل یک محصول
  • check_inventory — بررسی موجودی لحظه‌ای
  • manage_cart — افزودن و مدیریت سبد خرید
  • initiate_checkout — شروع فرآیند پرداخت
  • wallet_balance — بررسی موجودی کیف پول داخلی
  • book_appointment — رزرو نوبت برای کسب‌وکارهای خدماتی
  • validate_coupon — اعتبارسنجی کد تخفیف

UCP در برابر API‌های سنتی فروشگاهی چه برتری‌ای دارد؟

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

اگر یک ایجنت هوش مصنوعی نتواند کسب‌وکار شما را کشف و درک کند، برای آن ایجنت — و برای مشتری‌ای که به آن ایجنت اعتماد کرده — شما اصلاً وجود ندارید.

چطور UCP را روی سایت خود پیاده‌سازی کنیم؟

  1. اطلاعات پایه‌ی کسب‌وکار (نام، آدرس، توضیحات) را در ژنراتور رایگان UCP وارد کنید
  2. نوع کسب‌وکار و قابلیت‌های مورد نیاز را انتخاب کنید
  3. فایل ucp.json و کد Schema تولیدشده را دانلود کنید
  4. فایل را دقیقاً در مسیر /.well-known/ucp روی هاست خود قرار دهید
  5. اندپوینت‌های تعریف‌شده (جست‌وجو، سبد خرید، پرداخت و ...) را در بک‌اند پیاده‌سازی کنید
  6. با ابزارهایی مثل curl یا Postman خروجی را تست کنید تا مطمئن شوید JSON معتبر و در دسترس است

سوالات متداول درباره UCP

آیا استفاده از UCP رایگان است؟

بله. UCP یک استاندارد باز است و ابزار پایه‌ی ژنراتور آن در OpenCommerce به‌صورت رایگان در اختیار همه قرار دارد.

آیا برای فروشگاه‌های کوچک هم UCP کاربرد دارد؟

دقیقاً برعکسِ تصور رایج، کسب‌وکارهای کوچک بیشترین سود را از UCP می‌برند؛ چون بدون نیاز به بودجه‌ی بازاریابی سنگین، مستقیماً در مسیر تصمیم‌گیری ایجنت‌های هوش مصنوعی قرار می‌گیرند.

رابطه UCP با MCP و GEO چیست؟

این سه پروتکل مکمل یکدیگرند: GEO کمک می‌کند ایجنت‌ها اصلاً کسب‌وکار شما را پیدا کنند، MCP دسترسی امن ایجنت به داده‌های داخلی شما را فراهم می‌کند، و UCP تراکنش نهایی خرید را ممکن می‌سازد. برای دید کامل‌تر، مقاله‌ی تجارت عامل‌محور را بخوانید.

سایت خود را برای عصر تجارت هوشمند آماده کنید

در کمتر از ۳ دقیقه، فایل‌های استاندارد UCP و Schema را برای کسب‌وکار خود بسازید.

ساخت رایگان فایل UCP ←