مرجع البريد (معاينة)

ملحوظة

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

مهم

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

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

نظرة عامة

مُعرف خادم	عنوان URL على مستوى المستأجر	‏‫اسم العرض‬	وصف
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	البريد	أدوات لعمليات البريد الإلكتروني في Microsoft Graph، بما في ذلك إنشاء وإرسال ورد وإدارة رسائل البريد الإلكتروني.

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

mcp_MailTools_graph_mail_createMessage

إنشاء مسودة بريد إلكتروني. يدعم HTML عن طريق تعيين body.body.contentType = "HTML".

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

• موضوع: موضوع الرسالة
• toRecipients: صفيف من المستلمين مع عناوين البريد الإلكتروني
• الجسم: نص الرسالة مع نوع المحتوى (Text/HTML) والمحتوى

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

• تعيين تفضيلات HTML: يضبط على 'صحيح' لمحتوى HTML
• رؤوس: عناوين إضافية اختيارية

mcp_MailTools_graph_mail_deleteMessage (حذف رسالة)

حذف رسالة من علبة بريد المستخدم الذي سجل الدخول.

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

• معرف: معرف الرسالة

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

• If-Match: اختياري ETag للتحكم في التزامن

mcp_MailTools_graph_mail_getMessage

يحصل على رسالة حسب المعرف من علبة بريد المستخدم الذي قام بتسجيل الدخول. استخدم preferHtml لطلب جسم HTML.

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

• معرف: معرف الرسالة

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

• اختيار: عبارة اختيار OData
• الامتداد: عبارة التوسيع في OData
• تفضيل Html: تعيين تنسيق نص HTML
• رؤوس: رؤوس HTTP اختيارية

mcp_MailTools_graph_mail_قائمة_المرسلة

ادرج الرسائل في العناصر المرسلة.

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

• تصفية: عامل تصفية OData
• بحث: استعلام البحث
• orderby: تعبير الفرز
• أعلى: عدد العناصر المراد إرجاعها
• اختار: الحقول المراد إرجاعها

mcp_MailTools_graph_mail_reply (أداة الرد على البريد الإلكتروني في الجرافيك)

قم بإرسال رد على رسالة موجودة. يدعم HTML عبر preferHtml أو headers.

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

• معرف: معرف الرسالة للرد عليه

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

• التعليق: نص الرد
• رسالة: تجاوزات الرسائل الاختيارية
• تفضيلHtml: تمكين تنسيق HTML
• رؤوس: رؤوس HTTP اختيارية

mcp_MailTools_graph_mail_replyAll

قم بإرسال رد على كل رسالة موجودة. يدعم HTML عبر preferHtml أو headers.

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

• معرف: معرف الرسالة للرد على الكل

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

• التعليق: نص الرد
• رسالة: تجاوزات الرسائل الاختيارية
• تفضيلHtml: تمكين تنسيق HTML
• رؤوس: رؤوس HTTP اختيارية

mcp_MailTools_graph_mail_searchMessages

ابحث في رسائل البريد الإلكتروني في Outlook باستخدام واجهة برمجة تطبيقات بحث Microsoft Graph مع استعلامات بنمط لغة استعلام الكلمات المفتاحية (KQL).

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

• الطلبات: مصفوفة من طلبات البحث مع معاملات: استعلام، من، حجم

يدعم البحث في محتوى الرسالة والموضوع والنص الأساسي والمرفقات

mcp_MailTools_graph_mail_sendDraft

قم بإرسال مسودة رسالة موجودة حسب المُعرف.

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

• معرف: معرف الرسالة المسودة لإرساله

إم. سي. بي_أدوات البريد_الرسم البياني للبريد_إرسال بريد

قم بإرسال بريد إلكتروني كالمستخدم الذي قام بتسجيل الدخول.

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

• رسالة: كائن الرسالة مع الموضوع وtoRecipients والجسم
• موضوع: موضوع البريد الإلكتروني
• toRecipients: المستلمون الأساسيون
• المحتوى: نص البريد الإلكتروني مع contentType (Text/HTML) والمحتوى

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

• ccRecipients: مستلمو النسخة الكربونية
• المصادقون: مستلمو النسخة المخفية
• حفظ العناصر المرسلة: احفظ إلى العناصر المرسلة (الافتراضي: صحيح)
• تفضيلHtml: فرض عرض HTML
• رؤوس: عناوين HTTP إضافية اختيارية

10. mcp_MailTools_graph_mail_updateMessage

يحدّث الخصائص القابلة للتعديل للرسالة، مثل الموضوع والمحتوى والفئات.

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

• معرف: معرف الرسالة

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

• موضوع: موضوع جديد
• جسم: نص الرسالة الجديد
• فئات: فئات الرسائل
• اهميه: منخفض أو عادي أو مرتفع
• المطابقة إذا:ETag للتحكم في التزامن

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

تكوين البريد الإلكتروني

• إنشاء مسودات وإرسال رسائل البريد الإلكتروني
• دعم HTML والنص العادي
• إلى ومستلمو النسخة الكربونية والنسخة المخفية
• خيارات تنسيق متقدمة

إدارة البريد الإلكتروني

• الحصول على الرسائل وتحديثها وحذفها.
• إمكانية الرد والرد على الكل.
• إدارة المسودة.
• إعدادات الفئة والأهمية.

البحث والتصفية

• البحث عن الرسائل على غرار KQL.
• دعم استعلام OData.
• البحث عبر الموضوع والنص والمرفقات.
• ترقيم الصفحات والتصفية.

Sentitems

• سرد الرسائل المرسلة.
• حفظ اختياري للعناصر المرسلة.
• تصفية العناصر المرسلة والبحث فيها.

ملاحظات

• تستخدم جميع العمليات Microsoft Graph Mail API.
• يتطلب محتوى HTML وجود contentType = "HTML" في المتن.
• preferHtml يطلب العنوان تنسيق نص HTML.
• يستخدم البحث Microsoft Graph Search API مع استعلامات KQL.
• يمكن إنشاء مسودة الرسائل وتحديثها وإرسالها بشكل منفصل.
• ETag دعم التحكم في التزامن على التحديثات.