Riferimento calendario (anteprima)

Note

Le funzionalità in questo articolo sono alimentate dallo standard harness, che utilizza le opzioni di fatturazione descritte in Licensing per gli agenti alimentati dallo standard harness. Impara come accedere alle funzionalità standard negli agenti standard Access e nei flussi degli agenti.

Importante

Questa è una funzionalità di anteprima.

  • Microsoft rilascia funzionalità di anteprima prima di una versione ufficiale, in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.
  • Le funzionalità di anteprima hanno funzionalità limitate e non sono destinate all'uso in produzione.
  • Microsoft potrebbero modificare i nomi e i parametri degli strumenti MCP in anteprima. Evitare le dipendenze codificate in modo rigido. Microsoft supporta questo scenario.
  • Le funzionalità di anteprima sono soggette a Microsoft condizioni supplementari per l'utilizzo.

Overview

ID del server URL a livello di tenant Nome visualizzato Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 Calendario Strumenti per operazioni di calendario come creare, aggiornare, recuperare eventi, gestire gli inviti e controllare la disponibilità.

Strumenti disponibili

mcp_CalendarTools_graph_acceptEvent

Accetta l'invito all'evento specificato nel calendario di un utente.

Parametri obbligatori:

  • eventId: ID dell'evento da accettare

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • commento: testo facoltativo incluso nella risposta
  • sendResponse: indica se inviare una risposta all'organizzatore

mcp_CalendarTools_grafico_annullaEvento

Annulla un evento nel calendario di un utente specificato e invia una notifica ai partecipanti.

Parametri obbligatori:

  • eventId: identificatore univoco dell'evento da annullare

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • commento: Messaggio di annullamento facoltativo

mcp_CalendarTools_graph_createEvent

Crea un nuovo evento di calendario nel calendario di un utente specificato. Supporta eventi ricorrenti e riunioni online.

Parametri obbligatori:

  • subject: Oggetto o titolo dell'evento (non vuoto)
  • start: timestamp di inizio con dateTime e timeZone
  • end: timestamp di fine con dateTime e timeZone
  • attendees_addresses: matrice di indirizzi di posta elettronica dei partecipanti

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • body: corpo dell'evento con contentType (Text/HTML) e contenuto
  • location: Posizione con displayName
  • attendees_types: ruoli partecipanti (obbligatorio, facoltativo, risorsa)
  • attendees_names: nomi visualizzati dei partecipanti
  • ricorrenza: criterio di ricorrenza e intervallo
  • isOnlineMeeting: impostare su true per la riunione online
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: Consenti proposte di tempo (impostazione predefinita: true)
  • transactionId: Idempotence identificatore

mcp_CalendarTools_graph_rifiutaEvento

Rifiuta l'invito all'evento specificato nel calendario di un utente.

Parametri obbligatori:

  • eventId: ID dell'evento da rifiutare

Parametri facoltativi:

  • userId: ID utente o userPrincipalName

  • commento: testo facoltativo in risposta

  • sendResponse: indica se inviare la risposta

mcp_CalendarTools_graph_deleteEvent

Elimina un evento dal calendario di un utente specificato.

Parametri obbligatori:

  • eventId: identificatore univoco dell'evento da eliminare

Parametri facoltativi:

  • userId: ID utente o userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Suggerisci orari e posizioni delle riunioni in base alla disponibilità degli organizzatori e dei partecipanti.

Parametri obbligatori:

  • meetingDuration: durata riunione (ad esempio, 'PT1H')

Parametri facoltativi:

  • userId: ID organizzatore o userPrincipalName
  • attendees_addresses: indirizzi di posta elettronica dei partecipanti
  • attendees_types: tipi di partecipanti
  • attendees_names: nomi visualizzati dei partecipanti
  • timeConstraint: disponibilità temporale con timeslots e activityDomain
  • locationConstraint: Opzioni posizione
  • maxCandidates: numero massimo di suggerimenti
  • isOrganizerOptional: Indicatore facoltativo dell'organizzatore
  • returnSuggestionReasons: Includi motivi
  • minimumAttendeePercentage: soglia minima di frequenza

