تكامل Notion

نظرة عامة

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

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

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

• حساب CrewAI AMP مع اشتراك فعّال
• حساب Notion بصلاحيات مساحة العمل المناسبة
• ربط حساب Notion الخاص بك عبر صفحة التكاملات

إعداد تكامل Notion

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

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

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

uv add crewai-tools

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

Note

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

أو أضفه إلى ملف .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

notion/list_users

الوصف: عرض جميع المستخدمين في مساحة العمل.

المعاملات:

• page_size (integer, اختياري): عدد العناصر في الاستجابة. الحد الأدنى: 1، الحد الأقصى: 100، الافتراضي: 100
• start_cursor (string, اختياري): مؤشر للترقيم.

notion/get_user

الوصف: استرجاع مستخدم محدد بواسطة المعرّف.

المعاملات:

• user_id (string, مطلوب): معرّف المستخدم المراد استرجاعه.

notion/create_comment

الوصف: إنشاء تعليق على صفحة أو مناقشة.

المعاملات:

• parent (object, مطلوب): الصفحة الأصلية أو المناقشة للتعليق عليها.

  {
    "type": "page_id",
    "page_id": "PAGE_ID_HERE"
  }

• rich_text (array, مطلوب): المحتوى النصي الغني للتعليق.

  [
    {
      "type": "text",
      "text": {
        "content": "This is my comment text"
      }
    }
  ]

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

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

from crewai import Agent, Task, Crew

# Create an agent with Notion capabilities
notion_agent = Agent(
    role="Workspace Manager",
    goal="Manage workspace users and facilitate collaboration through comments",
    backstory="An AI assistant specialized in user management and team collaboration.",
    apps=['notion']  # All Notion actions will be available
)

# Task to list workspace users
user_management_task = Task(
    description="List all users in the workspace and provide a summary of team members",
    agent=notion_agent,
    expected_output="Complete list of workspace users with their details"
)

# Run the task
crew = Crew(
    agents=[notion_agent],
    tasks=[user_management_task]
)

crew.kickoff()

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

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

أخطاء الصلاحيات

• تأكد من أن حساب Notion الخاص بك لديه الصلاحيات المناسبة لقراءة معلومات المستخدمين
• تحقق من أن لديك صلاحيات التعليق على الصفحات أو المناقشات المستهدفة

مشاكل إنشاء التعليقات

• تحقق من صحة معرّفات الصفحات أو المناقشات وإمكانية الوصول إليها
• تأكد من اتباع محتوى النص الغني لمواصفات صيغة Notion API

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

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

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