התייחסות לקבוצות (תצוגה מקדימה)

הערה

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

חשוב

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

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

סקירה כללית

מזהה שרת	כתובת URL ברמת הדייר	שם התצוגה	היקף	תיאור
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	כלי Microsoft Teams לניהול שיחות, ערוצים, משתמשים או הודעות בתוכם. השתמש בשרת MCP זה עבור פעולות של Teams, כגון יצירה, עדכון ואחזור של צ'אטים והודעות צ'אט, ניהול צוותים וערוצים וביצוע משימות ניהוליות הקשורות למשימות אלה.

כלי צ'אט

mcp_graph_chat_addChatMember

נקודת הקצה:POST /v1.0/chats/{chat-id}/members

הוספת חבר לצ'אט באמצעות user@odata.bind, @odata.typeותפקידים אופציונליים (חבר, בעלים). החזרת קוד שגיאה 409 אם החבר כבר קיים, קוד שגיאה של 400 עבור הפניות משתמש לא חוקיות או קוד שגיאה 403 אם פריטי מדיניות מגבילים את ההוספה.

פרמטרים נדרשים: מזהה צ'אט, @odata.type, user@odata.bind, תפקידים

mcp_graph_chat_createChat

נקודת הקצה:POST /v1.0/chats

יצירת צ'אט חדש של Teams עם chatType (oneOnOne דורש בדיוק שני משתתפים, קבוצה דורשת יותר משניים) וחברים. החזרת 400 oneOnOne אם קיימת ספירת חברים שגויה, 409 אם לאותם משתתפים כבר יש צ'אט, או 403 אם למשתתף אין זכויות.

פרמטרים נדרשים:chatType, חברים

