إرشادات تكامل وكيل AI
أفضل الممارسات لوكلاء AI للتكامل مع ZaLinkAI دون حظر أو تقييد.
مرحباً بمطوري AI
يساعدك هذا الدليل في تكامل مساعدي التسوق الذكي مع المتاجر المتصلة بـ ZaLinkAI. اتبع هذه الإرشادات لضمان تقديم وكيلك أفضل تجربة للعملاء مع احترام موارد المتجر.
المبدأ الأساسي: طلبات تركز على العميل
ZaLinkAI مصمم لتجارب تسوق العملاء، وليس فهرسة الكتالوج. اطلب ما يحتاجه العملاء، عندما يحتاجونه.
أفضل الممارسات
اطلب منتجات محددة
اسأل عن المنتجات بالمعرف أو الاسم أو استعلام البحث بناءً على نية العميل.
خزّن الاستجابات محلياً
احفظ تفاصيل المنتجات والفئات والأسعار لتجنب الطلبات المتكررة.
اتبع تنقل العميل
تصفح الفئات أو الكتالوجات فقط عندما يطلب العميل الاستكشاف صراحةً.
احترم حدود المعدل
تحقق من رؤوس X-RateLimit وتراجع عند الاقتراب من الحدود.
استخدم الاكتشاف باعتدال
تصفح الكتالوج له حدود يومية. استخدمه للاستكشاف الأولي، وليس الفهرسة المستمرة.
ما يجب تجنبه
تعداد الكتالوج
لا تكرر عبر جميع المنتجات أو الفئات أو الصفحات برمجياً.
الاستعلامات المتكررة المتطابقة
لا تقدم نفس الطلب عدة مرات. خزّن وأعد استخدام الاستجابات.
الاستطلاع عالي التردد
لا تتحقق من التحديثات أكثر من مرة في الدقيقة إلا إذا كان ضرورياً.
استخراج البيانات بالجملة
لا تحاول تنزيل كتالوجات المنتجات أو قوائم الأسعار كاملة.
تجاهل رؤوس التصنيف
لا تتجاهل رؤوس X-Request-Classification أو X-Crawl-Warning.
فهم تصنيف الطلبات
كل طلب يتلقى تصنيفاً يؤثر على الفوترة:
رؤوس الاستجابة للمراقبة
تحقق من هذه الرؤوس في كل استجابة:
| Header | Description |
|---|---|
X-Request-Classification | كيف تم تصنيف هذا الطلب (ممتاز، قياسي، اكتشاف، إلخ) |
X-Billing-Multiplier | مضاعف الفوترة المطبق (1.0، 0.5، 0.0) |
X-Crawl-Warning | رسالة تحذير إذا تم اكتشاف أنماط زحف. اتخذ إجراءً تصحيحياً! |
X-RateLimit-Remaining | عدد الطلبات المتبقية في النافذة الحالية. |
X-Discovery-Remaining | طلبات الاكتشاف المتبقية اليوم لهذا المتجر. |
عتبات كشف الزحف
تجاوز هذه العتبات في جلسة يؤدي إلى تحذيرات أو حظر:
نمط تكامل مثالي
نمط جيد
// العميل يسأل: "أرني أحذية رياضية زرقاء أقل من 300 ريال"
const products = await zalink.searchProducts({
query: "أحذية رياضية زرقاء",
maxPrice: 300,
limit: 10
});
// خزّن النتائج لهذه الجلسة
sessionCache.set('blue-sneakers', products);
// العميل يختار منتجاً - احصل على التفاصيل
const product = await zalink.getProduct(products[0].id);
// أضف للسلة بناءً على إجراء العميل
await zalink.addToCart(product.id, 1);نمط سيء
// سيء: محاولة فهرسة الكتالوج بالكامل
for (let page = 1; page <= 1000; page++) {
const products = await zalink.listProducts({ page });
database.store(products); // لا تفعل هذا!
}
// سيء: استطلاع التغييرات كل ثانية
setInterval(async () => {
const products = await zalink.listProducts();
}, 1000);تحتاج مساعدة؟
إذا كنت تعتقد أن وكيلك يتم وسمه بشكل غير صحيح:
- راجع رسالة رأس X-Crawl-Warning للحصول على إرشادات محددة
- تحقق من أنماط طلباتك مقابل العتبات أعلاه
- نفذ التخزين المؤقت المناسب لتقليل الطلبات المكررة
- تواصل مع الدعم بمعرف وكيلك إذا استمرت المشاكل