Referência do calendário (prévia)

Note

Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.

Importante

Este é um recurso em versão preliminar.

• Microsoft libera recursos de visualização antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer comentários.
• Os recursos de visualização têm funcionalidade restrita e não são destinados ao uso de produção.
• A Microsoft pode alterar os nomes e os parâmetros das ferramentas MCP em versão prévia. Evite dependências codificadas. A Microsoft mantém suporte a cenários.
• Os recursos de visualização estão sujeitos a Microsoft termos de uso complementares.

Visão geral

ID de servidor	URL no nível do locatário	Nome de exibição	Description
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Calendário	Ferramentas para operações de calendário como criar, atualizar, recuperar eventos, gerenciar convites e verificar disponibilidade.

Ferramentas disponíveis

mcp_CalendarTools_graph_acceptEvent

Aceite o convite para o evento especificado no calendário do usuário.

Parâmetros requeridos:

• eventId: A ID do evento a ser aceito

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• comentário: Texto opcional incluído em resposta
• sendResponse: se deseja enviar resposta ao organizador

mcp_CalendarTools_graph_cancelEvent

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

Parâmetros requeridos:

• eventId: o identificador exclusivo do evento a ser cancelado

Parâmetros opcionais:

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

mcp_CalendarTools_graph_createEvent

Crie um novo evento no calendário de um usuário específico. Apoia eventos recorrentes e reuniões online.

Parâmetros requeridos:

• subject: Assunto ou título do evento (não vazio)
• start: Carimbo de data e hora inicial com dateTime e timeZone
• fim: Carimbo de data/hora de término com dateTime e timeZone
• attendees_addresses: Matriz de endereços de email do participante

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• body: Corpo do evento com contentType (Texto/HTML) e conteúdo
• localização: Localização com displayName
• attendees_types: Funções de participante (obrigatório, opcional, recurso)
• attendees_names: Nomes de exibição do participante
• recorrência: padrão e intervalo de recorrência
• isOnlineMeeting: Configure como 'true' para reunião online
• ProvedorReuniãoOnline: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Permitir novas propostas de horário (padrão: true)
• transactionId: Idempotence identificador

mcp_CalendarTools_grafico_recusarEvento

Recuse o convite para evento especificado no calendário do usuário.

Parâmetros requeridos:

• eventId: O ID do evento a ser recusado

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName

• comentário: Texto opcional em resposta

• sendResponse: se a resposta deve ser enviada

mcp_CalendarTools_graph_deleteEvent

Exclua um evento do calendário de um usuário específico.

Parâmetros requeridos:

• eventId: o identificador exclusivo do evento a ser excluído

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugera horários e locais de reunião com base na disponibilidade do organizador e dos participantes.

Parâmetros requeridos:

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

Parâmetros opcionais:

• userId: ID do organizador ou userPrincipalName
• attendees_addresses: Endereços de email do participante
• attendees_types: Tipos de participante
• attendees_names: Nomes de exibição do participante
• restrição de tempo: disponibilidade de tempo com timeslots e activityDomain
• locationConstraint: opções de localização
• maxCandidates: Sugestões máximas
• isOrganizerOptional: Sinalizador opcional do organizador
• returnSuggestionReasons: incluir motivos
• minimumAttendeePercentage: limite mínimo de atendimento

mcp_CalendarTools_graph_getEvent

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

Parâmetros requeridos:

• eventId: o identificador exclusivo do evento

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• select: parâmetro de consulta OData \$select
• expand: OData \$expand para propriedades de navegação

mcp_CalendarTools_graph_getSchedule

Obtenha a agenda livre/movimentada para um usuário, lista de distribuição ou recurso.

Parâmetros requeridos:

• agendas: endereços SMTP de usuários ou recursos
• startTime: hora de início com dateTime e timeZone
• endTime: Hora de término com dateTime e timeZone

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• availabilityViewInterval: tempo de intervalo em minutos

mcp_CalendarTools_graph_listCalendarView

Recupere ocorrências do calendário dentro de um intervalo de tempo especificado para o usuário.

Parâmetros requeridos:

• startDateTime: início do intervalo de tempo (ISO 8601)
• endDateTime: intervalo de tempo de término (ISO 8601)

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• top: número máximo de eventos
• orderby: Cláusula Order by

mcp_CalendarTools_grafico_listarEventos

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

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• startDateTime: início do intervalo de tempo (ISO 8601)
• endDateTime: intervalo de tempo de término (ISO 8601)
• top: número máximo de eventos
• filtro: consulta de filtro OData
• orderby: Ordem por consulta OData

mcp_CalendarTools_graph_updateEvent

Atualize um evento de calendário existente no calendário de um usuário específico.

Parâmetros requeridos:

• eventId: o identificador exclusivo do evento

Parâmetros opcionais:

• userId: ID do usuário ou userPrincipalName
• assunto: Assunto atualizado
• body: Conteúdo do corpo atualizado
• start: Hora de início atualizada
• fim: Hora de término atualizada
• local: Local atualizado
• attendees_addresses: Emails de participantes atualizados
• attendees_types: Tipos de participantes atualizados
• attendees_names: Nomes de participantes atualizados
• isCancelled: Definido como true para cancelar
• recorrência: padrão de recorrência atualizado

Principais recursos

Gerenciamento de eventos

• Criar, ler, atualizar e excluir eventos.
• Aceite, recuse e cancele convites.
• Suporte para eventos recorrentes.
• Integração com reuniões online (Teams, Skype).

Disponibilidade e agendamento

• Tenha horários livres/ocupados.
• Encontre horários de reunião com verificação de disponibilidade.
• Visualização de calendário com filtragem por intervalo de tempo.
• Análise da disponibilidade dos participantes.

Gestão dos participantes

• Gerencie os participantes obrigatórios, opcionais e de recursos.
• Suporte a propostas de horário.
• Acompanhe as respostas.
• Suporte para listas de distribuição.

Padrão de recorrência

• Padrões diários, semanais, mensais e anuais.
• Recidiva absoluta e relativa.
• Data de término 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 for Business
• Suporte para Skype (para uso pessoal)
• Geração automática de links de encontro

Observações

• Os timestamps utilizam o formato UTC/ISO 8601, incluindo informações de fuso horário.
• Calendar MCP se baseia em UserprofileMCP para localizar usuários na organização.
• O email precisa ter um formato válido.
• Os arrays dos participantes (endereços, tipos, nomes) devem estar na mesma ordem
• Reuniões online exigem isOnlineMeeting=true e onlineMeetingProvider
• A recorrência requer tanto objetos de padrão quanto de intervalo
• Os fusos horários devem ser consistentes entre os horários de início e fim
• TransactionId Possibilita idempotent a criação de eventos