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

​
نظرة عامة

مكّن وكلاءك من الوصول إلى رسائل Outlook الإلكترونية وأحداث التقويم وجهات الاتصال وإدارتها. أرسل رسائل البريد الإلكتروني، واسترجع الرسائل، وأدر أحداث التقويم، ونظّم جهات الاتصال باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

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

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

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

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

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

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

الوصف: الحصول على رسائل البريد الإلكتروني من صندوق بريد المستخدم.المعاملات:
  • top (integer, اختياري): عدد الرسائل (الحد الأقصى 1000). الافتراضي: 10.
  • filter (string, اختياري): تعبير فلتر OData (مثال: “isRead eq false”).
  • search (string, اختياري): سلسلة استعلام البحث.
  • orderby (string, اختياري): الترتيب (مثال: “receivedDateTime desc”). الافتراضي: “receivedDateTime desc”.
الوصف: إرسال رسالة بريد إلكتروني.المعاملات:
  • to_recipients (array, مطلوب): مصفوفة عناوين المستلمين.
  • subject (string, مطلوب): موضوع البريد الإلكتروني.
  • body (string, مطلوب): محتوى البريد الإلكتروني.
  • body_type (string, اختياري): نوع المحتوى. القيم: Text, HTML. الافتراضي: HTML.
  • importance (string, اختياري): مستوى الأهمية. القيم: low, normal, high. الافتراضي: normal.
  • cc_recipients (array, اختياري): مصفوفة عناوين النسخة الكربونية.
الوصف: الحصول على أحداث التقويم من تقويم المستخدم.المعاملات:
  • top (integer, اختياري): عدد الأحداث (الحد الأقصى 1000). الافتراضي: 10.
  • filter (string, اختياري): تعبير فلتر OData.
  • orderby (string, اختياري): الترتيب. الافتراضي: “start/dateTime asc”.
الوصف: إنشاء حدث تقويم جديد.المعاملات:
  • subject (string, مطلوب): موضوع/عنوان الحدث.
  • start_datetime (string, مطلوب): وقت البداية بصيغة ISO 8601.
  • end_datetime (string, مطلوب): وقت النهاية بصيغة ISO 8601.
  • timezone (string, اختياري): المنطقة الزمنية. الافتراضي: UTC.
  • location (string, اختياري): موقع الحدث.
  • attendees (array, اختياري): مصفوفة عناوين الحضور.
الوصف: الحصول على جهات الاتصال من دفتر عناوين المستخدم.المعاملات:
  • top (integer, اختياري): عدد جهات الاتصال (الحد الأقصى 1000). الافتراضي: 10.
  • filter (string, اختياري): تعبير فلتر OData.
الوصف: إنشاء جهة اتصال جديدة في دفتر عناوين المستخدم.المعاملات:
  • displayName (string, مطلوب): اسم العرض لجهة الاتصال.
  • givenName (string, اختياري): الاسم الأول.
  • surname (string, اختياري): اسم العائلة.
  • emailAddresses (array, اختياري): مصفوفة عناوين البريد الإلكتروني.
  • jobTitle (string, اختياري): المسمى الوظيفي.
  • companyName (string, اختياري): اسم الشركة.
الوصف: الرد على رسالة بريد إلكتروني.المعاملات:
  • message_id (string, مطلوب): المعرّف الفريد للرسالة المراد الرد عليها.
  • comment (string, مطلوب): محتوى الرد.
الوصف: إعادة توجيه رسالة بريد إلكتروني.المعاملات:
  • message_id (string, مطلوب): المعرّف الفريد للرسالة المراد إعادة توجيهها.
  • to_recipients (array, مطلوب): مصفوفة عناوين المستلمين.
  • comment (string, اختياري): رسالة اختيارية لتضمينها فوق المحتوى المُعاد توجيهه.
الوصف: حذف رسالة بريد إلكتروني.المعاملات:
  • message_id (string, مطلوب): المعرّف الفريد للرسالة المراد حذفها.
الوصف: تحديث حدث تقويم موجود.المعاملات:
  • event_id (string, مطلوب): المعرّف الفريد للحدث.
  • subject (string, اختياري): الموضوع/العنوان الجديد.
  • start_time (string, اختياري): وقت البداية الجديد بصيغة ISO 8601.
  • location (string, اختياري): الموقع الجديد.
الوصف: حذف حدث تقويم.المعاملات:
  • event_id (string, مطلوب): المعرّف الفريد للحدث المراد حذفه.

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

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

from crewai import Agent, Task, Crew

# Create an agent with Microsoft Outlook capabilities
outlook_agent = Agent(
    role="Email Assistant",
    goal="Manage emails, calendar events, and contacts efficiently",
    backstory="An AI assistant specialized in Microsoft Outlook operations and communication management.",
    apps=['microsoft_outlook']  # All Outlook actions will be available
)

# Task to send an email
send_email_task = Task(
    description="Send an email to 'colleague@example.com' with subject 'Project Update' and body 'Hi, here is the latest project update. Best regards.'",
    agent=outlook_agent,
    expected_output="Email sent successfully to colleague@example.com"
)

# Run the task
crew = Crew(
    agents=[outlook_agent],
    tasks=[send_email_task]
)

crew.kickoff()

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

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

أخطاء المصادقة
  • تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات اللازمة للوصول إلى البريد والتقويم وجهات الاتصال.
  • النطاقات المطلوبة تشمل: Mail.Read, Mail.Send, Calendars.ReadWrite, Contacts.ReadWrite.
مشاكل إرسال البريد الإلكتروني
  • تأكد من توفير to_recipients وsubject وbody لـ send_email.
  • تحقق من صحة صيغة عناوين البريد الإلكتروني.
إنشاء أحداث التقويم
  • تأكد من توفير subject وstart_datetime وend_datetime.
  • استخدم صيغة ISO 8601 المناسبة لحقول التاريخ والوقت.

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

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

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