Kalenteriviite (ennakko)

Note

Tässä artikkelissa kuvataan ominaisuuksia, joita käytetään agenteissa tai agenttivirroissa, joita käytetään standardivaljastuksen voimalla.

Important

Tämä on esiversiotoiminto.

  • Microsoft julkaisee esiversio-ominaisuuksia ennen virallista julkaisua, jotta asiakkaat voivat käyttää ja antaa palautetta ennen virallista julkaisua.
  • Esikatselutoiminnot toimivat rajoitetusti, eikä niitä ole tarkoitettu tuotantokäyttöön.
  • Microsoft saattavat muuttaa esikatselun MCP-työkalujen nimiä ja parametreja. Vältä kovakoodattuja riippuvuuksia. Microsoft ylläpitää skenaariotukea.
  • Esikatselutoimintoihin sovelletaan Microsoft lisäkäyttöehtoja.

Yleiskatsaus

Palvelintunnus Vuokraajatason URL-osoite Näyttönimi Kuvaus
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 Kalenteri Työkaluja kalenteritoimintoihin, kuten luomiseen, päivittämiseen, tapahtumien hakemaan, kutsujen hallintaan ja saatavuuden tarkistamiseen.

Käytettävissä olevat työkalut

mcp_CalendarTools_graph_acceptEvent

Hyväksy määritetty tapahtumakutsu käyttäjän kalenterissa.

Pakolliset parametrit:

  • eventId: Hyväksyttävän tapahtuman tunnus

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • comment: Valinnainen vastaus sisältää tekstin
  • sendResponse: Lähetetäänkö vastaus järjestäjälle

mcp_CalendarTools_graph_peruTapahtuma

Peruuta määritetyn käyttäjän kalenterissa oleva tapahtuma ja ilmoita siitä osallistujille.

Pakolliset parametrit:

  • eventId: Peruutettavan tapahtuman yksilöllinen tunnus

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • comment: Valinnainen peruutusviesti

mcp_CalendarTools_graph_createEvent

Luo uusi kalenteritapahtuma määritetyn käyttäjän kalenteriin. Tukee toistuvia tapahtumia ja verkkotapaamisia.

Pakolliset parametrit:

  • subject: Tapahtuman aihe tai otsikko (ei mitään)
  • start: Aloituksen aikaleima käyttäen dateTime ja timeZone
  • end: Päättymisaikaleima, jossa on dateTime ja timeZone
  • attendees_addresses: Osallistujan sähköpostiosoitteiden matriisi

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • body: Tapahtuman leipäteksti, jonka sisältötyyppi (teksti/HTML) ja sisältö
  • location: Sijainti, jossa displayName
  • attendees_types: Osallistujaroolit (pakollinen, valinnainen, resurssi)
  • attendees_names: Osallistujien näyttönimet
  • toistuvuus: toistuvuusmalli ja alue
  • isOnlineMeeting: Aseta arvoksi true verkkokokousta varten
  • onlineMeetingProvider: teamsForBusiness, , skypeForBusinessskypeForConsumer
  • allowNewTimeProposals: Salli aikaehdotukset (oletusarvo: tosi)
  • transactionId: Idempotence tunniste

mcp_CalendarTools_graph_declineEvent

Hylkää määritetty tapahtumakutsu käyttäjän kalenterissa.

Pakolliset parametrit:

  • eventId: Hylättävän tapahtuman tunnus

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName

  • comment: Valinnainen teksti vastaukseksi

  • sendResponse: Lähettääkö vastaus

mcp_CalendarTools_graph_deleteEvent

Tapahtuman poistaminen määritetyn käyttäjän kalenterista.

Pakolliset parametrit:

  • eventId: Poistettavan tapahtuman yksilöllinen tunnus

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Ehdota kokousaikoja ja -sijainteja järjestäjän ja osallistujien saatavuuden perusteella.

Pakolliset parametrit:

  • meetingDuration: Kokouksen kesto (esimerkiksi "PT1H")

Valinnaiset parametrit:

  • userId: Järjestäjän tunnus tai userPrincipalName
  • attendees_addresses: Osallistujien sähköpostiosoitteet
  • attendees_types: Osallistujatyypit
  • attendees_names: Osallistujien näyttönimet
  • timeConstraint: Ajan saatavuus timeslots käyttäen ja activityDomain
  • locationConstraint: Sijaintiasetukset
  • maxCandidates: Ehdotukset enintään
  • isOrganizerOptional: Järjestäjä valinnainen merkintä
  • returnSuggestionReasons: Sisällytä syitä
  • minimumAttendeePercentage: Läsnäolon vähimmäisraja

mcp_CalendarTools_graph_getEvent

