تكامل Microsoft Teams

نظرة عامة

مكّن وكلاءك من الوصول إلى بيانات 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. إعداد متغير البيئة

Note

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

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

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

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

microsoft_teams/get_teams

الوصف: الحصول على جميع الفرق التي ينتمي إليها المستخدم.

المعاملات:

• لا توجد معاملات مطلوبة.

microsoft_teams/get_channels

الوصف: الحصول على القنوات في فريق محدد.

المعاملات:

• team_id (string, مطلوب): معرّف الفريق.

microsoft_teams/send_message

الوصف: إرسال رسالة إلى قناة Teams.

المعاملات:

• team_id (string, مطلوب): معرّف الفريق.
• channel_id (string, مطلوب): معرّف القناة.
• message (string, مطلوب): محتوى الرسالة.
• content_type (string, اختياري): نوع المحتوى (html أو text). الافتراضي: text.

microsoft_teams/get_messages

الوصف: الحصول على الرسائل من قناة Teams.

المعاملات:

• team_id (string, مطلوب): معرّف الفريق.
• channel_id (string, مطلوب): معرّف القناة.
• top (integer, اختياري): عدد الرسائل (الحد الأقصى 50). الافتراضي: 20.

microsoft_teams/create_meeting

الوصف: إنشاء اجتماع Teams.

المعاملات:

• subject (string, مطلوب): موضوع/عنوان الاجتماع.
• startDateTime (string, مطلوب): وقت بداية الاجتماع (صيغة ISO 8601 مع المنطقة الزمنية).
• endDateTime (string, مطلوب): وقت نهاية الاجتماع (صيغة ISO 8601 مع المنطقة الزمنية).

microsoft_teams/get_team_members

الوصف: الحصول على أعضاء فريق محدد.

المعاملات:

• team_id (string, مطلوب): المعرّف الفريد للفريق.
• top (integer, اختياري): الحد الأقصى لعدد الأعضاء (1-999). الافتراضي: 100.

microsoft_teams/create_channel

الوصف: إنشاء قناة جديدة في فريق.

المعاملات:

• team_id (string, مطلوب): المعرّف الفريد للفريق.
• display_name (string, مطلوب): اسم القناة. الحد الأقصى 50 حرفاً.
• description (string, اختياري): وصف اختياري يشرح غرض القناة.
• membership_type (string, اختياري): ظهور القناة. القيم: standard, private. الافتراضي: standard.

microsoft_teams/reply_to_message

الوصف: الرد على رسالة في قناة Teams.

المعاملات:

• team_id (string, مطلوب): المعرّف الفريد للفريق.
• channel_id (string, مطلوب): المعرّف الفريد للقناة.
• message_id (string, مطلوب): المعرّف الفريد للرسالة المراد الرد عليها.
• message (string, مطلوب): محتوى الرد.
• content_type (string, اختياري): صيغة المحتوى. القيم: html, text. الافتراضي: text.

microsoft_teams/update_meeting

الوصف: تحديث اجتماع عبر الإنترنت موجود.

المعاملات:

• meeting_id (string, مطلوب): المعرّف الفريد للاجتماع.
• subject (string, اختياري): عنوان الاجتماع الجديد.
• startDateTime (string, اختياري): وقت البداية الجديد بصيغة ISO 8601.
• endDateTime (string, اختياري): وقت النهاية الجديد بصيغة ISO 8601.

microsoft_teams/delete_meeting

الوصف: حذف اجتماع عبر الإنترنت.

المعاملات:

• 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 أو استكشاف الأخطاء وإصلاحها.