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

​
نظرة عامة

مكّن وكلاءك من الوصول إلى بيانات Teams وإرسال الرسائل وإنشاء الاجتماعات وإدارة القنوات. أتمت التواصل الجماعي، وجدوِل الاجتماعات، واسترجع الرسائل، وبسّط سير عمل التعاون باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

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

​
إعداد تكامل Microsoft Teams

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

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

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

الوصف: الحصول على جميع الفرق التي ينتمي إليها المستخدم.المعاملات:
  • لا توجد معاملات مطلوبة.
الوصف: الحصول على القنوات في فريق محدد.المعاملات:
  • team_id (string, مطلوب): معرّف الفريق.
الوصف: إرسال رسالة إلى قناة Teams.المعاملات:
  • team_id (string, مطلوب): معرّف الفريق.
  • channel_id (string, مطلوب): معرّف القناة.
  • message (string, مطلوب): محتوى الرسالة.
  • content_type (string, اختياري): نوع المحتوى (html أو text). الافتراضي: text.
الوصف: الحصول على الرسائل من قناة Teams.المعاملات:
  • team_id (string, مطلوب): معرّف الفريق.
  • channel_id (string, مطلوب): معرّف القناة.
  • top (integer, اختياري): عدد الرسائل (الحد الأقصى 50). الافتراضي: 20.
الوصف: إنشاء اجتماع Teams.المعاملات:
  • subject (string, مطلوب): موضوع/عنوان الاجتماع.
  • startDateTime (string, مطلوب): وقت بداية الاجتماع (صيغة ISO 8601 مع المنطقة الزمنية).
  • endDateTime (string, مطلوب): وقت نهاية الاجتماع (صيغة ISO 8601 مع المنطقة الزمنية).
الوصف: الحصول على أعضاء فريق محدد.المعاملات:
  • team_id (string, مطلوب): المعرّف الفريد للفريق.
  • top (integer, اختياري): الحد الأقصى لعدد الأعضاء (1-999). الافتراضي: 100.
الوصف: إنشاء قناة جديدة في فريق.المعاملات:
  • team_id (string, مطلوب): المعرّف الفريد للفريق.
  • display_name (string, مطلوب): اسم القناة. الحد الأقصى 50 حرفاً.
  • description (string, اختياري): وصف اختياري يشرح غرض القناة.
  • membership_type (string, اختياري): ظهور القناة. القيم: standard, private. الافتراضي: standard.
الوصف: الرد على رسالة في قناة Teams.المعاملات:
  • team_id (string, مطلوب): المعرّف الفريد للفريق.
  • channel_id (string, مطلوب): المعرّف الفريد للقناة.
  • message_id (string, مطلوب): المعرّف الفريد للرسالة المراد الرد عليها.
  • message (string, مطلوب): محتوى الرد.
  • content_type (string, اختياري): صيغة المحتوى. القيم: html, text. الافتراضي: text.
الوصف: تحديث اجتماع عبر الإنترنت موجود.المعاملات:
  • meeting_id (string, مطلوب): المعرّف الفريد للاجتماع.
  • subject (string, اختياري): عنوان الاجتماع الجديد.
  • startDateTime (string, اختياري): وقت البداية الجديد بصيغة ISO 8601.
  • endDateTime (string, اختياري): وقت النهاية الجديد بصيغة ISO 8601.
الوصف: حذف اجتماع عبر الإنترنت.المعاملات:
  • meeting_id (string, مطلوب): المعرّف الفريد للاجتماع المراد حذفه.

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

​
إعداد Agent أساسي لـ Microsoft Teams

from crewai import Agent, Task, Crew

# Create an agent with Microsoft Teams capabilities
teams_agent = Agent(
    role="Teams Coordinator",
    goal="Manage Teams communication and meetings efficiently",
    backstory="An AI assistant specialized in Microsoft Teams operations and team collaboration.",
    apps=['microsoft_teams']  # All Teams actions will be available
)

# Task to list teams and channels
explore_teams_task = Task(
    description="List all teams I'm a member of and then get the channels for the first team.",
    agent=teams_agent,
    expected_output="List of teams and channels displayed."
)

# Run the task
crew = Crew(
    agents=[teams_agent],
    tasks=[explore_teams_task]
)

crew.kickoff()

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

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

أخطاء المصادقة
  • تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات اللازمة للوصول إلى Teams.
  • النطاقات المطلوبة تشمل: Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send, OnlineMeetings.ReadWrite.
إنشاء الاجتماعات
  • تأكد من توفير subject وstartDateTime وendDateTime.
  • استخدم صيغة ISO 8601 مع المنطقة الزمنية لحقول التاريخ والوقت.

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

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

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