Αναφορά Teams (προεπισκόπηση)

Σημείωμα

Αυτό το άρθρο περιγράφει δυνατότητες που χρησιμοποιούνται σε παράγοντες ή ροές παραγόντων που υποστηρίζονται από την τυπική πλεξούδα.

Σημαντικό

Αυτή είναι μια δυνατότητα προεπισκόπησης.

• 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_διαγραφήΜηνύματοςΣυνομιλίας

Τελικό σημείο:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Διαγράφει προσωρινά ένα μήνυμα συνομιλίας. Επιστρέφει ένα 403 χωρίς Chat.ReadWrite, ένα 404 για μη έγκυρα αναγνωριστικά και μπορεί να εξακολουθεί να διατηρεί το μήνυμα συμμόρφωσης.

Απαιτούμενες παράμετροι: αναγνωριστικό χρήστη, αναγνωριστικό συνομιλίας, chatMessage-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_listChats

Τελικό σημείο: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

Προαιρετικές παράμετροι: περιγραφή, τύπος ιδιότητας μέλους, μέλη

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

Τελικό σημείο:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Δημοσιεύει ένα μήνυμα απλού κειμένου σε ένα κανάλι. Απαιτεί αναγνωριστικό ομάδας, αναγνωριστικό καναλιού και περιεχόμενο body.content. Επιστρέφει ένα 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 για φιλτράρισμα και σελιδοποίηση.