Posta referansı (önizleme)

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Important

Bu bir önizleme özelliğidir.

• Microsoft, müşterilerin erken erişim elde edebilmesi ve geri bildirim sağlayabilmesi için önizleme özelliklerini resmi bir sürümden önce yayınlar.
• Önizleme özellikleri sınırlı işlevlere sahiptir ve üretim kullanımı için tasarlanmamıştır.
• Microsoft, önizleme MCP araç adlarını ve parametrelerini değiştirebilir. Sabit kodlanmış bağımlılıklardan kaçının. Microsoft senaryo desteğini korur.
• Önizleme özellikleri Microsoft ek kullanım koşullarına tabidir.

Genel Bakış

Sunucu Kimliği	Kiracı düzeyinde URL	Ekran adı	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Posta	Microsoft Graph posta işlemleri için araçlar; e-posta mesajlarının oluşturulması, gönderilmesi, yanıtlanması ve yönetimi dahil.

Kullanılabilir araçlar

mcp_MailTools_graph_mail_createMessage

Taslak e-posta oluşturun. body.body.contentType = "HTML" ayarlanarak HTML desteği sağlanır.

Gerekli parametreler:

• Konu: İleti konusu
• toRecipients: E-posta adresleri olan alıcı dizisi
• gövde: içerikTürü (Metin/HTML) ve içerikten oluşan mesaj gövdesi

İsteğe bağlı parametreler:

• preferHtml: HTML içeriği için true olarak ayarlayın
• Üstbilgi: İsteğe bağlı ek üst bilgiler

mcp_MailTools_graph_mail_deleteMessage

Oturum açmış kullanıcının posta kutusundan bir iletiyi siler.

Gerekli parametreler:

• Kimliği: İleti Kimliği

İsteğe bağlı parametreler:

• If-Match: Eşzamanlılık denetimi için isteğe bağlı ETag

mcp_MailTools_graph_mail_getMessage

Oturum açmış kullanıcının posta kutusundan kimliğe göre bir ileti alır. HTML gövdesi istemek için preferHtml kullanın.

Gerekli parametreler:

• Kimliği: İleti Kimliği

İsteğe bağlı parametreler:

• select: OData select yan tümcesi
• genişletmek: OData expand yan tümcesi
• preferHtml: HTML içerik biçimini isteyin
• Üstbilgi: İsteğe bağlı HTTP üst bilgileri

mcp_MailTools_graph_mail_listSent

Gönderilen öğelerdeki iletileri listeleme.

İsteğe bağlı parametreler:

• filtre: OData filtresi
• aramak: Arama sorgusu
• orderby: Sıralama ifadesi
• Üst: Döndürülecek öğe sayısı
• seçmek: Alanlar döndürülecek

mcp_MailTools_graph_mail_reply

Var olan bir iletiyi yanıtlayın. preferHtml veya headers aracılığıyla HTML destekler.

Gerekli parametreler:

• Kimliği: Yanıt için ileti kimliği

İsteğe bağlı parametreler:

• yorum: Yanıt metni
• İleti: İsteğe bağlı mesaj geçersiz kılma ayarları
• preferHtml: HTML biçimlendirmesini etkinleştirme
• Üstbilgi: İsteğe bağlı HTTP üst bilgileri

mcp_MailTools_graph_mail_herkeseYanıtla

Var olan bir iletiye tümünü yanıtla. preferHtml veya headers aracılığıyla HTML destekler.

Gerekli parametreler:

• Kimliği: Hepsini yanıtlamak için mesaj kimliği

İsteğe bağlı parametreler:

• yorum: Yanıt metni
• İleti: İsteğe bağlı mesaj geçersiz kılma ayarları
• preferHtml: HTML biçimlendirmesini etkinleştirme
• Üstbilgi: İsteğe bağlı HTTP üst bilgileri

mcp_MailTools_graph_mail_searchMessages

Anahtar sözcük sorgu dili (KQL) stili sorgularla Microsoft Graph Arama API'sini kullanarak Outlook iletileri arayın.

Gerekli parametreler:

• istekler:entityTypes, query, from ve size parametrelerine sahip arama istekleri dizisi

İleti içeriğini, konusunu, gövdesini ve eklerini aramayı destekler

mcp_MailTools_graph_mail_sendDraft

ID ile mevcut bir taslak mesajı gönderin.

Gerekli parametreler:

• Kimliği: Gönderilecek taslak ileti kimliği

mcp_MailTools_graph_mail_sendMail

Oturum açmış kullanıcı olarak bir e-posta gönderin.

Gerekli parametreler:

• İleti: Konu, toRecipientsve gövde içeren ileti nesnesi
• Konu: E-posta konusu
• toRecipients: Birincil alıcılar
• gövde: contentType (Metin/HTML) ve içerik içeren e-posta gövdesi

İsteğe bağlı parametreler:

• ccRecipients: Karbon kopya alıcıları
• bccRecipients: Gizli karbon kopya alıcıları
• saveToSentItems: Gönderilmiş öğelere kaydet (varsayılan: true)
• preferHtml: HTML işlemeyi zorlama
• Üstbilgi: İsteğe bağlı ek HTTP üst bilgileri

10. mcp_MailTools_graph_mail_updateMessage

İletinin konu, gövde ve kategoriler gibi değiştirilebilir özelliklerini güncelleştirir.

Gerekli parametreler:

• Kimliği: İleti Kimliği

İsteğe bağlı parametreler:

• Konu: Yeni konu
• beden: Yeni ileti gövdesi
• Kategori: İleti kategorileri
• önem: Düşük, Normal veya Yüksek
• If-Match:ETag eşzamanlılık denetimi için

Temel özellikler

E-posta oluşturma

• Taslak oluşturma ve e-posta gönderme
• HTML ve düz metin desteği
• Alıcı, CC ve BCC alıcıları
• Zengin biçimlendirme seçenekleri

E-posta yönetimi

• İletileri alın, güncelleştirin ve silin.
• Yanıtla ve Tümünü Yanıtla işlevi.
• Taslak yönetimi.
• Kategori ve önem ayarları.

Arama ve filtreleme

• KQL stili ileti araması.
• OData sorgu desteği.
• Konu, ileti gövdesi ve eklerde arama yapın.
• Sayfalandırma ve filtreleme.

Sentitems

• Gönderilen iletileri listeleme.
• Gönderilmiş Öğeler'e isteğe bağlı kaydetme seçeneği
• Gönderilen öğeleri filtreleyin ve arayın.

Notlar

• Tüm işlemler Microsoft Graph Posta API'lerini kullanır.
• HTML içeriği, body içinde contentType = "HTML" gerektirir.
• preferHtml üst bilgi, HTML gövde biçimini istemektedir.
• Arama, KQL sorgularıyla Microsoft Graph Arama API'sini kullanır.
• Taslak iletiler ayrı olarak oluşturulabilir, güncelleştirilebilir ve gönderilebilir.
• ETag güncelleştirmelerde eşzamanlılık denetimi desteği.