Kalenderreferens (förhandsvisning)

Note

Denna artikel beskriver funktioner i agenter eller agentflöden som använder standard harness.

Important

Det här är en förhandsgranskningsfunktion.

  • Microsoft släpper förhandsversionsfunktioner före en officiell version så att kunderna kan få tidig åtkomst och ge feedback.
  • Förhandsgranskningsfunktioner har begränsade funktioner och är inte avsedda för produktionsanvändning.
  • Microsoft kan ändra mcp-verktygsnamn och parametrar för förhandsversionen. Undvik hårdkodade beroenden. Microsoft underhåller scenariostöd.
  • Förhandsgranskningsfunktioner omfattas av Microsoft kompletterande användningsvillkor.

Overview

Server-ID URL på klientorganisationsnivå Visningsnamn Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools
Kalender Verktyg för kalenderoperationer som att skapa, uppdatera, hämta händelser, hantera inbjudningar och kontrollera tillgänglighet.

Tillgängliga verktyg

mcp_CalendarTools_graph_acceptEvent

Acceptera den angivna händelseinbjudan i en användares kalender.

Obligatoriska parametrar:

  • eventId: ID:t för händelsen som ska accepteras

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • kommentar: Valfri text som ingår i svaret
  • sendResponse: Om du vill skicka svar till organisatören

mcp_CalendarTools_graph_avbrytHändelse

Avbryt en händelse i en angiven användares kalender och meddela deltagarna.

Obligatoriska parametrar:

  • eventId: Den unika identifieraren för händelsen som ska avbrytas

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • kommentar: Valfritt meddelande om annullering

mcp_CalendarTools_graph_createEvent

Skapa en ny kalenderhändelse i en angiven användares kalender. Stöder återkommande händelser och onlinemöten.

Obligatoriska parametrar:

  • ämne: Händelsens ämne eller titel (får inte vara tomt)
  • start: Starta tidsstämpeln med dateTime och timeZone
  • slut: Sluttidsstämpel med dateTime och timeZone
  • attendees_addresses: Matris med deltagares e-postadresser

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • body: Händelsens innehåll med contentType (Text/HTML) och innehåll
  • plats: Plats med displayName
  • attendees_types: Deltagarroller (obligatoriskt, valfritt, resurs)
  • attendees_names: Visningsnamn för deltagare
  • upprepning: Upprepningsmönster och intervall
  • isOnlineMeeting: Inställt på true för onlinemöte
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: Tillåt tidsförslag (standard: true)
  • transactionId: Idempotence identifierare

mcp_CalendarTools_graph_declineEvent

Neka den specificerade evenemangsinbjudan i en användares kalender.

Obligatoriska parametrar:

  • eventId: ID:t för händelsen som ska avvisas

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName

  • kommentar: Valfri text som svar

  • sendResponse: Om svaret ska skickas

mcp_CalendarTools_graf_raderahändelse

Ta bort en händelse från en angiven användares kalender.

Obligatoriska parametrar:

  • eventId: Den unika identifieraren för händelsen som ska tas bort

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Föreslå mötestider och platser baserat på organisatörs- och deltagartillgänglighet.

Obligatoriska parametrar:

  • meetingDuration: Mötesvaraktighet (till exempel "PT1H")

Valfria parametrar:

  • userId: organisatörens ID eller userPrincipalName
  • attendees_addresses: E-postadresser för deltagare
  • attendees_types: Deltagartyper
  • attendees_names: Visningsnamn för deltagare
  • timeConstraint: Tidstillgänglighet med timeslots och activityDomain
  • locationConstraint: Platsalternativ
  • maxCandidates: Maximalt antal förslag
  • isOrganizerOptional: Valfri organisatörsflagga
  • returnSuggestionReasons: Inkludera orsaker
  • minimumAttendeePercentage: Lägsta tröskelvärde för närvaro

mcp_CalendarTools_graph_getEvent

