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

نظرة عامة

مكّن وكلاءك من إدارة أحداث التقويم والجداول الزمنية والتوفر عبر Google Calendar. أنشئ الأحداث وحدّثها، وأدر الحضور، وتحقق من التوفر، وبسّط سير عمل الجدولة باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

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

إعداد تكامل Google Calendar

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

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

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

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

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

الإجراءات المتاحة

الوصف: الحصول على توفر التقويم (معلومات مشغول/متاح).المعاملات:
  • timeMin (string, مطلوب): وقت البداية (بصيغة RFC3339)
  • timeMax (string, مطلوب): وقت النهاية (بصيغة RFC3339)
  • items (array, مطلوب): معرّفات التقاويم المراد التحقق منها
  • timeZone (string, اختياري): المنطقة الزمنية المستخدمة في الاستجابة. الافتراضي هو UTC.
  • groupExpansionMax (integer, اختياري): الحد الأقصى لعدد معرّفات التقاويم لمجموعة واحدة. الحد الأقصى: 100
  • calendarExpansionMax (integer, اختياري): الحد الأقصى لعدد التقاويم لتقديم معلومات التوفر. الحد الأقصى: 50
الوصف: إنشاء حدث جديد في التقويم المحدد.المعاملات:
  • calendarId (string, مطلوب): معرّف التقويم (استخدم ‘primary’ للتقويم الرئيسي)
  • summary (string, مطلوب): عنوان/ملخص الحدث
  • start_dateTime (string, مطلوب): وقت البداية بصيغة RFC3339 (مثال: 2024-01-20T10:00:00-07:00)
  • end_dateTime (string, مطلوب): وقت النهاية بصيغة RFC3339
  • description (string, اختياري): وصف الحدث
  • timeZone (string, اختياري): المنطقة الزمنية (مثال: America/Los_Angeles)
  • location (string, اختياري): الموقع الجغرافي للحدث كنص حر.
  • attendees (array, اختياري): قائمة الحضور للحدث.
  • reminders (object, اختياري): معلومات حول تذكيرات الحدث.
  • conferenceData (object, اختياري): المعلومات المتعلقة بالمؤتمر، مثل تفاصيل مؤتمر Google Meet.
  • visibility (string, اختياري): ظهور الحدث. الخيارات: default, public, private, confidential. الافتراضي: default
  • transparency (string, اختياري): ما إذا كان الحدث يحجب الوقت في التقويم. الخيارات: opaque, transparent. الافتراضي: opaque
الوصف: استرجاع الأحداث للتقويم المحدد.المعاملات:
  • calendarId (string, مطلوب): معرّف التقويم (استخدم ‘primary’ للتقويم الرئيسي)
  • timeMin (string, اختياري): الحد الأدنى للأحداث (بصيغة RFC3339)
  • timeMax (string, اختياري): الحد الأعلى للأحداث (بصيغة RFC3339)
  • maxResults (integer, اختياري): الحد الأقصى لعدد الأحداث (الافتراضي 10). الحد الأدنى: 1، الحد الأقصى: 2500
  • orderBy (string, اختياري): ترتيب الأحداث في النتيجة. الخيارات: startTime, updated. الافتراضي: startTime
  • singleEvents (boolean, اختياري): ما إذا كان يجب توسيع الأحداث المتكررة إلى نُسخ فردية. الافتراضي: true
  • showDeleted (boolean, اختياري): ما إذا كان يجب تضمين الأحداث المحذوفة. الافتراضي: false
  • showHiddenInvitations (boolean, اختياري): ما إذا كان يجب تضمين الدعوات المخفية. الافتراضي: false
  • q (string, اختياري): مصطلحات بحث نصية حرة للعثور على الأحداث المطابقة في أي حقل.
  • pageToken (string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.
  • timeZone (string, اختياري): المنطقة الزمنية المستخدمة في الاستجابة.
  • updatedMin (string, اختياري): الحد الأدنى لوقت آخر تعديل للحدث (بصيغة RFC3339) للتصفية.
  • iCalUID (string, اختياري): يحدد معرّف حدث بصيغة iCalendar ليتم تقديمه في الاستجابة.
الوصف: تحديث حدث موجود.المعاملات:
  • calendarId (string, مطلوب): معرّف التقويم
  • eventId (string, مطلوب): معرّف الحدث المراد تحديثه
  • summary (string, اختياري): عنوان الحدث المحدّث
  • description (string, اختياري): وصف الحدث المحدّث
  • start_dateTime (string, اختياري): وقت البداية المحدّث
  • end_dateTime (string, اختياري): وقت النهاية المحدّث
الوصف: حذف حدث محدد.المعاملات:
  • calendarId (string, مطلوب): معرّف التقويم
  • eventId (string, مطلوب): معرّف الحدث المراد حذفه
الوصف: استرجاع قائمة تقاويم المستخدم.المعاملات:
  • maxResults (integer, اختياري): الحد الأقصى لعدد الإدخالات في صفحة نتائج واحدة. الحد الأدنى: 1
  • pageToken (string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.
  • showDeleted (boolean, اختياري): ما إذا كان يجب تضمين إدخالات قائمة التقويم المحذوفة. الافتراضي: false
  • showHidden (boolean, اختياري): ما إذا كان يجب عرض الإدخالات المخفية. الافتراضي: false
  • minAccessRole (string, اختياري): الحد الأدنى لدور الوصول للمستخدم. الخيارات: freeBusyReader, owner, reader, writer

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

إعداد Agent أساسي للتقويم

تصفية أدوات التقويم المحددة

إدارة الأحداث وتحديثاتها

التوفر وإدارة التقويم

سير عمل الجدولة الآلية

استكشاف الأخطاء وإصلاحها

المشاكل الشائعة

أخطاء المصادقة
  • تأكد من أن حساب Google الخاص بك لديه الصلاحيات اللازمة للوصول إلى التقويم
  • تحقق من أن اتصال OAuth يتضمن جميع النطاقات المطلوبة لـ Google Calendar API
  • تحقق مما إذا كانت إعدادات مشاركة التقويم تسمح بمستوى الوصول المطلوب
مشاكل إنشاء الأحداث
  • تحقق من صحة صيغ الوقت (صيغة RFC3339)
  • تأكد من صحة صيغة عناوين البريد الإلكتروني للحضور
  • تحقق من وجود التقويم المستهدف وإمكانية الوصول إليه
  • تحقق من صحة تحديد المناطق الزمنية
التوفر وتعارضات الوقت
  • استخدم صيغة RFC3339 المناسبة لنطاقات الوقت عند التحقق من التوفر
  • تأكد من اتساق المناطق الزمنية عبر جميع العمليات
  • تحقق من صحة معرّفات التقاويم عند التحقق من تقاويم متعددة
تحديث الأحداث وحذفها
  • تحقق من صحة معرّفات الأحداث ووجودها
  • تأكد من أن لديك صلاحيات التحرير للأحداث
  • تحقق من أن ملكية التقويم تسمح بالتعديلات

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

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

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