הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
מאמר זה מתאר תכונות המשמשות בסוכנים או בזרימות סוכנים המופעלים על ידי הרתמה הסטנדרטית.
חשוב
זוהי תכונת 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תמיכה בבקרת מקביליות בעדכונים.