Acuan kalender (pratinjau)

Note

Artikel ini menjelaskan fitur yang digunakan oleh agen atau alur agen yang didukung oleh standard harness.

Important

Ini adalah fitur pratinjau.

• Microsoft merilis fitur pratinjau sebelum rilis resmi sehingga pelanggan bisa mendapatkan akses awal dan memberikan umpan balik.
• Fitur pratinjau memiliki fungsionalitas terbatas dan tidak dimaksudkan untuk penggunaan produksi.
• Microsoft mungkin mengubah nama dan parameter pratinjau untuk alat MCP. Hindari dependensi yang dikodekan secara permanen. Microsoft mempertahankan dukungan skenario.
• Fitur pratinjau tunduk pada ketentuan penggunaan tambahan Microsoft.

Note

Alat Microsoft 365 MCP khusus aplikasi (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User, dan Word) hanya ditujukan untuk keperluan kompatibilitas mundur dan tidak boleh digunakan di lingkungan produksi atau proyek baru. Untuk proyek baru yang memerlukan akses ke sumber daya Microsoft 365, gunakan Work IQ MCP dengan harness GitHub Copilot. Untuk informasi lebih lanjut, lihat Work IQ MCP di Copilot Studio.

Overview

ID Server	URL tingkat penyewa	Nama tampilan	Description
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Kalender	Alat untuk operasi kalender seperti membuat, memperbarui, mengambil acara, mengelola undangan, dan memeriksa ketersediaan.

Alat yang tersedia

mcp_CalendarTools_graph_acceptEvent

Terima undangan acara yang ditentukan di kalender pengguna.

Parameter yang diperlukan:

• eventId: ID acara yang akan diterima

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• komentar: Teks opsional disertakan dalam respons
• sendResponse: Apakah akan mengirim respons ke penyelenggara

mcp_AlatKalender_graph_batalkanAcara

Batalkan acara di kalender pengguna tertentu dan beri tahu peserta.

Parameter yang diperlukan:

• eventId: Pengidentifikasi unik peristiwa yang akan dibatalkan

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• komentar: Pesan pembatalan opsional

mcp_CalendarTools_graph_createEvent

Buat acara kalender baru di kalender pengguna tertentu. Mendukung acara berulang dan rapat online.

Parameter yang diperlukan:

• subjek: Subjek atau judul peristiwa (tidak ada)
• start: Mulai tanda waktu dengan dateTime dan timeZone
• end: Akhiri tanda waktu dengan dateTime dan timeZone
• attendees_addresses: Array dari alamat email peserta

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• isi: Isi acara dengan contentType (Teks/HTML) dan konten
• lokasi: Lokasi dengan displayName
• attendees_types: Peran peserta (diperlukan, opsional, sumber daya)
• attendees_names: Nama tampilan peserta
• pengulangan: Pola dan rentang pengulangan
• isOnlineMeeting: Atur ke true untuk rapat online
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Izinkan pengajuan waktu (default: true)
• transactionId: Idempotence pengidentifikasi

mcp_CalendarTools_graph_declineEvent

Tolak undangan acara yang ditentukan di kalender pengguna.

Parameter yang diperlukan:

• eventId: ID peristiwa yang akan ditolak

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName

• komentar: Teks opsional sebagai respons

• sendResponse: Apakah akan mengirim respons

mcp_CalendarTools_graph_deleteEvent

Menghapus acara dari kalender pengguna tertentu.

Parameter yang diperlukan:

• eventId: Pengidentifikasi unik peristiwa yang akan dihapus

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sarankan waktu rapat dan lokasi berdasarkan ketersediaan penyelenggara dan peserta.

Parameter yang diperlukan:

• meetingDuration: Durasi rapat (misalnya, 'PT1H')

Parameter opsional:

• userId: ID Pengatur atau userPrincipalName
• attendees_addresses: Alamat email peserta
• attendees_types: Jenis peserta
• attendees_names: Nama tampilan peserta
• timeConstraint: Ketersediaan waktu dengan timeslots dan activityDomain
• locationConstraint: Opsi lokasi
• maxCandidates: Jumlah saran maksimum
• isOrganizerOptional: Penanda bahwa penyelenggara bersifat opsional
• returnSuggestionReasons: Menyertakan alasan
• minimumAttendeePercentage: Ambang batas kehadiran minimum

