Kalenderreference (forhåndsvisning)

Bemærkning

Funktionerne i denne artikel drives af standardledningsnettet, som bruger de faktureringsmuligheder beskrevet i Licensering for agenter drevet af standardledningsnettet. Lær, hvordan du får adgang til standardfunktioner i Access standardagenter og agentflows.

Vigtig

Dette er en prøveversionsfunktion.

• Microsoft udgiver prøveversionsfunktioner før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
• Prøveversionsfunktioner har begrænset funktionalitet og er ikke beregnet til produktionsbrug.
• Microsoft kan ændre navnene og parametrene for MCP-værktøjer i prøveversion. Undgå hardkodede afhængigheder. Microsoft vedligeholder scenariesupport.
• Prøveversionsfunktioner er underlagt Microsoft supplerende vilkår for anvendelse.

Oversigt

Server-ID	URL-adresse på lejerniveau	Vis navn	Beskrivelse
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Kalender	Værktøjer til kalenderoperationer som oprettelse, opdatering, hentning af begivenheder, håndtering af invitationer og kontrol af tilgængelighed.

Tilgængelige værktøjer

mcp_CalendarTools_graph_acceptEvent

Acceptér den angivne hændelsesinvitation i en brugers kalender.

Påkrævede parametre:

• eventId: Id'et for den hændelse, der skal accepteres

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• kommentar: Valgfri tekst, der er inkluderet i svaret
• sendResponse: Om svar skal sendes til arrangøren

mcp_CalendarTools_graph_cancelEvent

Annuller en begivenhed i en angivet brugers kalender, og giv deltagerne besked.

Påkrævede parametre:

• eventId: Det entydige id for den hændelse, der skal annulleres

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• kommentar: Valgfri annulleringsmeddelelse

mcp_CalendarTools_graph_createEvent

Opret en ny kalenderhændelse i en angivet brugers kalender. Understøtter tilbagevendende begivenheder og onlinemøder.

Påkrævede parametre:

• emne: Hændelsesemne eller titel (nonempty)
• start: Starttidsstempel med dateTime og timeZone
• end: Sluttidsstempel med dateTime og timeZone
• attendees_addresses: Matrix af deltagernes mailadresser

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• brødtekst: Hændelsesbrødtekst med contentType (tekst/HTML) og indhold
• placering: Placering med displayName
• attendees_types: Deltagerroller (påkrævet, valgfri, ressource)
• attendees_names: Visningsnavne for deltagere
• gentagelse: Gentagelsesmønster og interval
• isOnlineMeeting: Angiv som true for et onlinemøde
• onlineMødeUdbyder: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Tillad tidsforslag (standardværdi: true)
• transactionId: Idempotence identifikator

mcp_CalendarTools_graph_declineEvent

Afvis den angivne hændelsesinvitation i en brugers kalender.

Påkrævede parametre:

• eventId: Id'et for den hændelse, der skal afvises

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName

• kommentar: Valgfri tekst i svar

• sendResponse: Om svar skal sendes

mcp_CalendarTools_graph_deleteEvent

Slet en hændelse fra en angivet brugers kalender.

Påkrævede parametre:

• eventId: Det entydige id for den hændelse, der skal slettes

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Foreslå mødetider og placeringer baseret på arrangørens og deltagernes tilgængelighed.

Påkrævede parametre:

• meetingDuration: Mødevarighed (f.eks. 'PT1H')

Valgfrie parametre:

• userId: Assistent-id eller userPrincipalName
• attendees_addresses: Mailadresser til deltagere
• attendees_types: Deltagertyper
• attendees_names: Visningsnavne for deltagere
• timeConstraint: Tidstilgængelighed med timeslots og activityDomain
• locationConstraint: Indstillinger for placering
• maxCandidates: Maksimalt antal forslag
• isOrganizerOptional: Valgfrit-flag for organisator
• returnSuggestionReasons: Medtag årsager
• minimumAttendeePercentage: Mindste tærskel for fremmøde

