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

Σημείωμα

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

Σημαντικό

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

• Microsoft κυκλοφορεί δυνατότητες προεπισκόπησης πριν από μια επίσημη κυκλοφορία, έτσι ώστε οι πελάτες να αποκτήσουν πρώιμη πρόσβαση και να παρέχουν σχόλια.
• Οι δυνατότητες προεπισκόπησης έχουν περιορισμένη λειτουργικότητα και δεν προορίζονται για χρήση στην παραγωγή.
• Microsoft μπορεί να αλλάξουν τα ονόματα και τις παραμέτρους των εργαλείων MCP προεπισκόπησης. Αποφύγετε τις εξαρτήσεις που είναι ενσωματωμένες στον κώδικα. Microsoft διατηρεί την υποστήριξη σεναρίου.
• Οι δυνατότητες προεπισκόπησης υπόκεινται στο Microsoft συμπληρωματικοί όροι χρήσης.

Επισκόπηση

Αναγνωριστικό διακομιστή	Διεύθυνση URL σε επίπεδο μισθωτή	Εμφανιζόμενο όνομα	Περιγραφή
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Ταχυδρομείο	Εργαλεία για λειτουργίες αλληλογραφίας του Microsoft Graph, συμπεριλαμβανομένης της δημιουργίας, της αποστολής, της απάντησης και της διαχείρισης μηνυμάτων email.

Διαθέσιμα εργαλεία

mcp_MailTools_graph_mail_createMessage

Δημιουργήστε ένα πρόχειρο μήνυμα ηλεκτρονικού ταχυδρομείου. Υποστηρίζει HTML ρυθμίζοντας το body.body.contentType = "HTML".

Απαιτούμενες παράμετροι:

• θέμα: Θέμα μηνύματος
• toRecipients: Πίνακας παραληπτών με διευθύνσεις ηλεκτρονικού ταχυδρομείου
• σώμα: Σώμα μηνύματος με contentType (Κείμενο/HTML) και περιεχόμενο

Προαιρετικές παράμετροι:

• preferHtml: Ορισμός σε true για περιεχόμενο HTML
• Κεφαλίδες: Προαιρετικές πρόσθετες κεφαλίδες

mcp_MailTools_graph_mail_deleteMessage

Διαγράφει ένα μήνυμα από το γραμματοκιβώτιο του συνδεδεμένου χρήστη.

Απαιτούμενες παράμετροι:

• αναγνωριστικό: Αναγνωριστικό μηνύματος

Προαιρετικές παράμετροι:

• If-Match: Προαιρετικό ETag για έλεγχο συγχρονισμού

mcp_MailTools_graph_mail_getMessage

Λαμβάνει ένα μήνυμα μέσω αναγνωριστικού από το γραμματοκιβώτιο του συνδεδεμένου χρήστη. Χρησιμοποιήστε preferHtml το για να ζητήσετε σώμα HTML.

Απαιτούμενες παράμετροι:

• αναγνωριστικό: Αναγνωριστικό μηνύματος

Προαιρετικές παράμετροι:

• διαλέγω: Όρος επιλογής OData
• επεκτείνω: Όρος ανάπτυξης OData
• preferHtml: Αίτηση μορφής σώματος HTML
• Κεφαλίδες: Προαιρετικές κεφαλίδες HTTP

mcp_MailTools_graph_mail_listSent

Εμφάνιση μηνυμάτων σε απεσταλμένα στοιχεία.

Προαιρετικές παράμετροι:

• φίλτρο: Φίλτρο OData
• αναζήτηση: Αναζήτηση ερωτήματος
• orderby: Παράσταση ταξινόμησης
• κορυφή: Ο αριθμός των στοιχείων προς επιστροφή
• διαλέγω: Πεδία προς επιστροφή

mcp_MailTools_graph_mail_reply

Αποστολή απάντησης σε υπάρχον μήνυμα. Υποστηρίζει HTML μέσω preferHtml ή headers.

Απαιτούμενες παράμετροι:

• αναγνωριστικό: Αναγνωριστικό μηνύματος για απάντηση σε

Προαιρετικές παράμετροι:

• σχόλιο: Κείμενο απάντησης
• μήνυμα: Το προαιρετικό μήνυμα παρακάμπτεται
• preferHtml: Ενεργοποίηση μορφοποίησης HTML
• Κεφαλίδες: Προαιρετικές κεφαλίδες HTTP

mcp_MailTools_graph_mail_replyAll

Αποστολή απάντησης σε ένα υπάρχον μήνυμα. Υποστηρίζει HTML μέσω preferHtml ή headers.

Απαιτούμενες παράμετροι:

• αναγνωριστικό: Αναγνωριστικό μηνύματος για απάντηση προς όλους

Προαιρετικές παράμετροι:

• σχόλιο: Κείμενο απάντησης
• μήνυμα: Το προαιρετικό μήνυμα παρακάμπτεται
• preferHtml: Ενεργοποίηση μορφοποίησης HTML
• Κεφαλίδες: Προαιρετικές κεφαλίδες HTTP

mcp_MailTools_graph_mail_searchMessages

Κάντε αναζήτηση σε μηνύματα του Outlook χρησιμοποιώντας το API αναζήτησης του Microsoft Graph με ερωτήματα τύπου γλώσσας ερωτημάτων λέξεων-κλειδιών (KQL).

Απαιτούμενες παράμετροι:

• Αιτήσεις: Πίνακας αιτήσεων αναζήτησης με entityTypes, ερώτημα, από, παραμέτρους μεγέθους

Υποστηρίζει αναζήτηση περιεχομένου μηνύματος, θέμα, σώμα και συνημμένα

mcp_MailTools_graph_mail_sendDraft

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

Απαιτούμενες παράμετροι:

• αναγνωριστικό: Αναγνωριστικό πρόχειρου μηνύματος για αποστολή

mcp_MailTools_graph_mail_sendMail

Στείλτε ένα μήνυμα ηλεκτρονικού ταχυδρομείου ως συνδεδεμένος χρήστης.

Απαιτούμενες παράμετροι:

• Μήνυμα: Αντικείμενο μηνύματος με θέμα, toRecipientsκαι σώμα κειμένου
• θέμα: Θέμα ηλεκτρονικού ταχυδρομείου
• toRecipients: Κύριοι παραλήπτες
• σώμα: Σώμα μηνύματος ηλεκτρονικού ταχυδρομείου με contentType (Κείμενο/HTML) και περιεχόμενο

Προαιρετικές παράμετροι:

• ccRecipients: Παραλήπτες κοινοποίησης
• bccRecipients: Παραλήπτες κρυφής κοινοποίησης
• saveToSentItems: Αποθήκευση σε απεσταλμένα στοιχεία (προεπιλογή: true)
• preferHtml: Επιβολή απόδοσης HTML
• Κεφαλίδες: Προαιρετικές πρόσθετες κεφαλίδες HTTP

10. mcp_MailTools_graph_mail_updateMessage

Ενημερώνει τις μεταλλαγμένες ιδιότητες ενός μηνύματος, όπως το θέμα, το σώμα και οι κατηγορίες.

Απαιτούμενες παράμετροι:

• αναγνωριστικό: Αναγνωριστικό μηνύματος

Προαιρετικές παράμετροι:

• θέμα: Νέο θέμα
• σώμα: Νέο σώμα μηνύματος
• Κατηγορίες: Κατηγορίες μηνυμάτων
• σημασία: Χαμηλή, Κανονική ή Υψηλή
• If-Match:ETag για έλεγχο συγχρονισμού

Δυνατότητες κλειδιά

Σύνθεση ηλεκτρονικού ταχυδρομείου

• Δημιουργία πρόχειρων και αποστολή μηνυμάτων ηλεκτρονικού ταχυδρομείου
• Υποστήριξη HTML και απλού κειμένου
• Προς, παραλήπτες CC και BCC
• Επιλογές εμπλουτισμένης μορφοποίησης

Διαχείριση ηλεκτρονικού ταχυδρομείου

• Λήψη, ενημέρωση και διαγραφή μηνυμάτων.
• Λειτουργίες απάντησης και απάντησης σε όλες.
• Πρόχειρη διαχείριση.
• Ρυθμίσεις κατηγορίας και σπουδαιότητας.

Αναζήτηση και φιλτράρισμα

• Αναζήτηση μηνύματος στυλ KQL.
• Υποστήριξη ερωτημάτων OData.
• Κάντε αναζήτηση σε όλο το θέμα, το σώμα και τα συνημμένα.
• Σελιδοποίηση και φιλτράρισμα.

Sentitems

• Λίστα απεσταλμένα μηνύματα.
• Προαιρετική αποθήκευση στα απεσταλμένα στοιχεία.
• Φιλτράρετε και αναζητήστε απεσταλμένα στοιχεία.

Σημειώσεις

• Όλες οι λειτουργίες χρησιμοποιούν Microsoft Graph API αλληλογραφίας.
• Το περιεχόμενο HTML απαιτεί contentType = "HTML" στο σώμα.
• preferHtml Η κεφαλίδα ζητά μορφή σώματος HTML.
• Η αναζήτηση χρησιμοποιεί Microsoft Graph API αναζήτησης με ερωτήματα KQL.
• Τα πρόχειρα μηνύματα μπορούν να δημιουργηθούν, να ενημερωθούν και να αποσταλούν ξεχωριστά.
• ETag υποστήριξη για έλεγχο ταυτόχρονης εκτέλεσης σε ενημερώσεις.