mcp_CalendarTools_graph_getEvent

Recupera un singolo evento di calendario dal calendario di un utente specificato.

Parametri obbligatori:

  • eventId: identificatore univoco dell'evento

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • select: parametro di query OData \$select
  • expand: OData \$expand per le proprietà di navigazione

mcp_CalendarTools_graph_getSchedule

Recupera il calendario di disponibilità per un utente, una lista di distribuzione o una risorsa.

Parametri obbligatori:

  • pianificazioni: indirizzi SMTP di utenti o risorse
  • startTime: ora di inizio con dateTime e timeZone
  • endTime: Ora di termine con dateTime e timeZone

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • availabilityViewInterval: intervallo di tempo espresso in minuti

mcp_CalendarTools_graph_listCalendarView

Recupera le occorrenze del calendario all'interno di un intervallo di tempo specificato per un utente.

Parametri obbligatori:

  • startDateTime: inizio dell'intervallo di tempo (ISO 8601)
  • endDateTime: fine dell'intervallo di tempo (ISO 8601)

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • top: numero massimo di eventi
  • orderby: Clausola Order By

mcp_CalendarTools_graph_listEvents

Recupera un elenco di eventi dal calendario di un utente specificato.

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • startDateTime: inizio dell'intervallo di tempo (ISO 8601)
  • endDateTime: fine dell'intervallo di tempo (ISO 8601)
  • top: numero massimo di eventi
  • filter: query di filtro OData
  • orderby: OData order by per query

mcp_CalendarTools_graph_aggiornaEvento

Aggiorna un evento di calendario esistente nel calendario di un utente specificato.

Parametri obbligatori:

  • eventId: identificatore univoco dell'evento

Parametri facoltativi:

  • userId: ID utente o userPrincipalName
  • subject: Oggetto aggiornato
  • corpo: contenuto del corpo aggiornato
  • start: ora di inizio aggiornata
  • fine: ora di fine aggiornata
  • location: posizione aggiornata
  • attendees_addresses: messaggi di posta elettronica aggiornati dei partecipanti
  • attendees_types: tipi di partecipanti aggiornati
  • attendees_names: nomi aggiornati dei partecipanti
  • isCancelled: impostare su true per annullare
  • ricorrenza: criterio di ricorrenza aggiornato

Funzionalità principali

Gestione eventi

  • Creare, leggere, aggiornare ed eliminare eventi.
  • Accettare, rifiutare e annullare gli inviti.
  • Supporto per eventi ricorrenti.
  • Integrazione con le riunioni online (Teams, Skype).

Disponibilità e pianificazione

  • Ottieni orari liberi o pieni.
  • Trova gli orari degli incontri con il controllo della disponibilità.
  • Vista calendario con filtraggio per intervalli temporali.
  • Analisi della disponibilità dei partecipanti.

Gestione dei partecipanti

  • Gestire i partecipanti richiesti, opzionali e risorse.
  • Sostegno alle proposte di tempo.
  • Tieni traccia delle risposte.
  • Supporto per liste di distribuzione.

Criteri di ricorrenza

  • Schemi giornalieri, settimanali, mensili e annuali.
  • Recidiva assoluta e relativa.
  • Data di fine o conteggio delle occasioni.
  • Specifiche di giorno della settimana e mese.

Riunioni online

  • Integrazione con Teams for Business
  • Supporto per Skype for Business
  • Supporto per Skype (per uso personale)
  • Generazione automatica dei collegamenti alle riunioni

Note

  • Tutti i timestamp usano il formato UTC/ISO 8601 con fuso orario
  • Il calendario MCP si basa su UserprofileMCP per trovare gli utenti all'interno dell'organizzazione
  • Il formato degli indirizzi e-mail deve essere valido
  • Le matrici di partecipanti (indirizzi, tipi, nomi) devono essere nello stesso ordine
  • Le riunioni online richiedono isOnlineMeeting=true e onlineMeetingProvider
  • La ricorrenza richiede sia oggetti modello che oggetti intervallo
  • I fusi orari devono essere coerenti tra le ore di inizio e di fine
  • TransactionId Abilita idempotent la creazione di eventi
  • Last updated on