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

نظرة عامة

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

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

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

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

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

  1. انتقل إلى تكاملات CrewAI AMP
  2. ابحث عن Google Slides في قسم تكاملات المصادقة
  3. انقر على Connect وأكمل عملية OAuth
  4. امنح الصلاحيات اللازمة للوصول إلى العروض التقديمية وجداول البيانات وDrive
  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

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

الوصف: إنشاء عرض تقديمي فارغ بدون محتوى.المعاملات:
  • title (string, مطلوب): عنوان العرض التقديمي.
الوصف: الحصول على بيانات وصفية خفيفة حول العرض التقديمي (العنوان، عدد الشرائح، معرّفات الشرائح).المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي المراد استرجاعه.
الوصف: استخراج جميع المحتوى النصي من العرض التقديمي.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
الوصف: استرجاع عرض تقديمي بواسطة المعرّف.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي المراد استرجاعه.
  • fields (string, اختياري): الحقول المراد تضمينها في الاستجابة.
الوصف: تطبيق التحديثات أو إضافة المحتوى أو إزالته من العرض التقديمي.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي المراد تحديثه.
  • requests (array, مطلوب): قائمة بالتحديثات المراد تطبيقها.
    [
      {
        "insertText": {
          "objectId": "slide_id",
          "text": "Your text content here"
        }
      }
    ]
    
  • writeControl (object, اختياري): يوفر التحكم في كيفية تنفيذ طلبات الكتابة.
الوصف: استخراج المحتوى النصي من شريحة واحدة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • pageObjectId (string, مطلوب): معرّف الشريحة/الصفحة.
الوصف: استرجاع صفحة محددة بواسطة معرّفها.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • pageObjectId (string, مطلوب): معرّف الصفحة المراد استرجاعها.
الوصف: إنشاء صورة مصغرة للصفحة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • pageObjectId (string, مطلوب): معرّف الصفحة لإنشاء الصورة المصغرة.
الوصف: إضافة شريحة فارغة إضافية للعرض التقديمي.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • insertionIndex (integer, اختياري): مكان إدراج الشريحة (قائم على الصفر). إذا حُذف، تُضاف في النهاية.
الوصف: إنشاء شريحة بتخطيط محدد مسبقاً يحتوي على مناطق عناصر نائبة للعنوان والمحتوى وغيرها.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • layout (string, مطلوب): نوع التخطيط. أحد: BLANK, TITLE, TITLE_AND_BODY, TITLE_AND_TWO_COLUMNS, TITLE_ONLY, SECTION_HEADER, ONE_COLUMN_TEXT, MAIN_POINT, BIG_NUMBER.
  • insertionIndex (integer, اختياري): مكان الإدراج (قائم على الصفر). حُذف للإضافة في النهاية.
الوصف: إنشاء مربع نص على شريحة مع محتوى.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة لإضافة مربع النص إليها.
  • text (string, مطلوب): المحتوى النصي لمربع النص.
  • x (integer, اختياري): موضع X بوحدة EMU (914400 = 1 بوصة). الافتراضي: 914400.
  • y (integer, اختياري): موضع Y بوحدة EMU. الافتراضي: 914400.
  • width (integer, اختياري): العرض بوحدة EMU. الافتراضي: 7315200.
  • height (integer, اختياري): الارتفاع بوحدة EMU. الافتراضي: 914400.
الوصف: إزالة شريحة من العرض التقديمي.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة المراد حذفها.
الوصف: إنشاء نسخة من شريحة موجودة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة المراد تكرارها.
الوصف: إعادة ترتيب الشرائح بنقلها إلى موضع جديد.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideIds (array of strings, مطلوب): مصفوفة من معرّفات الشرائح المراد نقلها.
  • insertionIndex (integer, مطلوب): الموضع المستهدف (قائم على الصفر).
الوصف: تضمين فيديو YouTube على شريحة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة لإضافة الفيديو إليها.
  • videoId (string, مطلوب): معرّف فيديو YouTube (القيمة بعد v= في عنوان URL).
الوصف: تضمين فيديو من Google Drive على شريحة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة لإضافة الفيديو إليها.
  • fileId (string, مطلوب): معرّف ملف Google Drive للفيديو.
