نظرة عامة
مكّن وكلاءك من إدارة أحداث التقويم والجداول الزمنية والتوفر عبر Google Calendar. أنشئ الأحداث وحدّثها، وأدر الحضور، وتحقق من التوفر، وبسّط سير عمل الجدولة باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Google Calendar، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Google مع إمكانية الوصول إلى Google Calendar
- ربط حساب Google الخاص بك عبر صفحة التكاملات
إعداد تكامل Google Calendar
1. ربط حساب Google الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Google Calendar في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة للوصول إلى التقويم
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
google_calendar/get_availability
google_calendar/get_availability
الوصف: الحصول على توفر التقويم (معلومات مشغول/متاح).المعاملات:
timeMin(string, مطلوب): وقت البداية (بصيغة RFC3339)timeMax(string, مطلوب): وقت النهاية (بصيغة RFC3339)items(array, مطلوب): معرّفات التقاويم المراد التحقق منهاtimeZone(string, اختياري): المنطقة الزمنية المستخدمة في الاستجابة. الافتراضي هو UTC.groupExpansionMax(integer, اختياري): الحد الأقصى لعدد معرّفات التقاويم لمجموعة واحدة. الحد الأقصى: 100calendarExpansionMax(integer, اختياري): الحد الأقصى لعدد التقاويم لتقديم معلومات التوفر. الحد الأقصى: 50
google_calendar/create_event
google_calendar/create_event
الوصف: إنشاء حدث جديد في التقويم المحدد.المعاملات:
calendarId(string, مطلوب): معرّف التقويم (استخدم ‘primary’ للتقويم الرئيسي)summary(string, مطلوب): عنوان/ملخص الحدثstart_dateTime(string, مطلوب): وقت البداية بصيغة RFC3339 (مثال: 2024-01-20T10:00:00-07:00)end_dateTime(string, مطلوب): وقت النهاية بصيغة RFC3339description(string, اختياري): وصف الحدثtimeZone(string, اختياري): المنطقة الزمنية (مثال: America/Los_Angeles)location(string, اختياري): الموقع الجغرافي للحدث كنص حر.attendees(array, اختياري): قائمة الحضور للحدث.reminders(object, اختياري): معلومات حول تذكيرات الحدث.conferenceData(object, اختياري): المعلومات المتعلقة بالمؤتمر، مثل تفاصيل مؤتمر Google Meet.visibility(string, اختياري): ظهور الحدث. الخيارات: default, public, private, confidential. الافتراضي: defaulttransparency(string, اختياري): ما إذا كان الحدث يحجب الوقت في التقويم. الخيارات: opaque, transparent. الافتراضي: opaque
google_calendar/view_events
google_calendar/view_events
الوصف: استرجاع الأحداث للتقويم المحدد.المعاملات:
calendarId(string, مطلوب): معرّف التقويم (استخدم ‘primary’ للتقويم الرئيسي)timeMin(string, اختياري): الحد الأدنى للأحداث (بصيغة RFC3339)timeMax(string, اختياري): الحد الأعلى للأحداث (بصيغة RFC3339)maxResults(integer, اختياري): الحد الأقصى لعدد الأحداث (الافتراضي 10). الحد الأدنى: 1، الحد الأقصى: 2500orderBy(string, اختياري): ترتيب الأحداث في النتيجة. الخيارات: startTime, updated. الافتراضي: startTimesingleEvents(boolean, اختياري): ما إذا كان يجب توسيع الأحداث المتكررة إلى نُسخ فردية. الافتراضي: trueshowDeleted(boolean, اختياري): ما إذا كان يجب تضمين الأحداث المحذوفة. الافتراضي: falseshowHiddenInvitations(boolean, اختياري): ما إذا كان يجب تضمين الدعوات المخفية. الافتراضي: falseq(string, اختياري): مصطلحات بحث نصية حرة للعثور على الأحداث المطابقة في أي حقل.pageToken(string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.timeZone(string, اختياري): المنطقة الزمنية المستخدمة في الاستجابة.updatedMin(string, اختياري): الحد الأدنى لوقت آخر تعديل للحدث (بصيغة RFC3339) للتصفية.iCalUID(string, اختياري): يحدد معرّف حدث بصيغة iCalendar ليتم تقديمه في الاستجابة.
google_calendar/update_event
google_calendar/update_event
الوصف: تحديث حدث موجود.المعاملات:
calendarId(string, مطلوب): معرّف التقويمeventId(string, مطلوب): معرّف الحدث المراد تحديثهsummary(string, اختياري): عنوان الحدث المحدّثdescription(string, اختياري): وصف الحدث المحدّثstart_dateTime(string, اختياري): وقت البداية المحدّثend_dateTime(string, اختياري): وقت النهاية المحدّث
google_calendar/delete_event
google_calendar/delete_event
الوصف: حذف حدث محدد.المعاملات:
calendarId(string, مطلوب): معرّف التقويمeventId(string, مطلوب): معرّف الحدث المراد حذفه
google_calendar/view_calendar_list
google_calendar/view_calendar_list
الوصف: استرجاع قائمة تقاويم المستخدم.المعاملات:
maxResults(integer, اختياري): الحد الأقصى لعدد الإدخالات في صفحة نتائج واحدة. الحد الأدنى: 1pageToken(string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.showDeleted(boolean, اختياري): ما إذا كان يجب تضمين إدخالات قائمة التقويم المحذوفة. الافتراضي: falseshowHidden(boolean, اختياري): ما إذا كان يجب عرض الإدخالات المخفية. الافتراضي: falseminAccessRole(string, اختياري): الحد الأدنى لدور الوصول للمستخدم. الخيارات: freeBusyReader, owner, reader, writer
أمثلة الاستخدام
إعداد Agent أساسي للتقويم
تصفية أدوات التقويم المحددة
إدارة الأحداث وتحديثاتها
التوفر وإدارة التقويم
سير عمل الجدولة الآلية
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة
أخطاء المصادقة- تأكد من أن حساب Google الخاص بك لديه الصلاحيات اللازمة للوصول إلى التقويم
- تحقق من أن اتصال OAuth يتضمن جميع النطاقات المطلوبة لـ Google Calendar API
- تحقق مما إذا كانت إعدادات مشاركة التقويم تسمح بمستوى الوصول المطلوب
- تحقق من صحة صيغ الوقت (صيغة RFC3339)
- تأكد من صحة صيغة عناوين البريد الإلكتروني للحضور
- تحقق من وجود التقويم المستهدف وإمكانية الوصول إليه
- تحقق من صحة تحديد المناطق الزمنية
- استخدم صيغة RFC3339 المناسبة لنطاقات الوقت عند التحقق من التوفر
- تأكد من اتساق المناطق الزمنية عبر جميع العمليات
- تحقق من صحة معرّفات التقاويم عند التحقق من تقاويم متعددة
- تحقق من صحة معرّفات الأحداث ووجودها
- تأكد من أن لديك صلاحيات التحرير للأحداث
- تحقق من أن ملكية التقويم تسمح بالتعديلات
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Google Calendar
أو استكشاف الأخطاء وإصلاحها.
