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

نظرة عامة

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

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

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

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

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

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

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

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

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

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

الوصف: استرجاع خصائص وبيانات جدول البيانات.المعاملات:
  • spreadsheetId (string, مطلوب): معرّف جدول البيانات المراد استرجاعه.
  • ranges (array, اختياري): النطاقات المراد استرجاعها من جدول البيانات.
  • includeGridData (boolean, اختياري): true إذا كان يجب إرجاع بيانات الشبكة. الافتراضي: false
  • fields (string, اختياري): الحقول المراد تضمينها في الاستجابة.
الوصف: إرجاع نطاق من القيم من جدول البيانات.المعاملات:
  • spreadsheetId (string, مطلوب): معرّف جدول البيانات المراد استرجاع البيانات منه.
  • range (string, مطلوب): ترميز A1 أو R1C1 للنطاق المراد استرجاع القيم منه.
  • valueRenderOption (string, اختياري): كيفية تمثيل القيم في الإخراج. الخيارات: FORMATTED_VALUE, UNFORMATTED_VALUE, FORMULA. الافتراضي: FORMATTED_VALUE
  • dateTimeRenderOption (string, اختياري): كيفية تمثيل التواريخ والأوقات في الإخراج. الخيارات: SERIAL_NUMBER, FORMATTED_STRING. الافتراضي: SERIAL_NUMBER
  • majorDimension (string, اختياري): البُعد الرئيسي للنتائج. الخيارات: ROWS, COLUMNS. الافتراضي: ROWS
الوصف: تعيين القيم في نطاق من جدول البيانات.المعاملات:
  • spreadsheetId (string, مطلوب): معرّف جدول البيانات المراد تحديثه.
  • range (string, مطلوب): ترميز A1 للنطاق المراد تحديثه.
  • values (array, مطلوب): البيانات المراد كتابتها. كل مصفوفة تمثل صفاً.
  • valueInputOption (string, اختياري): كيفية تفسير بيانات الإدخال. الخيارات: RAW, USER_ENTERED. الافتراضي: USER_ENTERED
الوصف: إلحاق قيم بجدول البيانات.المعاملات:
  • spreadsheetId (string, مطلوب): معرّف جدول البيانات المراد تحديثه.
  • range (string, مطلوب): ترميز A1 لنطاق البحث عن جدول بيانات منطقي.
  • values (array, مطلوب): البيانات المراد إلحاقها. كل مصفوفة تمثل صفاً.
  • valueInputOption (string, اختياري): كيفية تفسير بيانات الإدخال. الخيارات: RAW, USER_ENTERED. الافتراضي: USER_ENTERED
  • insertDataOption (string, اختياري): كيفية إدراج بيانات الإدخال. الخيارات: OVERWRITE, INSERT_ROWS. الافتراضي: INSERT_ROWS
الوصف: إنشاء جدول بيانات جديد.المعاملات:
  • title (string, مطلوب): عنوان جدول البيانات الجديد.
  • sheets (array, اختياري): الأوراق التي تشكل جزءاً من جدول البيانات.

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

إعداد Agent أساسي لـ Google Sheets

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

تحليل البيانات وإعداد التقارير

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

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

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

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

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

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