الوصف: تعيين صورة خلفية لشريحة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة لتعيين الخلفية لها.
  • imageUrl (string, مطلوب): عنوان URL المتاح للعموم للصورة المراد استخدامها كخلفية.
الوصف: إنشاء جدول فارغ على شريحة.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة لإضافة الجدول إليها.
  • rows (integer, مطلوب): عدد الصفوف في الجدول.
  • columns (integer, مطلوب): عدد الأعمدة في الجدول.
الوصف: إنشاء جدول مع محتوى في إجراء واحد.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • slideId (string, مطلوب): معرّف الشريحة لإضافة الجدول إليها.
  • rows (integer, مطلوب): عدد الصفوف في الجدول.
  • columns (integer, مطلوب): عدد الأعمدة في الجدول.
  • content (array, مطلوب): محتوى الجدول كمصفوفة ثنائية الأبعاد. مثال: [[“Year”, “Revenue”], [“2023”, “$10M”]].
الوصف: استيراد البيانات من Google Sheet إلى العرض التقديمي.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي.
  • sheetId (string, مطلوب): معرّف Google Sheet المراد الاستيراد منه.
  • dataRange (string, مطلوب): نطاق البيانات المراد استيرادها من الورقة.
الوصف: رفع ملف إلى Google Drive المرتبط بالعرض التقديمي.المعاملات:
  • file (string, مطلوب): بيانات الملف المراد رفعها.
  • presentationId (string, مطلوب): معرّف العرض التقديمي لربط الملف المرفوع.
الوصف: عرض قائمة بجميع العروض التقديمية المتاحة للمستخدم.المعاملات:
  • pageSize (integer, اختياري): عدد العروض التقديمية المراد إرجاعها لكل صفحة.
  • pageToken (string, اختياري): رمز للترقيم.
الوصف: حذف عرض تقديمي بواسطة المعرّف.المعاملات:
  • presentationId (string, مطلوب): معرّف العرض التقديمي المراد حذفه.

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

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

from crewai import Agent, Task, Crew

# Create an agent with Google Slides capabilities
slides_agent = Agent(
    role="Presentation Manager",
    goal="Create and manage presentations efficiently",
    backstory="An AI assistant specialized in presentation creation and content management.",
    apps=['google_slides']  # All Google Slides actions will be available
)

# Task to create a presentation
create_presentation_task = Task(
    description="Create a new presentation for the quarterly business review with key slides",
    agent=slides_agent,
    expected_output="Quarterly business review presentation created with structured content"
)

# Run the task
crew = Crew(
    agents=[slides_agent],
    tasks=[create_presentation_task]
)

crew.kickoff()

إدارة محتوى العروض التقديمية

from crewai import Agent, Task, Crew

content_manager = Agent(
    role="Content Manager",
    goal="Manage presentation content and updates",
    backstory="An AI assistant that focuses on content creation and presentation updates.",
    apps=[
        'google_slides/create_blank_presentation',
        'google_slides/batch_update_presentation',
        'google_slides/get_presentation'
    ]
)

# Task to create and update presentations
content_task = Task(
    description="Create a new presentation and add content slides with charts and text",
    agent=content_manager,
    expected_output="Presentation created with updated content and visual elements"
)

crew = Crew(
    agents=[content_manager],
    tasks=[content_task]
)

crew.kickoff()

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

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

أخطاء الصلاحيات
  • تأكد من أن حساب Google الخاص بك لديه الصلاحيات المناسبة لـ Google Slides
  • تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة للعروض التقديمية وجداول البيانات وDrive
مشاكل معرّف العرض التقديمي
  • تحقق من صحة معرّفات العروض التقديمية ووجودها
  • تأكد من أن لديك صلاحيات الوصول للعروض التقديمية التي تحاول تعديلها
مشاكل تحديث المحتوى
  • تأكد من صحة تنسيق طلبات التحديث الدفعي وفقاً لمواصفات Google Slides API
  • تحقق من وجود معرّفات الكائنات للشرائح والعناصر في العرض التقديمي

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

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

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