Riferimento al calendario (anteprima)

Note

Questo articolo descrive le caratteristiche utilizzate negli agenti o nei flussi di agenti alimentati dall'imbracatura standard.

Importante

Si tratta di 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 gli orari di disponibilità/impegni.
  • 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

  • Gestisci i partecipanti obbligatori, facoltativi e le risorse.
  • Supporto per le proposte di orario.
  • 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 del giorno della settimana e del 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

Notes

  • 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