ईमेल संदर्भ (पूर्वावलोकन)

नोट

यह आलेख मानक हार्नेस द्वारा संचालित एजेंटों या एजेंट प्रवाह में उपयोग की जाने वाली सुविधाओं का वर्णन करता है।

महत्वपूर्ण

यह एक पूर्वावलोकन सुविधा है.

  • Microsoft आधिकारिक रिलीज़ से पहले पूर्वावलोकन सुविधाएँ रिलीज़ करता है ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.
  • पूर्वावलोकन सुविधाओं ने कार्यक्षमता को प्रतिबंधित कर दिया है और उत्पादन उपयोग के लिए नहीं हैं।
  • Microsoft पूर्वावलोकन MCP उपकरण नाम और पैरामीटर परिवर्तित कर सकता है. हार्ड-कोडेड निर्भरताओं से बचें। Microsoft परिदृश्य समर्थन बनाए रखता है।
  • पूर्वावलोकन सुविधाएँ Microsoft उपयोग की पूरक शर्तें के अधीन हैं।

नोट

एप्लिकेशन-विशिष्ट Microsoft 365 MCP उपकरण (Copilot, कैलेंडर, मेल, SharePoint, OneDrive, Teams, User, और Word) केवल पश्चगामी संगतता उद्देश्यों के लिए हैं और इनका उपयोग उत्पादन परिवेश या नए प्रोजेक्ट में नहीं किया जाना चाहिए। जिन नए प्रोजेक्ट्स के लिए Microsoft 365 संसाधनों तक पहुंच की आवश्यकता होती है, उनके लिए GitHub Copilot हार्नेस के साथ Work IQ MCP का उपयोग करें। अधिक जानकारी के लिए, Copilot Studio में Work IQ MCP देखें।

अवलोकन

सर्वर आईडी टेनेंट स्तर का यूआरएल प्रदर्शित होने वाला नाम विवरण
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools		 मेल Microsoft Graph मेल कार्रवाइयों के लिए उपकरण, जिनमें ईमेल संदेश बनाना, भेजना, उत्तर देना और प्रबंधित करना शामिल है.

उपलब्ध उपकरण

mcp_MailTools_graph_mail_createMessage

एक ड्राफ़्ट ईमेल बनाएं. body.body.contentType = "HTML" सेट करके HTML का समर्थन करता है।

आवश्यक पैरामीटर

  • विषय: संदेश विषय
  • toRecipients: ईमेल पतों वाले प्राप्तकर्ताओं की सूची
  • शरीर: सामग्री प्रकार (पाठ/एचटीएमएल) और सामग्री के साथ संदेश का मुख्य भाग

वैकल्पिक पैरामीटर

  • preferHtml: HTML सामग्री के लिए सही पर सेट करें
  • हेडर: वैकल्पिक अतिरिक्त हेडर

mcp_MailTools_graph_mail_deleteMessage

साइन-इन उपयोगकर्ता के मेलबॉक्स से कोई संदेश हटाता है.

आवश्यक पैरामीटर

  • आईडी: संदेश आईडी

वैकल्पिक पैरामीटर

  • If-Match: समकालिकता नियंत्रण के लिए वैकल्पिक ETag

mcp_MailTools_graph_mail_getMessage

साइन-इन उपयोगकर्ता के मेलबॉक्स से ID द्वारा संदेश प्राप्त करता है. HTML बॉडी का अनुरोध करने के लिए उपयोग करें preferHtml ।

आवश्यक पैरामीटर

  • आईडी: संदेश आईडी

वैकल्पिक पैरामीटर

  • select: OData select उपवाक्य
  • विस्तृत करें: OData विस्तृत करें क्‍लॉज़
  • preferHtml: HTML बॉडी फॉर्मेट का अनुरोध करें
  • हेडर: वैकल्पिक HTTP हेडर

mcp_MailTools_graph_mail_listSent

भेजे गए आइटम्स में संदेशों की सूची बनाएं.

वैकल्पिक पैरामीटर

  • फ़िल्टर: OData फ़िल्टर
  • खोज: खोज क्वेरी
  • orderby: क्रमबद्ध करने की अभिव्यक्ति
  • शीर्ष: लौटाने के लिए वस्तुओं की संख्या
  • चुनें: वापस किए जाने वाले फ़ील्ड

mcp_MailTools_graph_mail_reply

किसी मौजूदा संदेश का उत्तर भेजें. preferHtml या headers के माध्यम से HTML का समर्थन करता है।

आवश्यक पैरामीटर

  • आईडी: जवाब देने के लिए संदेश आईडी

वैकल्पिक पैरामीटर

  • टिप्पणी: उत्तर पाठ
  • संदेश: वैकल्पिक संदेश ओवरराइड
  • preferHtml: HTML स्वरूपण सक्षम करें
  • हेडर: वैकल्पिक HTTP हेडर

