Kalenderreferentie (previewversie)

Note

In dit artikel worden functies beschreven die worden gebruikt in agents of agentstromen die mogelijk worden gemaakt met het standaardharnas.

Important

Dit is een preview-functie.

  • Microsoft brengt previewfuncties uit vóór een officiële release, zodat klanten vroegtijdig toegang kunnen krijgen en feedback kunnen geven.
  • Preview-functies hebben beperkte functionaliteit en zijn niet bedoeld voor productiegebruik.
  • Microsoft kan de namen en parameters van het MCP-hulpprogramma preview wijzigen. Vermijd in code vastgelegde afhankelijkheden. Microsoft ondersteuning voor scenario's onderhoudt.
  • Preview-functies zijn onderhevig aan Microsoft aanvullende gebruiksvoorwaarden.

Note

Applicatiespecifieke Microsoft 365 MCP-tools (Copilot, Agenda, Mail, SharePoint, OneDrive, Teams, Gebruiker en Word) zijn uitsluitend bedoeld voor achterwaartse compatibiliteit en mogen niet worden gebruikt in productieomgevingen of nieuwe projecten. Voor nieuwe projecten die toegang tot Microsoft 365-bronnen vereisen, gebruik Work IQ MCP met de GitHub Copilot-kabelboom. Voor meer informatie, zie Work IQ MCP in Copilot Studio.

Overview

Server-id URL op tenantniveau weergavenaam Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 Kalender Hulpmiddelen voor agenda-operaties zoals het aanmaken, bijwerken, ophalen van gebeurtenissen, het beheren van uitnodigingen en het controleren van beschikbaarheid.

Beschikbare hulpmiddelen

mcp_CalendarTools_graph_acceptEvent

Accepteer de opgegeven gebeurtenisuitnodiging in de agenda van een gebruiker.

Vereiste parameters:

  • eventId: de id van de gebeurtenis die moet worden geaccepteerd

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • opmerking: Optionele tekst die is opgenomen in het antwoord
  • sendResponse: of het antwoord naar de organisator moet worden verzonden

mcp_CalendarTools_graph_cancelEvent

Annuleer een gebeurtenis in de agenda van een opgegeven gebruiker en informeer deelnemers.

Vereiste parameters:

  • eventId: de unieke id van de gebeurtenis die moet worden geannuleerd

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • opmerking: Optioneel annuleringsbericht

mcp_CalendarTools_graph_createEvent

Maak een nieuwe agendagebeurtenis in de agenda van een opgegeven gebruiker. Ondersteunt terugkerende gebeurtenissen en onlinevergaderingen.

Vereiste parameters:

  • onderwerp: Onderwerp of titel van evenement (niet leeg)
  • start: begintijdstempel met dateTime en timeZone
  • end: Eindtijdstempel met dateTime en timeZone
  • attendees_addresses: Matrix met e-mailadressen van deelnemers

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • hoofdtekst: Hoofdtekst van gebeurtenis met contentType (Tekst/HTML) en inhoud
  • locatie: Locatie met displayName
  • attendees_types: Deelnemersrollen (vereist, optioneel, resource)
  • attendees_names: Weergavenamen van deelnemers
  • herhaling: Herhalingspatroon en -bereik
  • isOnlineMeeting: ingesteld op true voor een onlinevergadering
  • onlineMeetingProvider: teamsForBusiness, skypeForBusinessskypeForConsumer
  • allowNewTimeProposals: Tijdvoorstellen toestaan (standaard: true)
  • transactionId: Idempotence identificatie

mcp_CalendarTools_graph_declineEvent

De opgegeven gebeurtenisuitnodiging weigeren in de agenda van een gebruiker.

Vereiste parameters:

  • eventId: de ID van het event dat moet worden geweigerd

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName

  • opmerking: Optionele tekst in antwoord

  • sendResponse: of antwoord moet worden verzonden

mcp_CalendarTools_grafiek_verwijderEvent

Een gebeurtenis verwijderen uit de agenda van een opgegeven gebruiker.

Vereiste parameters:

  • eventId: de unieke id van de gebeurtenis die moet worden verwijderd

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Stel vergadertijden en locaties voor op basis van de beschikbaarheid van organisatoren en deelnemers.

Vereiste parameters:

  • meetingDuration: Duur van vergadering (bijvoorbeeld 'PT1H')

Optionele parameters:

  • userId: organisator-id of userPrincipalName
  • attendees_addresses: e-mailadressen van deelnemers
  • attendees_types: Deelnemerstypen
  • attendees_names: Weergavenamen van deelnemers
  • timeConstraint: Beschikbaarheid van tijd met timeslots en activityDomain
  • locationConstraint: Locatieopties
  • maxCandidates: maximum aantal suggesties
  • isOrganizerOptional: vlag voor optionele organisator
  • returnSuggestionReasons: Redenen opnemen
  • minimumAttendeePercentage: Minimumdrempel voor aanwezigheid