Hae yksittäinen kalenteritapahtuma määritetyn käyttäjän kalenterista.

Pakolliset parametrit:

  • eventId: Tapahtuman yksilöllinen tunnus

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • select: OData-kyselyparametri \$select
  • expand: OData \$expand siirtymisominaisuuksille

mcp_CalendarTools_graph_getSchedule

Käyttäjän, jakeluluettelon tai resurssin maksuttoman/varattujen aikataulujen noutaminen.

Pakolliset parametrit:

  • schedules: käyttäjien tai resurssien SMTP-osoitteet
  • startTime: Aloitusaika muodossa dateTime ja timeZone
  • endTime: Päättymisaika, jossa on dateTime ja timeZone

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • availabilityViewInterval: Ajanjaksojen pituus minuutteina

mcp_KalenteriTyökalut_kaavio_listaKalenteriNäkymä

Hae kalenteriesiintymät määritetyltä aika-alueelta käyttäjälle.

Pakolliset parametrit:

  • startDateTime: aika-alueen alku (ISO 8601)
  • endDateTime: Aika-alueen loppu (ISO 8601)

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • top: Tapahtumien enimmäismäärä
  • orderby: järjestämislauseke

mcp_KalenteriTyökalut_kaavio_luetteloTapahtumat

Nouda tapahtumien luettelo määritetyn käyttäjän kalenterista.

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • startDateTime: aika-alueen alku (ISO 8601)
  • endDateTime: Aika-alueen loppu (ISO 8601)
  • top: Tapahtumien enimmäismäärä
  • filter: OData-suodatinkysely
  • orderby: OData-järjestys kyselyn mukaan

mcp_CalendarTools_päivitäTapahtumaa_graafissa

Päivitä olemassa oleva kalenteritapahtuma määritetyn käyttäjän kalenterissa.

Pakolliset parametrit:

  • eventId: Tapahtuman yksilöllinen tunnus

Valinnaiset parametrit:

  • userId: Käyttäjätunnus tai userPrincipalName
  • aihe: Päivitetty aihe
  • body: Päivitetty rungon sisältö
  • start: Päivitetty alkamisaika
  • end: Päivitetty päättymisaika
  • location: Päivitetty sijainti
  • attendees_addresses: Päivitetyt osallistujien sähköpostit
  • attendees_types: Päivitetyt osallistujatyypit
  • attendees_names: Päivitetyt osallistujien nimet
  • isCancelled: Peruuta määrittämällä arvoksi true
  • toistuvuus: päivitetty toistumiskaava

Tärkeimmät ominaisuudet

Tapahtumien hallinta

  • Luo, lue, päivitä ja poista tapahtumia.
  • Hyväksy, hylkää ja peruuta kutsut.
  • Tuki toistuville tapahtumille.
  • Integraatio verkkokokouksiin (Teams, skype).

Käytettävyys ja ajoitus

  • Saat vapaat/kiireiset aikataulut.
  • Löydä tapaamisajat saatavuuden tarkistusten perusteella.
  • Kalenterinäkymä aikavälin suodatuksella.
  • Osallistujien saatavuuden analyysi.

Osallistujien hallinta

  • Hallinnoi pakollisia, vapaaehtoisia ja resurssiosallistujia.
  • Tuki aikaehdotuksille.
  • Seuraa vastauksia.
  • Tuki jakelulistoille.

Toistuvuusmallit

  • Päivittäiset, viikoittaiset, kuukausittaiset ja vuosittaiset kaavat.
  • Absoluuttinen ja suhteellinen uusiutuminen.
  • Päättymispäivä tai esiintymismäärä.
  • Viikonpäivä- ja kuukausimääritykset.

Online-kokoukset

  • Integrointi Teams for Businessiin
  • Skype for Businessin tuki
  • skype tuki (henkilökohtaiseen käyttöön)
  • Automaattinen kokouslinkin muodostaminen

Muistiinpanot

  • Kaikki aikaleimat käyttävät UTC/ISO 8601 -muotoa ja aikavyöhykettä
  • Kalenterin MCP on riippuvainen UserprofileMCP organisaation käyttäjien löytämisestä
  • Sähköpostiosoitteiden muodon on oltava kelvollinen
  • Osallistujien matriisien (osoitteet, tyypit, nimet) on oltava samassa järjestyksessä
  • Verkkotapaamiset vaativat isOnlineMeeting=true ja onlineMeetingProvider
  • Toistuvuus edellyttää sekä malli- että alueobjekteja
  • Aikavyöhykkeiden on oltava yhdenmukaisia koko alkamis- ja päättymisaikana
  • TransactionId mahdollistaa idempotent tapahtuman luomisen
  • Last updated on