mcp_MailTools_graph_mail_replyAll

किसी मौजूदा संदेश का सभी को उत्तर भेजें। preferHtml या headers के माध्यम से HTML का समर्थन करता है।

आवश्यक पैरामीटर

  • id: सभी को जवाब देने के लिए संदेश ID

वैकल्पिक पैरामीटर

  • टिप्पणी: उत्तर पाठ
  • संदेश: वैकल्पिक संदेश ओवरराइड
  • preferHtml: HTML स्वरूपण सक्षम करें
  • हेडर: वैकल्पिक HTTP हेडर

mcp_MailTools_graph_mail_searchMessages

कीवर्ड क्वेरी भाषा (KQL) शैली क्वेरीज़ के साथ Microsoft Graph Search API का उपयोग करके Outlook संदेश खोजें.

आवश्यक पैरामीटर

  • अनुरोध: क्वेरी, की ओर से, आकार पैरामीटरों के साथ entityTypes खोज अनुरोधों की सरणी

संदेश सामग्री, विषय, मुख्य भाग और अनुलग्नकों की खोज का समर्थन करता है

mcp_MailTools_graph_mail_sendDraft

ID द्वारा कोई मौजूदा ड्राफ़्ट संदेश भेजें.

आवश्यक पैरामीटर

  • आईडी: भेजने के लिए ड्राफ्ट संदेश आईडी

mcp_MailTools_graph_mail_sendMail

साइन-इन उपयोगकर्ता के रूप में एक ईमेल भेजें.

आवश्यक पैरामीटर

  • संदेश: विषय, toRecipientsऔर मुख्य भाग के साथ संदेश ऑब्जेक्ट
  • विषय: ईमेल विषय
  • toRecipients: प्राथमिक प्राप्तकर्ता
  • मुख्य भाग: कॉन्टेंट टाइप (टेक्स्ट/HTML) और कॉन्टेंट वाला ईमेल का मुख्य भाग

वैकल्पिक पैरामीटर

  • ccRecipients: कार्बन-कॉपी प्राप्तकर्ता
  • बीसीसी प्राप्तकर्ता: ब्लाइंड कार्बन-कॉपी प्राप्तकर्ता
  • saveToSentItems: भेजे गए आइटम में सहेजें (डिफ़ॉल्ट: true)
  • preferHtml: HTML रेंडरिंग को बाध्य करें
  • हेडर: वैकल्पिक अतिरिक्त HTTP हेडर

10. mcp_MailTools_graph_mail_updateMessage

किसी संदेश के परिवर्तनशील गुणों, जैसे विषय, मुख्य भाग और श्रेणियाँ अद्यतन करता है.

आवश्यक पैरामीटर

  • आईडी: संदेश आईडी

वैकल्पिक पैरामीटर

  • विषय: नया विषय
  • मुख्य भाग: नया संदेश का मुख्य भाग
  • श्रेणियाँ: संदेश श्रेणियाँ
  • महत्व: निम्न, सामान्य या उच्च
  • If-Match:ETag समवर्ती नियंत्रण के लिए

मुख्य सुविधाएँ

ईमेल रचना

  • ड्राफ़्ट बनाएं और ईमेल भेजें
  • HTML और सादा पाठ समर्थन
  • प्रति, CC, और BCC प्राप्तकर्ता
  • समृद्ध स्वरूपण विकल्प

ईमेल प्रबंधन

  • संदेश प्राप्त करें, अद्यतन करें और हटाएं।
  • उत्तर दें और सभी को उत्तर दें की सुविधा।
  • मसौदा प्रबंधन।
  • श्रेणी और महत्व सेटिंग्स।

खोज और फ़िल्टरिंग

  • KQL-शैली संदेश खोज।
  • OData क्वेरी समर्थन।
  • विषय, मुख्य भाग और अनुलग्नकों में खोजें।
  • पेजिनेशन और फ़िल्टरिंग।

भेजे गए आइटम

  • भेजे गए संदेशों की सूची बनाएं.
  • भेजे गए आइटम में वैकल्पिक रूप से सहेजें।
  • भेजे गए आइटम को फ़िल्टर करें और खोजें।

नोट्स

  • सभी कार्रवाइयां Microsoft Graph Mail API का उपयोग करती हैं.
  • HTML सामग्री में contentType = "HTML" का body में होना आवश्यक है।
  • preferHtml हेडर HTML बॉडी फॉर्मेट का अनुरोध करता है।
  • खोज KQL क्वेरीज़ के साथ Microsoft Graph Search API का उपयोग करती है.
  • ड्राफ्ट संदेश अलग से बनाए जा सकते हैं, अपडेट किए जा सकते हैं और भेजे जा सकते हैं।
  • ETag अपडेट पर समवर्ती नियंत्रण के लिए समर्थन।
  • पिछली बार को अपडेट किया गया