Kalenderreferentie (previewversie)

Note

Dit artikel beschrijft functies die worden gebruikt in agenten of agentstromen die gebruikmaken van het standard harness.

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.

Overzicht

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_grafiek_annuleerEvenement

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_afwijzenEvenement

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-queryparameter \$select
• uitvouwen: OData \$expand voor navigatie-eigenschappen

mcp_CalendarTools_graph_getSchedule

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

Vereiste parameters:

• planningen: 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-clausule

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 volgorde op 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

• Beheer verplichte, optionele en resource-aanwezigen.
• 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 koppeling voor vergadering

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