Takvim 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_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Takvim	Etkinlik oluşturma, güncelleme ve getirme, davetleri yönetme ve uygunluğu kontrol etme gibi takvim işlemlerine yönelik araçlar.

Kullanılabilir araçlar

mcp_CalendarTools_graph_acceptEvent

Kullanıcının takviminde belirtilen olay davetini kabul edin.

Gerekli parametreler:

• eventId: Kabul edilen olayın kimliği

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• açıklama: yanıta eklenen isteğe bağlı metin
• sendResponse: Düzenleyiciye yanıt gönderip göndermeyeceği

mcp_CalendarTools_graph_OlayıİptalEt

Belirtilen kullanıcının takvimindeki bir etkinliği iptal edin ve katılımcılara bildirin.

Gerekli parametreler:

• eventId: İptal edilen olayın benzersiz tanımlayıcısı

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• açıklama: İsteğe bağlı iptal iletisi

mcp_CalendarTools_graph_createEvent

Belirtilen kullanıcının takviminde yeni bir takvim olayı oluşturun. Yinelenen etkinlikleri ve çevrimiçi toplantıları destekler.

Gerekli parametreler:

• konu: Olay konusu veya başlığı (yok)
• başlangıç: dateTime ve timeZone ile zaman damgasını başlatın
• end: dateTime ve timeZone ile bitiş zaman damgası
• attendees_addresses: Katılımcı e-posta adresleri dizisi

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• gövde: contentType (Metin/HTML) ve içerik içeren olay gövdesi
• konum: displayName ile konum
• attendees_types: Katılımcı rolleri (gerekli, isteğe bağlı, kaynak)
• attendees_names: Katılımcıların görünen adları
• yinelenme: Yinelenme düzeni ve aralığı
• isOnlineMeeting: Çevrimiçi toplantı için true olarak ayarlayın
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Zaman tekliflerine izin ver (varsayılan: true)
• transactionId: Idempotence tanımlayıcı

mcp_CalendarTools_graph_declineEvent

Kullanıcının takviminde belirtilen olay davetini reddedin.

Gerekli parametreler:

• eventId: Reddedilecek olayın kimliği

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName

• açıklama: yanıt olarak isteğe bağlı metin

• sendResponse: Yanıt gönderip göndermeyeceği

mcp_CalendarTools_graph_deleteEvent

Belirtilen kullanıcının takviminden bir olayı silin.

Gerekli parametreler:

• eventId: Silinecek olayın benzersiz tanımlayıcısı

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName

mcp_TakvimAraçlar_çizge_toplantıZamanlarınıBul

Düzenleyiciye ve katılımcının uygunluk durumuna göre toplantı saatlerini ve konumlarını önerin.

Gerekli parametreler:

• meetingDuration: Toplantı süresi (örneğin, 'PT1H')

İsteğe bağlı parametreler:

• userId: Düzenleyici Kimliği veya userPrincipalName
• attendees_addresses: Katılımcı e-posta adresleri
• attendees_types: Katılımcı türleri
• attendees_names: Katılımcıların görünen adları
• timeConstraint: timeslots ve activityDomain ile zaman uygunluğu
• locationConstraint: Konum seçenekleri
• maxCandidates: Maksimum öneri sayısı
• isOrganizerOptional: İsteğe bağlı organizatör bayrağı
• returnSuggestionReasons: Nedenleri dahil etme
• minimumAttendeePercentage: Minimum katılım eşiği

mcp_CalendarTools_graph_getEvent

Belirtilen kullanıcının takviminden tek bir takvim olayı alın.

Gerekli parametreler:

• eventId: Olayın benzersiz tanımlayıcısı

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• select: OData \$select sorgu parametresi
• expand: gezinti özellikleri için OData \$expand

mcp_CalendarTools_graph_getSchedule

Kullanıcı, dağıtım listesi veya kaynak için serbest/meşgul zamanlamasını alın.

Gerekli parametreler:

