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

הערה

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

חשוב

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

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

הערה

כלי MCP של Microsoft 365 ייעודיים ליישום (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User ו-Word) מיועדים רק לצורכי תאימות לאחור ואינם אמורים לשמש בסביבות ייצור או פרויקטים חדשים. לפרויקטים חדשים שדורשים גישה למשאבי Microsoft 365, השתמשו ב-Work IQ MCP עם רתמת Microsoft Copilot. למידע נוסף, ראו Work IQ MCP ב-Copilot Studio.

סקירה כללית

מזהה שרת כתובת 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) ותוכן

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

  • preferHtml: הגדר ל-true עבור תוכן HTML
  • כותרות: כותרות נוספות אופציונליות

mcp_MailTools_graph_mail_deleteMessage

מחיקת הודעה מתיבת הדואר של המשתמש המחובר.

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

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

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

  • If-Match: אופציונלי ETag לשליטה במקביליות

mcp_MailTools_graph_mail_getMessage

מקבל הודעה לפי מזהה מתיבת הדואר של המשתמש המחובר. השתמש ב-preferHtml כדי לבקש גוף HTML.

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

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

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

  • select: OData select clause
  • expand: פסוקית הרחבה של OData
  • preferHtml: בקשה לקבלת גוף HTML
  • כותרות: כותרות HTTP אופציונליות

mcp_MailTools_graph_mail_listSent

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

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

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

mcp_MailTools_graph_mail_reply

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

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

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

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

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

mcp_MailTools_graph_mail_replyAll

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

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

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

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

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

mcp_MailTools_graph_mail_searchMessages

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

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

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

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

mcp_MailTools_graph_mail_sendDraft

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

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

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

mcp_MailTools_graph_mail_sendMail

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

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

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

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

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

10. mcp_MailTools_graph_mail_updateMessage

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

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

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

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

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

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

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

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

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

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

חיפוש וסינון

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

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

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

Notes

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