مرجع التقويم (معاينة)

ملحوظة

تصف هذه المقالة الميزات المستخدمة في الوكلاء أو تدفقات الوكلاء التي تعمل بواسطة الحزام القياسي.

مهم

هذه ميزة إصدار أولي.

• Microsoft إصدارات ميزات المعاينة قبل إصدار رسمي بحيث يمكن للعملاء الوصول المبكر وتقديم الملاحظات.
• تحتوي ميزات المعاينة على وظائف مقيدة ولا يقصد بها استخدام الإنتاج.
• قد تُجري مايكروسوفت تغييرات على أسماء ومعلمات أدوات المعاينة MCP. تجنب التبعيات المشفرة. يحتفظ Microsoft بدعم السيناريو.
• تخضع ميزات المعاينة لشروط الاستخدام الإضافية Microsoft.

نظرة عامة

مُعرف خادم	عنوان URL على مستوى المستأجر	‏‫اسم العرض‬	وصف
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	التقويم	أدوات لعمليات التقويم مثل الإنشاء، والتحديث، واسترجاع الفعاليات، وإدارة الدعوات، والتحقق من التوفر.

الأدوات المتوفرة

mcp_CalendarTools_graph_قبول_الحدث

قبول دعوة الحدث المحددة في تقويم المستخدم.

المعلمات المطلوبة:

• eventId: معرف الحدث الذي يجب قبوله

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• تعليق: نص اختياري مضمن في الاستجابة
• sendResponse: ما إذا كان يجب إرسال استجابة إلى المنظم

mcp_CalendarTools_graph_cancelEvent

قم بإلغاء حدث في تقويم مستخدم محدد وإعلام الحضور.

المعلمات المطلوبة:

• eventId: المعرف الفريد للحدث الذي يجب إلغاؤه

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• تعليق: رسالة إلغاء اختيارية

mcp_CalendarTools_graph_createEvent

إنشاء حدث تقويم جديد في تقويم مستخدم محدد. يدعم الأحداث المتكررة والاجتماعات عبر الإنترنت.

المعلمات المطلوبة:

• الموضوع: موضوع الحدث أو العنوان (nonempty)
• البدء: بدء الطابع الزمني باستخدام dateTime و timeZone
• end: وقت انتهاء مع dateTime و timeZone
• attendees_addresses: صفيف عناوين البريد الإلكتروني للحضور

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• النص الأساسي: نص الحدث مع contentType (نص/HTML) والمحتوى
• الموقع: الموقع باستخدام displayName
• attendees_types: أدوار الحضور (مطلوب، اختياري، مورد)
• attendees_names: عرض أسماء الحضور
• التكرار: نمط التكرار والنطاق
• isOnlineMeeting: تعيين إلى "صواب" للاجتماع عبر الإنترنت
• onlineMeetingProvider: teamsForBusiness، ، skypeForBusinessskypeForConsumer
• allowNewTimeProposals: السماح باقتراحات الوقت (الافتراضي: صحيح)
• transactionId: Idempotence المعرف

mcp_CalendarTools_graph_declineEvent

رفض دعوة الحدث المحددة في تقويم المستخدم.

المعلمات المطلوبة:

• eventId: معرف الحدث المراد رفضه

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName

• تعليق: نص اختياري استجابة

• sendResponse: ما إذا كنت تريد إرسال استجابة

mcp_CalendarTools_graph_deleteEvent

حذف حدث من تقويم مستخدم محدد.

المعلمات المطلوبة:

• eventId: المعرف الفريد للحدث المراد حذفه

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes (وظيفة أو أداة للعثور على أوقات الاجتماعات في واجهة التقويم)

اقتراح أوقات الاجتماعات ومواقعها استنادا إلى توفر المنظم والحضور.

المعلمات المطلوبة:

• meetingDuration: مدة الاجتماع (على سبيل المثال، 'PT1H')

المعلمات الاختيارية:

• معرف المستخدم: معرف المنظم أو userPrincipalName
• attendees_addresses: عناوين البريد الإلكتروني للحضور
• attendees_types: أنواع الحضور
• attendees_names: عرض أسماء الحضور
• timeConstraint: توفر الوقت مع timeslots و activityDomain
• locationConstraint: خيارات الموقع
• maxCandidates: الحد الأقصى للاقتراحات
• isOrganizerOptional: علامة المنظم الاختيارية
• returnSuggestionReasons: تضمين الأسباب
• minimumAttendeePercentage: حد الحضور الأدنى

