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

نظرة عامة

مكّن وكلاءك من إدارة المدفوعات والاشتراكات وفواتير العملاء عبر Stripe. تعامل مع بيانات العملاء، ومعالجة الاشتراكات، وإدارة المنتجات، وتتبع المعاملات المالية لتبسيط سير عمل المدفوعات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

قبل استخدام تكامل Stripe، تأكد من توفر ما يلي:

إعداد تكامل Stripe

1. ربط حساب Stripe الخاص بك

  1. انتقل إلى تكاملات CrewAI AMP
  2. ابحث عن Stripe في قسم تكاملات المصادقة
  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

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

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

الوصف: إنشاء عميل جديد في حساب Stripe.المعاملات:
  • emailCreateCustomer (string, مطلوب): عنوان البريد الإلكتروني للعميل
  • name (string, اختياري): الاسم الكامل للعميل
  • description (string, اختياري): وصف العميل للمرجع الداخلي
الوصف: استرجاع عميل محدد بواسطة معرّف عميل Stripe.المعاملات:
  • idGetCustomer (string, مطلوب): معرّف عميل Stripe المراد استرجاعه
الوصف: استرجاع قائمة العملاء مع تصفية اختيارية.المعاملات:
  • emailGetCustomers (string, اختياري): تصفية العملاء حسب البريد الإلكتروني
  • limitGetCustomers (string, اختياري): الحد الأقصى لعدد العملاء (الافتراضي: 10)
الوصف: تحديث معلومات عميل موجود.المعاملات:
  • customerId (string, مطلوب): معرّف العميل المراد تحديثه
  • emailUpdateCustomer (string, اختياري): عنوان البريد الإلكتروني المحدّث
  • name (string, اختياري): اسم العميل المحدّث

إدارة الاشتراكات

الوصف: إنشاء اشتراك جديد لعميل.المعاملات:
  • customerIdCreateSubscription (string, مطلوب): معرّف العميل الذي سيُنشأ له الاشتراك
  • plan (string, مطلوب): معرّف خطة الاشتراك
الوصف: استرجاع الاشتراكات مع تصفية اختيارية.المعاملات:
  • customerIdGetSubscriptions (string, اختياري): تصفية الاشتراكات حسب معرّف العميل
  • subscriptionStatus (string, اختياري): تصفية حسب حالة الاشتراك - الخيارات: incomplete, trialing, active, past_due, canceled, unpaid

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

الوصف: إنشاء منتج جديد في كتالوج Stripe.المعاملات:
  • productName (string, مطلوب): اسم المنتج
  • description (string, اختياري): وصف المنتج
الوصف: استرجاع قائمة المنتجات مع تصفية اختيارية.المعاملات:
  • limitGetProducts (string, اختياري): الحد الأقصى لعدد المنتجات (الافتراضي: 10)

العمليات المالية

الوصف: استرجاع معاملات الرصيد من حساب Stripe.المعاملات:
  • balanceTransactionType (string, اختياري): تصفية حسب نوع المعاملة - الخيارات: charge, refund, payment, payment_refund
الوصف: استرجاع خطط الاشتراك من حساب Stripe.المعاملات:
  • isPlanActive (boolean, اختياري): تصفية حسب حالة الخطة

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

إعداد Agent أساسي لـ Stripe

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

# Create an agent with Stripe capabilities
stripe_agent = Agent(
    role="Payment Manager",
    goal="Manage customer payments, subscriptions, and billing operations efficiently",
    backstory="An AI assistant specialized in payment processing and subscription management.",
    apps=['stripe']  # All Stripe actions will be available
)

# Task to create a new customer
create_customer_task = Task(
    description="Create a new premium customer John Doe with email john.doe@example.com",
    agent=stripe_agent,
    expected_output="Customer created successfully with customer ID"
)

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

crew.kickoff()

مرجع حالات الاشتراك

فهم حالات الاشتراك:
  • incomplete - الاشتراك يتطلب طريقة دفع أو تأكيد الدفع
  • trialing - الاشتراك في فترة تجريبية
  • active - الاشتراك نشط وحالي
  • past_due - فشل الدفع لكن الاشتراك لا يزال نشطاً
  • canceled - تم إلغاء الاشتراك
  • unpaid - فشل الدفع والاشتراك لم يعد نشطاً
يمكّن هذا التكامل أتمتة شاملة لإدارة المدفوعات والاشتراكات، مما يسمح لوكلاء الذكاء الاصطناعي بالتعامل مع عمليات الفوترة بسلاسة ضمن نظام Stripe البيئي.