mcp_CalendarTools_graph_getEvent

Eén agendagebeurtenis ophalen uit de agenda van een opgegeven gebruiker.

Vereiste parameters:

  • eventId: de unieke id van de gebeurtenis

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • select: OData-\$select-queryparameter
  • uitvouwen: OData \$expand voor navigatie-eigenschappen

mcp_CalendarTools_graph_getSchedule

Vraag het beschikbaarheidsschema voor een gebruiker, distributielijst of bron op.

Vereiste parameters:

  • schedules: SMTP-adressen van gebruikers of resources
  • startTime: Begintijd met dateTime en timeZone
  • endTime: Eindtijd met dateTime en timeZone

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • availabilityViewInterval: tijdsleuflengte in minuten

mcp_CalendarTools_graph_listCalendarView

Kalendergebeurtenissen ophalen binnen een bepaalde tijdsperiode voor een gebruiker.

Vereiste parameters:

  • startDateTime: Begin van tijdsbereik (ISO 8601)
  • endDateTime: Einde van het tijdbereik (ISO 8601)

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • top: Maximum aantal gebeurtenissen
  • orderby: Order by-component

mcp_CalendarTools_graph_listEvents

Haal een lijst met gebeurtenissen op uit de agenda van een opgegeven gebruiker.

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • startDateTime: Begin van tijdsbereik (ISO 8601)
  • endDateTime: Einde van het tijdbereik (ISO 8601)
  • top: Maximum aantal gebeurtenissen
  • filter: OData-filterquery
  • orderby: OData order by-query

mcp_CalendarTools_graph_updateEvent

Een bestaande agendagebeurtenis bijwerken in de agenda van een opgegeven gebruiker.

Vereiste parameters:

  • eventId: de unieke id van de gebeurtenis

Optionele parameters:

  • userId: Gebruikers-id of userPrincipalName
  • onderwerp: Bijgewerkt onderwerp
  • hoofdtekst: Bijgewerkte hoofdtekstinhoud
  • start: Begintijd bijgewerkt
  • einde: Bijgewerkte eindtijd
  • locatie: Bijgewerkte locatie
  • attendees_addresses: e-mailberichten van genodigden bijgewerkt
  • attendees_types: Bijgewerkte typen deelnemers
  • attendees_names: Namen van deelnemers bijgewerkt
  • isCancelled: Ingesteld op true om te annuleren
  • terugkeerpatroon: bijgewerkt terugkeerpatroon

Belangrijkste kenmerken

Gebeurtenisbeheer

  • Maak, lees, werk evenementen bij en verwijder ze.
  • Accepteer, weiger en annuleer uitnodigingen.
  • Ondersteuning voor terugkerende gebeurtenissen.
  • Integratie met online vergaderingen (Teams, Skype).

Beschikbaarheid en planning

  • Krijg vrije/drukke schema's.
  • Vind vergadertijden met beschikbaarheidscontrole.
  • Kalenderweergave met tijdsintervalfiltering.
  • Analyse van de beschikbaarheid van deelnemers.

Beheer van deelnemers

  • Vereiste, optionele en resourcedeelnemers beheren.
  • Steun voor tijdvoorstellen.
  • Houd de antwoorden bij.
  • Ondersteuning voor distributielijsten.

Terugkeerpatronen

  • Dagelijkse, wekelijkse, maandelijkse en jaarlijkse patronen.
  • Absolute en relatieve herhaling.
  • Einddatum of aantal herhalingen.
  • Specificaties voor de dag van de week en de maand.

Onlinevergaderingen

  • Integratie met Teams voor Bedrijven
  • Ondersteuning voor Skype voor Bedrijven
  • Ondersteuning voor Skype (voor persoonlijk gebruik)
  • Automatisch genereren van een vergaderingskoppeling

Aantekeningen

  • Alle tijdstempels gebruiken het UTC/ISO 8601 formaat met tijdzone-informatie.
  • Calendar MCP gebruikt UserprofileMCP om gebruikers in de organisatie te vinden
  • E-mailadressen moeten in een geldig formaat zijn.
  • Deelnemersmatrices (adressen, typen, namen) moeten zich in dezelfde volgorde bevinden
  • Onlinevergaderingen vereisen isOnlineMeeting=true en onlineMeetingProvider
  • Herhaling vereist zowel patroon- als bereikobjecten.
  • Tijdzones moeten consistent zijn voor de begin- en eindtijden
  • TransactionId idempotent maakt het maken van gebeurtenissen mogelijk
  • Laatst bijgewerkt om