• zamanlamalar: Kullanıcıların veya kaynakların SMTP adresleri
• startTime: dateTime ve timeZone ile başlangıç zamanı
• endTime: dateTime ve timeZone ile bitiş zamanı

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• availabilityViewInterval: Dakika cinsinden zaman aralığı uzunluğu

mcp_CalendarTools_graph_listCalendarView

Bir kullanıcı için belirtilen zaman aralığındaki takvim oluşumlarını alma.

Gerekli parametreler:

• startDateTime: Zaman aralığının başlangıcı (ISO 8601)
• endDateTime: Zaman aralığı sonu (ISO 8601)

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• top: En fazla olay sayısı
• orderby: ORDER BY yan tümcesi

mcp_CalendarTools_graph_listEvents

Belirtilen kullanıcının takviminden olayların listesini alın.

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• startDateTime: Zaman aralığının başlangıcı (ISO 8601)
• endDateTime: Zaman aralığı sonu (ISO 8601)
• top: En fazla olay sayısı
• filter: OData filtre sorgusu
• orderby: Sorguya göre OData sırası

mcp_CalendarTools_graph_updateEvent

Belirtilen kullanıcının takvimindeki mevcut bir takvim olayını güncelleştirin.

Gerekli parametreler:

• eventId: Olayın benzersiz tanımlayıcısı

İsteğe bağlı parametreler:

• userId: Kullanıcı kimliği veya userPrincipalName
• konu: Güncelleştirilmiş konu
• gövde: Güncelleştirilmiş gövde içeriği
• başlangıç: Güncelleştirilmiş başlangıç saati
• end: Güncelleştirilmiş bitiş saati
• konum: Güncelleştirilmiş konum
• attendees_addresses: Güncelleştirilmiş katılımcı e-postaları
• attendees_types: Güncelleştirilmiş katılımcı türleri
• attendees_names: Güncelleştirilmiş katılımcı adları
• isCancelled: İptal etmek için true olarak ayarlayın
• yinelenme: Güncelleştirilmiş yinelenme düzeni

Temel özellikler

Etkinlik yönetimi

• Olaylar oluşturun, okuyun, güncelleyin ve silin.
• Davetiyeleri kabul edin, reddedin ve iptal edin.
• Tekrarlayan etkinlikler için destek.
• Çevrimiçi toplantılarla entegrasyon (Teams, Skype).

Kullanılabilirlik ve zamanlama

• Müsait/meşgul takvimlerini alın.
• Buluşma saatlerini bulun ve uygunluk kontrol yapın.
• Zaman aralığı filtreleme ile takvim görünümü.
• Katılımcı bulunabilirliği analizi.

Katılımcı yönetimi

• Gerekli, isteğe bağlı ve kaynak katılımcıları yönetin.
• Zaman önerileri için destek.
• Yanıtları takip edin.
• Dağıtım listeleri için destek.

Yinelenme desenleri

• Günlük, haftalık, aylık ve yıllık kalıplar.
• Mutlak ve göreceli tekrarlama.
• Bitiş tarihi veya olay sayı.
• Haftanın günü ve ay spesifikasyonları.

Çevrimiçi toplantılar

• İş için Teams ile tümleştirme
• Skype Kurumsal desteği
• Skype desteği (kişisel kullanım için)
• Otomatik toplantı bağlantısı oluşturma

Notlar

• Tüm zaman damgaları saat dilimi ile UTC/ISO 8601 biçimini kullanır
• Takvim MCP, kuruluştaki kullanıcıları bulmak için UserprofileMCP güvenir.
• E-posta adresleri geçerli bir formatta olmalıdır.
• Katılımcı dizileri (adresler, türler, adlar) aynı sırada olmalıdır
• Çevrimiçi toplantılar için isOnlineMeeting=true ve onlineMeetingProvider gerekir.
• Yinelenme hem desen hem de aralık nesneleri gerektirir
• Saat dilimleri başlangıç ve bitiş saatleri arasında tutarlı olmalıdır
• TransactionIdolay oluşturmayı etkinleştirir idempotent