الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

مكّن وكلاءك من إدارة عمليات التجارة الإلكترونية عبر Shopify. تعامل مع العملاء والطلبات والمنتجات والمخزون وتحليلات المتجر لتبسيط أعمالك التجارية عبر الإنترنت باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

​
المتطلبات الأساسية

قبل استخدام تكامل Shopify، تأكد من توفر ما يلي:
  • حساب CrewAI AMP مع اشتراك فعّال
  • متجر Shopify بصلاحيات المسؤول المناسبة
  • ربط متجر Shopify الخاص بك عبر صفحة التكاملات

​
إعداد تكامل Shopify

​
1. ربط متجر Shopify الخاص بك

  1. انتقل إلى تكاملات CrewAI AMP
  2. ابحث عن Shopify في قسم تكاملات المصادقة
  3. انقر على Connect وأكمل عملية OAuth
  4. امنح الصلاحيات اللازمة لإدارة المتجر والمنتجات
  5. انسخ رمز المؤسسة من إعدادات التكامل

​
2. تثبيت الحزمة المطلوبة

uv add crewai-tools

​
3. إعداد متغير البيئة

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
أو أضفه إلى ملف .env: 
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

​
الأدوات المتاحة

​
إدارة العملاء

الوصف: استرجاع قائمة العملاء من متجر Shopify.المعاملات:
  • customerIds (string, اختياري): قائمة معرّفات العملاء مفصولة بفواصل
  • limit (string, اختياري): الحد الأقصى لعدد العملاء (الافتراضي: 250)
الوصف: إنشاء عميل جديد في متجر Shopify.المعاملات:
  • firstName (string, مطلوب): الاسم الأول للعميل
  • lastName (string, مطلوب): اسم العائلة للعميل
  • email (string, مطلوب): عنوان البريد الإلكتروني للعميل
  • phone (string, اختياري): رقم الهاتف
  • tags (string, اختياري): الوسوم كمصفوفة أو قائمة مفصولة بفواصل
الوصف: تحديث عميل موجود في متجر Shopify.المعاملات:
  • customerId (string, مطلوب): معرّف العميل المراد تحديثه
  • firstName (string, اختياري): الاسم الأول
  • lastName (string, اختياري): اسم العائلة
  • email (string, اختياري): عنوان البريد الإلكتروني

​
إدارة الطلبات

الوصف: استرجاع قائمة الطلبات من متجر Shopify.المعاملات:
  • orderIds (string, اختياري): قائمة معرّفات الطلبات مفصولة بفواصل
  • limit (string, اختياري): الحد الأقصى لعدد الطلبات (الافتراضي: 250)
الوصف: إنشاء طلب جديد في متجر Shopify.المعاملات:
  • email (string, مطلوب): عنوان البريد الإلكتروني للعميل
  • lineItems (object, مطلوب): عناصر سطر الطلب بصيغة JSON
  • fulfillmentStatus (string, اختياري): حالة التنفيذ - الخيارات: fulfilled, null, partial, restocked
الوصف: استرجاع سلال التسوق المهجورة من متجر Shopify.المعاملات:
  • status (string, اختياري): عرض عمليات الدفع بالحالة المحددة - الخيارات: open, closed (الافتراضي: open)
  • limit (string, اختياري): الحد الأقصى لعدد السلال (الافتراضي: 250)

​
إدارة المنتجات

الوصف: استرجاع قائمة المنتجات من متجر Shopify.المعاملات:
  • title (string, اختياري): تصفية حسب عنوان المنتج
  • status (string, اختياري): تصفية حسب الحالة - الخيارات: active, archived, draft
  • limit (string, اختياري): الحد الأقصى لعدد المنتجات (الافتراضي: 250)
الوصف: إنشاء منتج جديد في متجر Shopify.المعاملات:
  • title (string, مطلوب): عنوان المنتج
  • productType (string, مطلوب): نوع/فئة المنتج
  • vendor (string, مطلوب): مورد المنتج
  • productDescription (string, اختياري): وصف المنتج
  • price (string, اختياري): سعر المنتج
الوصف: تحديث منتج موجود في متجر Shopify.المعاملات:
  • productId (string, مطلوب): معرّف المنتج المراد تحديثه
  • title (string, اختياري): عنوان المنتج
  • price (string, اختياري): سعر المنتج

​
أمثلة الاستخدام

​
إعداد Agent أساسي لـ Shopify

from crewai import Agent, Task, Crew
from crewai import Agent, Task, Crew

# Create an agent with Shopify capabilities
shopify_agent = Agent(
    role="E-commerce Manager",
    goal="Manage online store operations and customer relationships efficiently",
    backstory="An AI assistant specialized in e-commerce operations and online store management.",
    apps=['shopify']  # All Shopify actions will be available
)

# Task to create a new customer
create_customer_task = Task(
    description="Create a new VIP customer Jane Smith with email jane.smith@example.com and phone +1-555-0123",
    agent=shopify_agent,
    expected_output="Customer created successfully with customer ID"
)

# Run the task
crew = Crew(
    agents=[shopify_agent],
    tasks=[create_customer_task]
)

crew.kickoff()

​
الحصول على المساعدة

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Shopify أو استكشاف الأخطاء وإصلاحها.