mcp_CalendarTools_graph_getEvent

Hent en enkelt kalenderhændelse fra en angivet brugers kalender.

Påkrævede parametre:

• eventId: Hændelsens entydige id

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• select: OData-forespørgselsparameter \$select
• udvid: OData \$expand til navigationsegenskaber

mcp_CalendarTools_graph_getSchedule

Hent tidsplanen for ledig/optaget tid for en bruger, distributionsliste eller ressource.

Påkrævede parametre:

• tidsplaner: SMTP-adresser på brugere eller ressourcer
• startTime: Starttidspunkt med dateTime og timeZone
• endTime: Sluttidspunkt med dateTime og timeZone

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• availabilityViewInterval: Tidsintervallængde i minutter

mcp_Kalenderværktøjer_graf_listeKalendervisning

Hent kalenderforekomster inden for et angivet tidsinterval for en bruger.

Påkrævede parametre:

• startDateTime: Start af tidsinterval (ISO 8601)
• endDateTime: Slut på tidsinterval (ISO 8601)

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• top: Maksimalt antal hændelser
• orderby: Order by-klausul

mcp_CalendarTools_graph_listEvents

Hent en liste over hændelser fra en angivet brugers kalender.

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• startDateTime: Start af tidsinterval (ISO 8601)
• endDateTime: Slut på tidsinterval (ISO 8601)
• top: Maksimalt antal hændelser
• filter: OData-filterforespørgsel
• orderby: OData-rækkefølge efter forespørgsel

mcp_CalendarTools_graph_updateEvent

Opdater en eksisterende kalenderhændelse i en angivet brugers kalender.

Påkrævede parametre:

• eventId: Hændelsens entydige id

Valgfrie parametre:

• userId: Bruger-id eller userPrincipalName
• emne: Opdateret emne
• brødtekst: Opdateret brødtekst
• start: Opdateret starttidspunkt
• slut: Opdateret sluttidspunkt
• placering: Opdateret placering
• attendees_addresses: Opdaterede deltagermails
• attendees_types: Opdaterede deltagertyper
• attendees_names: Opdaterede navne på deltagere
• isCancelled: Angiv til true for at annullere
• gentagelse: Opdateret gentagelsesmønster

Vigtige funktioner

Arrangementsstyring

• Opnæl, læs, opdater og slet begivenheder.
• Accepter, afvis og afmeld invitationer.
• Støtte til tilbagevendende begivenheder.
• Integration med onlinemøder (Teams, skype).

Tilgængelighed og planlægning

• Få frie/travle skemaer.
• Find mødetider med tilgængelighedstjek.
• Kalendervisning med tidsintervalfiltrering.
• Analyse af deltagertilgængelighed.

Administration af deltagere

• Håndter obligatoriske, valgfrie og ressourcedeltagere.
• Støtte til tidsforslag.
• Følg svarene.
• Støtte til distributionslister.

Gentagelsesmønstre

• Daglige, ugentlige, månedlige og årlige mønstre.
• Absolut og relativ tilbagefald.
• Slutdato eller forekomsttælling.
• Ugedag- og månedsspecifikationer.

Onlinemøder

• Integration med Teams for Business
• Understøttelse af Skype for Business
• Understøttelse af skype (til personlig brug)
• Generering af automatisk mødelink

Bemærkninger

• Alle tidsstempel bruger UTC/ISO 8601-format med tidszone
• McP-kalenderen er afhængig UserprofileMCP af at finde brugere i organisationen
• Mailadresser skal være et gyldigt format
• Deltagermatrixer (adresser, typer, navne) skal være i samme rækkefølge
• Onlinemøder kræver isOnlineMeeting=true og onlineMeetingProvider
• Gentagelse kræver både mønster- og områdeobjekter
• Tidszoner skal være ensartede på tværs af start- og sluttidspunkter
• TransactionId aktiverer idempotent oprettelse af hændelse