mcp_CalendarTools_graph_getEvent

Dapatkan satu acara kalender dari kalender pengguna tertentu.

Parameter yang diperlukan:

• eventId: Pengidentifikasi unik peristiwa

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• pilih: Parameter kueri OData \$select
• perluas: OData \$expand untuk properti navigasi

mcp_CalendarTools_graph_getSchedule

Dapatkan jadwal bebas/sibuk untuk pengguna, daftar distribusi, atau sumber daya.

Parameter yang diperlukan:

• jadwal: Alamat SMTP pengguna atau sumber daya
• startTime: Waktu mulai dengan dateTime dan timeZone
• endTime: Waktu berakhir dengan dateTime dan timeZone

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• availabilityViewInterval: Panjang slot waktu dalam menit

mcp_CalendarTools_graph_listCalendarView

Mendapatkan kejadian pada kalender dalam rentang waktu tertentu untuk pengguna.

Parameter yang diperlukan:

• startDateTime: Rentang waktu mulai (ISO 8601)
• endDateTime: Akhir rentang waktu (ISO 8601)

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• top: Jumlah maksimum kejadian
• orderby: Urutan berdasarkan klausa

mcp_CalendarTools_graph_listEvents

Ambil daftar acara dari kalender pengguna tertentu.

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• startDateTime: Rentang waktu mulai (ISO 8601)
• endDateTime: Akhir rentang waktu (ISO 8601)
• atas: Jumlah maksimum peristiwa
• filter: Kueri filter OData
• orderby: Urutan OData menurut kueri

mcp_CalendarTools_graph_updateEvent

Perbarui acara kalender yang sudah ada di kalender pengguna tertentu.

Parameter yang diperlukan:

• eventId: Pengidentifikasi unik peristiwa

Parameter opsional:

• userId: ID Pengguna atau userPrincipalName
• subjek: Subjek yang diperbarui
• isi: Konten isi yang diperbarui
• mulai: Waktu mulai yang diperbarui
• akhir: Waktu akhir yang diperbarui
• lokasi: Lokasi yang diperbarui
• attendees_addresses: Email peserta yang diperbarui
• attendees_types: Jenis peserta yang diperbarui
• attendees_names: Nama peserta yang diperbarui
• isCancelled: Atur ke true untuk membatalkan
• pengulangan: Pola pengulangan yang diperbarui

Fitur utama

Manajemen acara

• Buat, baca, perbarui, dan hapus acara.
• Terima, tolak, dan batalkan undangan.
• Dukungan untuk kejadian berulang.
• Integrasi dengan rapat online (Teams, Skype).

Ketersediaan dan penjadwalan

• Dapatkan jadwal yang bebas/sibuk.
• Temukan waktu pertemuan dengan pemeriksaan ketersediaan.
• Tampilan kalender dengan penyaringan rentang waktu.
• Analisis ketersediaan peserta.

Manajemen peserta

• Kelola peserta yang diperlukan, opsional, dan sumber daya.
• Dukungan untuk usulan waktu.
• Pantau respons.
• Dukungan untuk daftar distribusi.

Pola Pengulangan

• Pola harian, mingguan, bulanan, dan tahunan.
• Rekurensi absolut dan relatif.
• Tanggal akhir atau jumlah kejadian.
• Spesifikasi hari dalam minggu dan bulan.

Rapat Online

• Integrasi dengan Teams for Business
• Dukungan untuk Skype for Business
• Dukungan untuk Skype (untuk penggunaan pribadi)
• Pembuatan tautan rapat otomatis

Notes

• Semua tanda waktu menggunakan format UTC/ISO 8601 dengan zona waktu
• MCP Kalender mengandalkan UserprofileMCP untuk menemukan pengguna di organisasi
• Format email harus valid.
• Array peserta (alamat, jenis, nama) harus berada dalam urutan yang sama
• Rapat online memerlukan isOnlineMeeting=true dan onlineMeetingProvider
• Pengulangan memerlukan objek pola dan rentang
• Zona waktu harus konsisten di seluruh waktu mulai dan berakhir
• TransactionId idempotent mengaktifkan pembuatan peristiwa