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

הערה

מאמר זה מתאר תכונות שמשמשות בסוכנים או בזרימות סוכנים שמופעלות באמצעות המסגרת הרגילה.

חשוב

‏‫‏‫זוהי תכונת 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.

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

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

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

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

mcp_MailTools_graph_mail_replyAll

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

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

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

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

• תגובה: טקסט תשובה
• הודעה: עקיפות הודעה אופציונליות
• preferHtml: הפיכת עיצוב 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: נמענים לעותק
• bccRecipients: נמעני עותק מוסתר לידיעה
• 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 תמיכה בבקרת בו-זמניות בעת עדכונים.