Referência do calendário Work IQ (pré-visualização)

Overview

Ferramentas disponíveis

mcp_CalendarTools_graph_acceptEvent

Aceite o convite de evento especificado no calendário do utilizador.

Parâmetros necessários:

• eventId: O ID do evento a aceitar

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• comentário: Texto opcional incluído na resposta
• sendResponse: Se deve enviar a resposta ao organizador

mcp_CalendarTools_graph_cancelEvent

Cancele um evento no calendário de um utilizador específico e notifique os participantes.

Parâmetros necessários:

• eventId: O identificador único do evento a cancelar

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• comentário: Mensagem de cancelamento opcional

mcp_CalendarTools_graph_createEvent

Crie um novo evento no calendário de um utilizador especificado. Apoia eventos recorrentes e reuniões online.

Parâmetros necessários:

• assunto: Assunto do evento ou título (não vazio)
• início: Marca temporal de início com dateTime e timeZone
• fim: Fim da marca temporal com dateTime e timeZone
• attendees_addresses: Variedade de endereços de email dos participantes

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• corpo: Corpo do evento com contentType (Texto/HTML) e conteúdo
• localização: Localização com displayName
• attendees_types: Funções dos participantes (obrigatórias, opcionais, recursos)
• attendees_names: Os participantes mostram os nomes
• recorrência: Padrão e alcance de recorrência
• isOnlineMeeting: Defina como true para uma reunião online
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Permitir propostas de tempo (padrão: true)
• transactionId: Idempotence identificador

mcp_CalendarTools_graph_declineEvent

Recusar o convite para o evento especificado no calendário do utilizador.

Parâmetros necessários:

• eventId: o ID do evento a recusar

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName

• comentário: Texto opcional em resposta

• sendResponse: Se deve enviar a resposta

mcp_CalendarTools_graph_deleteEvent

Apagar um evento do calendário de um utilizador especificado.

Parâmetros necessários:

• eventId: O identificador único do evento a eliminar

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName

mcp_CalendarTools_grafico_encontrarHoráriosDeReunião

Sugira horários e locais das reuniões com base na disponibilidade do organizador e dos participantes.

Parâmetros necessários:

• Duração da reunião: Duração da reunião (por exemplo, 'PT1H')

Parâmetros opcionais:

• userId: Organizer ID ou userPrincipalName
• attendees_addresses: Endereços de email dos participantes
• attendees_types: Tipos de participantes
• attendees_names: Os participantes mostram os nomes
• timeConstraint: disponibilidade temporal com timeslots e activityDomain
• Restrição de localização: Opções de localização
• maxCandidates: Sugestões máximas
• isOrganizerOptional: Indicador opcional de organizador
• returnSuggestionReasons: Incluir os motivos
• minimumAttendeePercentage: Limiar mínimo de presença

mcp_CalendarTools_graph_getEvent

Obtenha um único evento do calendário de um utilizador específico.

Parâmetros necessários:

• eventId: O identificador único do evento

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• select: parâmetro de consulta OData \$select
• expandir: OData \$expand para propriedades de navegação

mcp_CalendarTools_graph_getSchedule

Obtenha a agenda livre/ocupada para um utilizador, lista de distribuição ou recurso.

Parâmetros necessários:

• agendas: endereços SMTP de utilizadores ou recursos
• Hora de início: Hora de início com dateTime e timeZone
• endTime: Hora de fim com dateTime e timeZone

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• availabilityViewInterval: Duração do intervalo de tempo em minutos

mcp_CalendarTools_graph_listCalendarView

Recuperar ocorrências do calendário dentro de um intervalo de tempo especificado para um utilizador.

Parâmetros necessários:

• startDateTime: Início do intervalo temporal (ISO 8601)
• endDateTime: Fim do intervalo de tempo (ISO 8601)

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• topo: Número máximo de eventos
• orderby: Cláusula ORDER BY

mcp_CalendarTools_graph_listEvents

Recupere uma lista de eventos do calendário de um utilizador especificado.

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• startDateTime: Início do intervalo temporal (ISO 8601)
• endDateTime: Fim do intervalo de tempo (ISO 8601)
• topo: Número máximo de eventos
• filter: consulta de filtro OData
• orderby: consulta OData de ordenação

mcp_CalendarTools_graph_updateEvent

Atualize um evento de calendário existente no calendário de um utilizador especificado.

Parâmetros necessários:

• eventId: O identificador único do evento

Parâmetros opcionais:

• userId: ID de utilizador ou userPrincipalName
• assunto: Assunto atualizado
• corpo: Conteúdo atualizado do corpo
• Início: Hora de início atualizada
• fim: Hora de fim atualizada
• localização: Localização atualizada
• attendees_addresses: Emails atualizados dos participantes
• attendees_types: Tipos de participantes atualizados
• attendees_names: Nomes atualizados dos participantes
• isCancelled: Defina como true para cancelar
• recorrência: Padrão de recorrência atualizado

Principais características

Gestão de eventos

• Criar, ler, atualizar e eliminar eventos
• Aceitar, recusar e cancelar convites
• Apoio a eventos recorrentes
• Integração com reuniões online (Teams, Skype)

Disponibilidade e agendamento

• Arranja horários livres/ocupados
• Encontre horários de reuniões com verificação de disponibilidade
• Vista de calendário com filtragem por intervalo temporal
• Análise da disponibilidade dos participantes

Gestão de participantes

• Gerir os participantes necessários, opcionais e de recursos
• Suporte para propostas de agendamento
• Acompanhar respostas
• Suporte para listas de distribuição

Padrões de recorrência

• Padrões diários, semanais, mensais e anuais
• Recorrência absoluta e relativa
• Data de fim ou contagem de ocorrências
• Especificações do dia da semana e do mês

Reuniões online

• Integração com o Teams for Business
• Suporte para Skype para Empresas
• Suporte para Skype (para uso pessoal)
• Geração automática de link de reuniões

Notes

• Todos os carimbos de data utilizam o formato UTC/ISO 8601 com fuso horário
• O Calendário MCP baseia-se em UserprofileMCP para encontrar utilizadores na organização
• Os endereços de email devem ter um formato válido
• Os arrays de participantes (endereços, tipos, nomes) devem estar na mesma ordem
• As reuniões online exigem isOnlineMeeting=true e onlineMeetingProvider
• A periodicidade requer tanto o objeto padrão como o objeto intervalo
• Os fusos horários devem ser consistentes entre as horas de início e fim
• TransactionId Permite idempotent a criação de eventos