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.

Note

Uygulamaya özel Microsoft 365 MCP araçları (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User ve Word) yalnızca geriye dönük uyumluluk amaçları için tasarlanmıştır ve üretim ortamlarında veya yeni projelerde kullanılmamalıdır. Microsoft 365 kaynaklarına erişim gerektiren yeni projeler için, GitHub Copilot demetiyle birlikte Work IQ MCP kullanın. Daha fazla bilgi için Copilot Studio'daki Work IQ MCP'ye bakınız.

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
• expand: 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ı
• select: Döndürülecek alanlar

mcp_MailTools_graph_mail_reply

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

Gerekli parametreler:

• id: Yanıtlanacak 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_replyAll

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

Gerekli parametreler:

• id: Tümüne yanıtlanacak 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_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.

Gönderilen öğeler

• 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 bilgisi, HTML gövde biçimini ister.
• 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.