הפניה בדואר (תצוגה מקדימה)

הערה

המאפיינים במאמר זה מופעלים על ידי הרתמה הסטנדרטית, המשתמשת באפשרויות החיוב המתוארות ברישוי לסוכנים המופעלים על ידי הרתמה הסטנדרטית. למד כיצד לגשת לתכונות סטנדרטיות בסוכנים ובזרימות הסוכנים הסטנדרטיים של Access (Consumer Flows).

חשוב

‏‫‏‫זוהי תכונת Preview.‬‬

• Microsoft תצוגה מקדימה לפני מהדורה רשמית כדי שלקוחות יוכלו לקבל גישה מוקדמת ולספק משוב.
• לתכונות תצוגה מקדימה יש פונקציונליות מוגבלת והן אינן מיועדות לשימוש ייצור.
• 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".

פרמטרים נדרשים:

• נושא: נושא ההודעה
• נמענים: מערך של נמענים עם כתובות דואר אלקטרוני
• גוף: גוף ההודעה עם תוכן מסוג (טקסט/HTML) ותוכן

פרמטרים אופציונליים:

• מעדיףHtml: הגדר כ- True עבור תוכן 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_listSent

רשימת הודעות בפריטים שנשלחו.

פרמטרים אופציונליים:

• מסנן: מסנן OData
• חיפוש: שאילתת חיפוש
• סדר לפי: ביטוי מיון
• סביבון: מספר הפריטים להחזרה
• בחר: שדות להחזרה

mcp_MailTools_graph_mail_reply

שלח תשובה להודעה קיימת. תמיכה ב- HTML באמצעות או preferHtmlheaders.

פרמטרים נדרשים:

• מזהה: מזהה הודעה לתגובה

פרמטרים אופציונליים:

• תגובה: טקסט תשובה
• הודעה: עקיפות הודעה אופציונליות
• מעדיףHtml: הפיכת עיצוב HTML לזמין
• כותרות: כותרות HTTP אופציונליות

mcp_MailTools_graph_mail_replyAll

שלח תשובה לכולם להודעה קיימת. תמיכה ב- HTML באמצעות או preferHtmlheaders.

פרמטרים נדרשים:

• מזהה: מזהה הודעה לתשובה לכולם

פרמטרים אופציונליים:

• תגובה: טקסט תשובה
• הודעה: עקיפות הודעה אופציונליות
• מעדיףHtml: הפיכת עיצוב HTML לזמין
• כותרות: כותרות HTTP אופציונליות

mcp_MailTools_graph_mail_searchMessages

חפש הודעות Outlook באמצעות Microsoft Graph Search API עם שאילתות בסגנון שפת שאילתות מילות מפתח (KQL).

פרמטרים נדרשים:

• בקשות: מערך של בקשות חיפוש עם entityTypesפרמטרי גודל של , query, from,

תמיכה בחיפוש תוכן הודעה, נושא, גוף וקבצים מצורפים

mcp_MailTools_graph_mail_sendDraft

שלח הודעת טיוטה קיימת לפי מזהה.

פרמטרים נדרשים:

• מזהה: מזהה הודעת טיוטה לשליחה

mcp_MailTools_graph_mail_sendMail

שלח דואר אלקטרוני כמשתמש המחובר.

פרמטרים נדרשים:

• ההודעה: אובייקט הודעה עם נושא, toRecipientsוגוף ההודעה
• נושא: נושא דואר אלקטרוני
• נמענים: נמענים ראשיים
• גוף: גוף דואר אלקטרוני עם סוג תוכן (Text/HTML) ותוכן

פרמטרים אופציונליים:

• ccRecipients: נמעני עותק
• נמענים ב-עותק מוסתר: נמעני עותק מוסתר
• saveToSentItems: שמור בפריטים שנשלחו (ברירת מחדל: true)
• מעדיףHtml: כפה עיבוד HTML
• כותרות: כותרות HTTP נוספות אופציונליות

10. mcp_MailTools_graph_mail_updateMessage

עדכון המאפיינים השולחניים של הודעה, כגון הנושא, גוף ההודעה והקטגוריות.

פרמטרים נדרשים:

• מזהה: מזהה של ההודעה

פרמטרים אופציונליים:

• נושא: נושא חדש
• תוכן: גוף הודעה חדשה
• קטגוריות: קטגוריות הודעות
• חשיבות: נמוך, רגיל או גבוה
• If-Match:ETag לבקרת בו-זמניות

תכונות מרכזיות

קומפוזיציה של דואר אלקטרוני

• יצירת טיוטות ושליחה של הודעות דואר אלקטרוני
• תמיכה ב- HTML ובטקסט רגיל
• נמעני אל, עותק ועותק מוסתר
• אפשרויות עיצוב עשירות

ניהול דואר אלקטרוני

• קבל, עדכן ומחק הודעות.
• פונקציית "השב" ו"השב לכולם".
• ניהול טיוטות.
• הגדרות קטגוריה ו חשיבות.

חיפוש וסינון

• חיפוש הודעות בסגנון KQL.
• תמיכה בשאילתות OData.
• חפש בנושאים, בגוף ובקבצים מצורפים.
• חלוקה לעמודים וסינון.

פריטים שנשלחו

• רשימת הודעות שנשלחו.
• שמירה אופציונלית בפריטים שנשלחו.
• סנן וחפש פריטים שנשלחו.

הערות

• כל הפעולות משתמשות Microsoft Graph API של דואר.
• תוכן HTML דורש contentType = "HTML" בגוף ההודעה.
• preferHtml כותרת עליונה מבקשת תבנית גוף HTML.
• החיפוש משתמש Microsoft Graph API של חיפוש עם שאילתות KQL.
• ניתן ליצור, לעדכן ולשלוח הודעות טיוטה בנפרד.
• ETag תמיכה בבקרת בו-זמניות בעת עדכונים.