mcp_CalendarTools_graph_getEvent

احصل على حدث تقويم واحد من تقويم مستخدم محدد.

المعلمات المطلوبة:

• eventId: المعرف الفريد للحدث

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• حدد: معلمة استعلام\$select ‏OData
• توسيع: OData \$expand لخصائص التنقل

mcp_CalendarTools_graph_getSchedule

احصل على جدول الانشغال/الفراغ للمستخدم أو قائمة التوزيع أو المورد.

المعلمات المطلوبة:

• الجداول الزمنية: عناوين SMTP للمستخدمين أو الموارد
• startTime: وقت البدء باستخدام dateTime و timeZone
• وقت الانتهاء: وقت الانتهاء باستخدام dateTime و timeZone

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• availabilityViewInterval: طول فتحة الوقت بالدقائق

mcp_CalendarTools_graph_listCalendarView (أدوات التقويم_الرسوم البيانية_عرض قائمة التقويم)

استرداد تكرارات التقويم ضمن نطاق زمني محدد لمستخدم.

المعلمات المطلوبة:

• startDateTime: بداية النطاق الزمني (ISO 8601)
• endDateTime: نهاية النطاق الزمني (ISO 8601)

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• أعلى: الحد الأقصى لعدد الأحداث
• orderby: عبارة Order By

mcp_CalendarTools_graph_listEvents

استرداد قائمة الأحداث من تقويم مستخدم محدد.

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• startDateTime: بداية النطاق الزمني (ISO 8601)
• endDateTime: نهاية النطاق الزمني (ISO 8601)
• أعلى: الحد الأقصى لعدد الأحداث
• عامل التصفية: استعلام عامل تصفية OData
• orderby: ترتيب OData حسب الاستعلام

mcp_CalendarTools_graph_updateEvent

تحديث حدث تقويم موجود في تقويم مستخدم محدد.

المعلمات المطلوبة:

• eventId: المعرف الفريد للحدث

المعلمات الاختيارية:

• معرف المستخدم: معرف المستخدم أو userPrincipalName
• الموضوع: الموضوع المحدث
• النص الأساسي: محتوى النص الأساسي المحدث
• البدء: وقت البدء المحدث
• end: وقت الانتهاء المحدث
• الموقع: الموقع المحدث
• attendees_addresses: رسائل البريد الإلكتروني للحضور المحدثة
• attendees_types: أنواع الحضور المحدثة
• attendees_names: أسماء الحضور المحدثة
• isCancelled: تعيين إلى "صحيح" لإلغاء الأمر
• التكرار: نمط التكرار المحدث

الميزات الرئيسية

إدارة الأحداث

• أنشئ الأحداث واقرأها وحدّثها واحذفها.
• اقبل الدعوات ورفضها وألغها.
• دعم الأحداث المتكررة.
• التكامل مع الاجتماعات عبر الإنترنت (Teams، Skype).

التوفر والجدولة

• احصل على جداول حرة أو مزدحمة.
• ابحث عن أوقات الاجتماعات مع التحقق من التوفر.
• عرض التقويم مع تصفية النطاق الزمني.
• تحليل توفر الحضور.

إدارة الحضور

• إدارة الحضور المطلوبين والاختياريين والموارد.
• دعم مقترحات الوقت
• تتبع الردود.
• دعم قوائم التوزيع.

أنماط التكرار

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

الاجتماعات عبر الإنترنت

• التكامل مع Microsoft Teams للشركات
• دعم Skype for Business
• دعم Skype (للاستخدام الشخصي)
• إنشاء ارتباط اجتماع تلقائي

ملاحظات

• تستخدم جميع الطوابع الزمنية تنسيق UTC/ISO 8601 مع المنطقة الزمنية
• يعتمد تقويم MCP على UserprofileMCP في العثور على المستخدمين داخل المنظمة
• يجب أن تكون عناوين البريد الإلكتروني بتنسيق صالح
• يجب أن تكون صفائف الحضور (العناوين والأنواع والأسماء) بالترتيب نفسه
• الاجتماعات عبر الإنترنت تتطلب isOnlineMeeting=true و onlineMeetingProvider
• يتطلب التكرار كائني النمط والنطاق
• يجب أن تكون المناطق الزمنية متسقة عبر أوقات البدء والانتهاء
• يمكن TransactionId من إنشاء الحدث idempotent