Hämta en enskild kalenderhändelse från en angiven användares kalender.

Obligatoriska parametrar:

  • eventId: Den unika identifieraren för händelsen

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • select: OData-frågeparameter \$select
  • expandera: OData \$expand för navigeringsegenskaper

mcp_CalendarTools_graph_getSchedule

Hämta ledig/upptagen-schemat för en användare, distributionslista eller resurs.

Obligatoriska parametrar:

  • scheman: SMTP-adresser för användare eller resurser
  • startTime: Starttid med dateTime och timeZone
  • endTime: Sluttid med dateTime och timeZone

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • availabilityViewInterval: Tidsintervallslängd i minuter

mcp_CalendarTools_graph_listCalendarView

Hämta kalenderförekomster inom ett angivet tidsintervall för en användare.

Obligatoriska parametrar:

  • startDateTime: Starttidsintervall (ISO 8601)
  • endDateTime: Tidsintervallets slut (ISO 8601)

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • överst: Maximalt antal händelser
  • orderby: ORDER BY-sats

mcp_CalendarTools_graph_listEvents

Hämta en lista över händelser från en angiven användares kalender.

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • startDateTime: Starttidsintervall (ISO 8601)
  • endDateTime: Tidsintervallets slut (ISO 8601)
  • överst: Maximalt antal händelser
  • filter: OData-filterfråga
  • orderby: OData-ordning efter fråga

mcp_CalendarTools_graph_updateEvent

Uppdatera en befintlig kalenderhändelse i en angiven användares kalender.

Obligatoriska parametrar:

  • eventId: Den unika identifieraren för händelsen

Valfria parametrar:

  • userId: Användar-ID eller userPrincipalName
  • ämne: Uppdaterat ämne
  • body: Uppdaterat brödtextinnehåll
  • start: Uppdaterad starttid
  • end: Uppdaterad sluttid
  • plats: Uppdaterad plats
  • attendees_addresses: Uppdaterade e-postmeddelanden för deltagare
  • attendees_types: Uppdaterade deltagartyper
  • attendees_names: Uppdaterade deltagarnamn
  • isCancelled: Ställ in på true för att avbryta
  • upprepning: Uppdaterat upprepningsmönster

Centrala egenskaper

Händelsehantering

  • Skapa, läsa, uppdatera och ta bort händelser.
  • Acceptera, tacka nej och avboka inbjudningar.
  • Stöd för återkommande händelser.
  • Integration med onlinemöten (Teams, Skype).

Tillgänglighet och schemaläggning

  • Få lediga/hektiska scheman.
  • Hitta mötetider med tillgänglighetskontroll.
  • Kalendervy med tidsintervallfiltrering.
  • Analys av deltagarnas tillgänglighet.

Deltagarhantering

  • Hantera obligatoriska, valfria och resursdeltagare.
  • Stöd för förslag på tider.
  • Följ svar.
  • Stöd för distributionslistor.

Upprepningsmönster

  • Dagliga, veckovisa, månatliga och årliga mönster.
  • Absolut och relativ återkomst.
  • Slutdatum eller antal händelser.
  • Specifikationer för veckodag och månad.

Onlinemöten

  • Integrering med Teams för företag
  • Stöd för Skype för företag
  • Stöd för Skype (för personligt bruk)
  • Automatisk generering av möteslänkar

Notes

  • Alla tidsstämplar använder UTC/ISO 8601-format med tidszon
  • Kalender-MCP förlitar sig på UserprofileMCP för att hitta användare i organisationen
  • E-postadresser måste vara i ett giltigt format
  • Deltagarmatriser (adresser, typer, namn) måste vara i samma ordning
  • Onlinemöten kräver isOnlineMeeting=true och onlineMeetingProvider
  • Upprepning kräver både mönster- och intervallobjekt
  • Tidszoner ska vara konsekventa mellan start- och sluttider
  • TransactionId aktiverar idempotent händelseskapande