mcp_graph_chat_deleteChat (פונקציה למחיקת צ'אט)

נקודת הקצה:DELETE /v1.0/chats/{chat-id}

מחיקה זמנית של צ'אט. החזרת 403 אם חסרה הרשאה או 404 אם כבר נמחקה. מדיניות שמירת דיירים כפופה לפעולה זו.

פרמטרים נדרשים: מזהה צ'אט

mcp_graph_chat_deleteChatMessage

נקודת הקצה:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

מחיקה זמנית של הודעת צ'אט. מחזירה 403 ללא Chat.ReadWrite, 404 עבור מזהים לא תקינים, וייתכן שההודעה עדיין תישמר לצורכי ציות.

פרמטרים נדרשים: מזהה משתמש, מזהה צ'אט, צ'אטMessage-id

mcp_graph_chat_getChat

נקודת הקצה:GET /v1.0/chats/{chat-id}

מאחזר צ'אט לפי מזהה. מחזירה מטה-נתונים כגון סוג ונושא. החזרת 404 אם הצ'אט אינו קיים או אינו גלוי, או 403 אם ההרשאות נדחו.

פרמטרים נדרשים: מזהה צ'אט

mcp_graph_chat_getChatMessage

נקודת הקצה:GET /v1.0/chats/{chat-id}/messages/{message-id}

אחזור הודעת צ'אט לפי מזהה. החזרת 404 אם ההודעה אינה קיימת או מוסתרת, או 403 ללא זכויות מתאימות.

פרמטרים נדרשים: מזהה צ'אט, מזהה הודעה

mcp_graph_chat_listChatMembers

נקודת הקצה:GET /v1.0/chats/{chat-id}/members

פירוט משתתפי הצ'אט. מחזירה תפקידים (חבר, בעלים או אורח). החזרת 403 ללא הרשאות קריאה או 404 אם הצ'אט לא נמצא.

פרמטרים נדרשים: מזהה צ'אט

mcp_graph_chat_listChatMessages

נקודת הקצה:GET /v1.0/chats/{chat-id}/messages

פירוט ההודעות בצ'אט עם אופציונלי $top, , $filterו- $orderby. מחזירה תוצאות מחולקות לעמודים. תאימות עשויה להסתיר תוכן. השגיאות כוללות 400 עבור שאילתות לא תקינות ו-429 עבור הגבלת קצב.

פרמטרים נדרשים: מזהה צ'אט

פרמטרים אופציונליים:$top, $filter, $orderby

רשימת הצ'אטים של ה-mcp_graph_chat

נקודת הקצה:GET /v1.0/chats

פירוט צ'אטים עבור מתקשר עם אופציונלי $top, $filter, , $expandו- $orderby. החזרת צ'אטים גלויים בלבד; ייתכן שהודעות צ'אט מוסתרות או צ'אטים במערכת לא ייכללו. החזרת 400 עבור ביטויי מיון לא חוקיים.

פרמטרים אופציונליים:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

נקודת הקצה:POST /v1.0/chats/{chat-id}/messages

הצבת הודעה חדשה בטקסט רגיל בצ'אט. נדרשים chat-id ו-body.content שאינו ריק; רק טקסט נתמך. עשוי להחזיר 429 לצורך ויסות, 403 אם חסרות הרשאות או 404 אם הצ'אט אינו חוקי. לא idempotent—avoid ניסיונות חוזרים ללא בדיקה.

פרמטרים נדרשים: מזהה צ'אט, גוף

mcp_graph_chat_updateChat

נקודת הקצה:PATCH /v1.0/chats/{chat-id}

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

פרמטרים נדרשים: מזהה צ'אט, נושא

mcp_graph_chat_updateChatMessage

נקודת הקצה:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

עדכון הודעת צ'אט בתוכן טקסט רגיל חדש. הודעות מערכת או תאימות מסוימות חוסמי עריכה. הפעולה מחזירה 403 או 400 אם עריכה אסורה, או 409 עבור התנגשויות.

פרמטרים נדרשים: מזהה צ'אט, מזהה הודעה

כלי ערוצים וצוותים

mcp_graph_teams_addChannelMember

נקודת הקצה:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

הוספת חבר לערוץ פרטי או משותף באמצעות user@odata.bind, @odata.typeותפקידים אופציונליים (בעלים או ריקים). נכשל בערוצים רגילים. החזרת 409 אם החבר כבר קיים ו- 403 אם חסרות לו הרשאות.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, displayName, תפקידים, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

נקודת הקצה:POST /v1.0/teams/{team-id}/channels

יצירת ערוץ בצוות עם , תיאור אופציונלי displayName, (רגיל, membershipType פרטי, משותף) וחברים אופציונליים. ערוצים פרטיים או משותפים דורשים חברים מפורשים. כפילויות או חברות לא תקינה גורמות לשגיאת 400 או 409.

פרמטרים נדרשים: מזהה צוות, displayName

פרמטרים אופציונליים: תיאור, membershipType, חברים

mcp_graph_teams_createPrivateChannel

נקודת הקצה:POST /v1.0/teams/{team-id}/channels

יוצר ערוץ פרטי על-ידי הגדרה ל membershipType - private. עליך לכלול חברים בעת יצירת הערוץ, ורשימת החברים חייבת לכלול בעלים אחד לפחות. החזרת 400 אם החברים חסרים, 409 עבור שמות כפולים או 403 אם אין לו הרשאות.

פרמטרים נדרשים: מזהה צוות, displayName, חברים

mcp_graph_teams_getChannel

נקודת הקצה:GET /v1.0/teams/{team-id}/channels/{channel-id}

מאחזר ערוץ עם $select ו-$filter אופציונליים. החזרת 404 אם הערוץ לא נמצא או שלתקשר אין גישה, 403 אם אין הרשאות מספיקות, או 400 עבור מסננים שאינם נתמכים.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים:$select, $filter

mcp_graph_teams_getTeam

נקודת הקצה:GET /v1.0/teams/{team-id}

מאחזר את מאפייני הצוות עם הפרמטרים האופציונליים $select ו-$expand. מחזירה 403 או 404 אם הצוות אינו זמין.

פרמטרים נדרשים: מזהה צוות

פרמטרים אופציונליים:$select, $expand

mcp_graph_teams_listChannelMembers

נקודת הקצה:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

פירוט כל החברים בערוץ Microsoft Teams ספציפי. מחזירה מטה-נתונים אודות כל חבר, כגון זהות, תפקידים ומצב חברות. מידע זה שימושי לצורך ביקורת השתתפות בערוץ, אימות חברות לפני עדכוני תפקידים או כדי להבטיח תאימות.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים:$top, $expand

mcp_graph_teams_listChannelMessages

נקודת הקצה:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

פירוט הודעות בערוץ. השתמש בפרמטרים האופציונליים $top$expand ובפרמטרים כדי להתאים אישית את התוצאות. לדוגמה, השתמש ב-$expand כדי לכלול תגובות. חלוקה לעמודים מטופלת באמצעות @odata.nextLink. החזרת 403 ללא הרשאת קריאה או 400 עבור אפשרויות שאילתה לא חוקיות.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים:$top, $expand

mcp_graph_teams_listChannels

נקודת הקצה:GET /v1.0/teams/{team-id}/allChannels

פירוט ערוצים בצוות. השתמש בפרמטרים או $select אופציונליים $filter כדי להתאים אישית את התוצאות. מחזירה ערוצים פרטיים ומשותפים רק אם מתקשר הוא חבר. נכשלת עם 403 אם אין לו זכויות קריאה או 400 בשאילתות OData לא חוקיות.

פרמטרים נדרשים: מזהה צוות

פרמטרים אופציונליים:$select, $filter

mcp_graph_teams_listTeams

נקודת הקצה:GET /v1.0/users/{user-id}/joinedTeams

פירוט הצוותים המצורפים של משתמש ספציפי. החזרת חברויות של משתמש זה בלבד, לא של כל צוותי הדיירים. החזרת 403 אם למשתמש החייג לא היתה אפשרות לבצע שאילתה על המשתמש או על 404 אם המזהה אינו חוקי.

פרמטרים נדרשים: מזהה משתמש

mcp_graph_teams_postChannelMessage (פונקציה בגרף MCP לשליחת הודעה לערוץ ב-Teams)

נקודת הקצה:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

הצבת הודעה בטקסט רגיל בערוץ. נדרש מזהה צוות, מזהה ערוץ וגוף.תוכן. מחזיר 403 בהיעדר ChannelMessage.Send, 404 אם הערוץ לא נמצא, או 400 אם התוכן חסר.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, גוף

mcp_graph_teams_replyToChannelMessage

נקודת הקצה:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

מענה להודעה בערוץ באמצעות body.content. קיימת תמיכה בטקסט רגיל בלבד. החזרת 404 אם הודעת האב לא נמצאה, 403 ללא זכויות או 400 עבור תוכן לא חוקי.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, מזהה הודעה, גוף

mcp_graph_teams_updateChannel

נקודת הקצה:PATCH /teams/{team-id}/channels/{channel-id}

מעדכן ערוץ עם displayName חדש או תיאור חדש. עשויות לחול הגבלות על ערוצים מיוחדים, כגון כללי. החזרת 403 ללא זכויות, 409 על שמות כפולים או 400 עבור קלט לא חוקי.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

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

mcp_graph_teams_updateChannelMember

נקודת הקצה:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

עדכון תפקיד של חבר בערוץ פרטי או משותף על-ידי שינוי תפקידים. ערוצים רגילים מקבלים בירושה תפקידים מהצוות וברוב רוב דוחים עדכונים. החזרת 400 אם נעשה ניסיון בערוצים רגילים, 403 אם לא מורשה או 404 אם החבר לא נמצא.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, מזהה חברות, תפקידים

פעולות נתמכות

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

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

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