הפניה ללוח שנה (תצוגה מקדימה)

הערה

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

חשוב

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

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

סקירה כללית

מזהה שרת	כתובת URL ברמת הדייר	שם התצוגה	תיאור
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	לוח שנה	כלים לתפעול לוח שנה כמו יצירה, עדכון, שליפת אירועים, ניהול הזמנות ובדיקת זמינות.

כלים זמינים

mcp_CalendarTools_graph_acceptEvent

קבל את ההזמנה לאירוע שצוין בלוח שנה של משתמש.

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

• eventId: מזהה האירוע שברצונך לקבל

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

• userId: מזהה משתמש או userPrincipalName
• הערה: טקסט אופציונלי הכלול בתגובה
• sendResponse: אם לשלוח תגובה למארגן

mcp_CalendarTools_graph_cancelEvent

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

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

• eventId: המזהה הייחודי של האירוע לביטול

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

• userId: מזהה משתמש או userPrincipalName
• הערה: הודעת ביטול אופציונלית

mcp_CalendarTools_graph_createEvent

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

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

• נושא: נושא או כותרת של אירוע (ללא כותרת)
• התחלה: התחל חותמת זמן עם dateTimetimeZone
• end: חותמת זמן של הסיום עם dateTime ו-timeZone
• attendees_addresses: מערך של כתובות דואר אלקטרוני של משתתפים

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

• userId: מזהה משתמש או userPrincipalName
• גוף: גוף האירוע עם contentType (טקסט/HTML) ותוכן
• מיקום: מיקום עם displayName
• attendees_types: תפקידי משתתפים (נדרשים, אופציונליים, משאב)
• attendees_names: שמות תצוגה של משתתפים
• מופע חוזר: תבנית מופע חוזר וטווח
• isOnlineMeeting: מוגדר כ- True עבור פגישה מקוונת
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: אפשר הצעות זמן (ברירת מחדל: true)
• transactionId: Idempotence מזהה

mcp_CalendarTools_graph_declineEvent

דחיית ההזמנה לאירוע שצוין בלוח שנה של משתמש.

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

• eventId: המזהה של האירוע שיש לדחות

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

• userId: מזהה משתמש או userPrincipalName

• הערה: טקסט אופציונלי בתגובה

• sendResponse: אם לשלוח תגובה

mcp_CalendarTools_graph_deleteEvent

מחק אירוע מלוח שנה של משתמש שצוין.

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

• eventId: המזהה הייחודי של האירוע למחיקה

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

• userId: מזהה משתמש או userPrincipalName

mcp_כלי לוח שנה_גרף_מצא זמני פגישות

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

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

• meetingDuration: משך פגישה (לדוגמה, 'PT1H')

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

• userId: מזהה מארגן או userPrincipalName
• attendees_addresses: כתובות דואר אלקטרוני של משתתפים
• attendees_types: סוגי משתתפים
• attendees_names: שמות תצוגה של משתתפים
• מגבלת זמן: זמינות מבחינת זמן עם timeslots ו-activityDomain
• מיקוםConstraint: אפשרויות מיקום
• maxCandidates: מספר ההצעות המרבי
• isOrganizerOptional: דגל אופציונלי של סדרן
• returnSuggestionReasons: כלול סיבות
• minimumAttendeePercentage: סף השתתפות מינימלי

mcp_CalendarTools_graph_getEvent

קבל אירוע יחיד בלוח השנה מתוך לוח שנה של משתמש שצוין.

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

• eventId: המזהה הייחודי של האירוע

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

• userId: מזהה משתמש או userPrincipalName
• select: פרמטר שאילתת OData \$select
• הרחב: OData \$expand עבור מאפייני ניווט

mcp_CalendarTools_graph_getSchedule

קבל את לוח הזמנים של מועדים פנויים/לא פנויים עבור משתמש, רשימת תפוצה או משאב.

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

• לוחות זמנים: כתובות SMTP של משתמשים או משאבים
• startTime: זמן התחלה עם dateTimetimeZone
• endTime: שעת סיום עם dateTimetimeZone

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

• userId: מזהה משתמש או userPrincipalName
• availabilityViewInterval: אורך משבצת הזמן בדקות

mcp_CalendarTools_graph_listCalendarView

אחזר מופעי לוח שנה בטווח זמן שצוין עבור משתמש.

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

• startDateTime: תחילת טווח הזמן (ISO 8601)
• endDateTime: סיום טווח הזמן (ISO 8601)

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

• userId: מזהה משתמש או userPrincipalName
• למעלה: מספר האירועים המרבי
• לפי סדר לפי סעיף

mcp_CalendarTools_graph_listEvents

אחזר רשימה של אירועים מלוח שנה של משתמש שצוין.

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

• userId: מזהה משתמש או userPrincipalName
• startDateTime: תחילת טווח הזמן (ISO 8601)
• endDateTime: סיום טווח הזמן (ISO 8601)
• למעלה: מספר האירועים המרבי
• מסנן: שאילתת סינון OData
• orderby: סדר OData לפי שאילתה

mcp_CalendarTools_graph_updateEvent

עדכן אירוע קיים בלוח השנה של המשתמש שצוין.

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

• eventId: המזהה הייחודי של האירוע

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

• userId: מזהה משתמש או userPrincipalName
• נושא: נושא מעודכן
• גוף: תוכן גוף מעודכן
• התחלה: זמן התחלה מעודכן
• סיום: שעת סיום מעודכנת
• מיקום: מיקום מעודכן
• attendees_addresses: הודעות דואר אלקטרוני מעודכנות של משתתפים
• attendees_types: סוגי משתתפים מעודכנים
• attendees_names: עודכנו שמות משתתפים
• isCancelled: הגדר כ-true כדי לבטל
• מופע חוזר: תבנית מופע חוזר מעודכנת

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

ניהול אירועים

• צור, קרא, עדכן ומחק אירועים.
• קבל, דחה וביטל הזמנות.
• תמיכה באירועים חוזרים.
• אינטגרציה עם פגישות מקוונות (Teams, סקייפ).

זמינות ותזמון

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

ניהול משתתפים

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

תבניות מופע חוזר

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

פגישות מקוונות

• שילוב עם Teams for Business
• תמיכה עבור Skype for Business
• תמיכה עבור סקייפ (לשימוש אישי)
• יצירת קישור פגישה אוטומטית

הערות

• כל חותמות הזמן משתמשות בתבנית UTC/ISO 8601 עם אזור זמן
• MCP של לוח השנה מסתמך UserprofileMCP על חיפוש משתמשים בארגון
• כתובות דואר אלקטרוני חייבות להיות בתבנית חוקית
• מערכים של משתתפים (כתובות, סוגים, שמות) חייבים להיות באותו סדר
• פגישות מקוונות דורשות isOnlineMeeting=trueonlineMeetingProvider
• מופע חוזר דורש הן אובייקטי תבנית והן אובייקט טווח
• אזורי זמן צריכים להיות עקביים לאורך שעות ההתחלה והסיום
• TransactionId מאפשר יצירת אירוע idempotent