العودة إلى التوثيق
دليل تكامل وكيل الذكاء الاصطناعي
اربط ChatGPT و Claude و Gemini ووكلاء الذكاء الاصطناعي المخصصين بمتجرك عبر zalink.ai
ChatGPT / OpenAI
بروتوكول ACPالتكامل عبر إجراءات OpenAI باستخدام بروتوكول التجارة الوكيلة. سجل متجرك كإضافة ChatGPT حتى يتمكن المستخدمون من تصفح المنتجات والدفع عبر المحادثة.
- 1سجل متجرك في dashboard.zalink.ai
- 2انسخ رابط بيان ACP الخاص بك: https://api.zalink.ai/acp/stores/{storeId}/.well-known/ai-plugin.json
- 3في متجر إضافات ChatGPT، اختر "طور إضافتك" والصق رابط البيان
- 4سيكتشف ChatGPT نقاط النهاية تلقائياً عبر مواصفات OpenAPI
- 5يمكن للمستخدمين الآن مطالبة ChatGPT بالبحث عن المنتجات وإدارة السلات والدفع
Claude / Anthropic
بروتوكول MCPالتكامل عبر بروتوكول سياق النموذج لتفاعلات غنية مبنية على الجلسات. يمكن لـ Claude استخدام أدوات MCP للبحث عن المنتجات وإدارة السلات ومعالجة الطلبات مع سياق محادثة كامل.
- 1احصل على نقطة نهاية MCP: https://api.zalink.ai/mcp/{storeId}
- 2قم بتهيئة Claude Desktop أو API مع رابط خادم MCP
- 3اضبط مفتاح API كرمز bearer للتفويض
- 4يكتشف Claude تلقائياً الأدوات والموارد المتاحة
- 5تحتفظ الجلسات بالسياق عبر المحادثات المتعددة
Gemini / Google
قريباًتكامل Google Gemini قيد التطوير. سيكون متجرك قابلاً للاكتشاف عبر نقطة النهاية القياسية عند التوفر. سجل اهتمامك عبر لوحة التحكم.
- 1نقطة نهاية الاكتشاف: https://api.zalink.ai/agents/discover/{storeId}
- 2سيدعم تنسيق استدعاء دوال Gemini
- 3تعيين تلقائي للقدرات من نقاط نهاية ACP الحالية
- 4سجل للوصول المبكر في dashboard.zalink.ai/settings
وكلاء ذكاء اصطناعي مخصصين
REST APIقم ببناء تكامل وكيل الذكاء الاصطناعي الخاص بك باستخدام واجهة zalink.ai REST API. وصول كامل إلى المنتجات والطلبات والسلات وبيانات العملاء مع مصادقة Bearer token.
- 1أنشئ مفتاح API في dashboard.zalink.ai/api-keys
- 2الرابط الأساسي: https://api.zalink.ai
- 3المصادقة بـ Authorization: Bearer YOUR_API_KEY
- 4استخدم نقاط نهاية ACP للبحث عن المنتجات والسلة والدفع
- 5راجع مرجع API للتوثيق الكامل لنقاط النهاية
أمثلة الكود
المصادقة مع API
import requests
API_KEY = "مفتاح_api_الخاص_بك"
BASE = "https://api.zalink.ai"
headers = {"Authorization": f"Bearer {API_KEY}"}البحث عن المنتجات
resp = requests.get(
f"{BASE}/acp/stores/{store_id}/products/search",
headers=headers,
params={"q": "laptop", "limit": 10}
)
products = resp.json()["products"]إدارة السلة
# إنشاء سلة
cart = requests.post(
f"{BASE}/acp/stores/{store_id}/cart",
headers=headers,
json={"items": [{"productId": "p1", "quantity": 2}]}
).json()
# تحديث السلة
requests.put(
f"{BASE}/acp/stores/{store_id}/cart/{cart['id']}",
headers=headers,
json={"action": "update", "itemId": "p1", "quantity": 3}
)معالجة الدفع
checkout = requests.post(
f"{BASE}/acp/stores/{store_id}/checkout",
headers=headers,
json={
"cartId": cart["id"],
"customerInfo": {
"email": "buyer@example.com",
"name": "أحمد"
}
}
).json()
print(checkout["checkoutUrl"])