Referencia de calendario (vista previa)

Nota:

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Importante

Esta es una función de vista previa.

  • Microsoft publica características en versión preliminar antes de su lanzamiento oficial para que los clientes puedan obtener acceso anticipado y enviar comentarios.
  • Las características en versión preliminar tienen funcionalidad restringida y no están pensadas para su uso en producción.
  • Microsoft podría cambiar los nombres y parámetros de la herramienta MCP en versión preliminar. Evite las dependencias codificadas de forma rígida. Microsoft mantiene la compatibilidad con escenarios.
  • Las características en versión preliminar se rigen por los términos de uso adicionales de Microsoft.

Overview

Id. de servidor Dirección URL a nivel de arrendatario Nombre para mostrar Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 Calendario Herramientas para operaciones de calendario como crear, actualizar, recuperar eventos, gestionar invitaciones y comprobar la disponibilidad.

Herramientas disponibles

mcp_CalendarTools_graph_acceptEvent

Acepte la invitación de eventos especificada en el calendario de un usuario.

Parámetros requeridos:

  • eventId: el identificador del evento que se va a aceptar.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • comentario: texto opcional incluido en la respuesta
  • sendResponse: indica si se va a enviar respuesta al organizador

mcp_CalendarTools_graph_cancelEvent

Cancele un evento en el calendario de un usuario especificado y notifique a los asistentes.

Parámetros requeridos:

  • eventId: identificador único del evento que se va a cancelar.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • comentario: mensaje de cancelación opcional

mcp_CalendarTools_graph_createEvent

Cree un nuevo evento de calendario en el calendario de un usuario especificado. Admite eventos periódicos y reuniones en línea.

Parámetros requeridos:

  • asunto: asunto del evento o título (no vacío)
  • start: marca de tiempo de inicio con dateTime y timeZone
  • end: marca de tiempo final con dateTime y timeZone
  • attendees_addresses: matriz de direcciones de correo electrónico de asistentes

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • body: cuerpo del evento con contentType (Texto/HTML) y contenido
  • location: Ubicación con displayName
  • attendees_types: roles de asistente (obligatorio, opcional, recurso)
  • attendees_names: nombres de muestra para los asistentes
  • recurrencia: patrón y rango de recurrencia
  • isOnlineMeeting: se establece en true para la reunión en línea
  • ProveedorReuniónOnline: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: permitir propuestas de tiempo (valor predeterminado: true)
  • transactionId: Idempotence identificador

mcp_HerramientasCalendario_gráfico_rechazarEvento

Rechace la invitación de eventos especificada en el calendario de un usuario.

Parámetros requeridos:

  • eventId: identificador del evento que se va a rechazar

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName

  • comentario: texto opcional en respuesta

  • sendResponse: indica si se va a enviar la respuesta

mcp_CalendarTools_graph_deleteEvent

Elimine un evento del calendario de un usuario especificado.

Parámetros requeridos:

  • eventId: identificador único del evento que se va a eliminar.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugerir horas y ubicaciones de reunión en función de la disponibilidad del organizador y del asistente.

Parámetros requeridos:

  • meetingDuration: duración de la reunión (por ejemplo, "PT1H")

Parámetros opcionales:

  • userId: id. de organizador o userPrincipalName
  • attendees_addresses: direcciones de correo electrónico de asistentes
  • attendees_types: tipos de asistentes
  • attendees_names: nombres de muestra para los asistentes
  • timeConstraint: disponibilidad horaria con timeslots y activityDomain
  • locationConstraint: Opciones de ubicación
  • maxCandidates: Sugerencias máximas
  • isOrganizerOptional: marca de organizador opcional
  • returnSuggestionReasons: incluir razones
  • minimumAttendeePercentage: umbral mínimo de asistencia

mcp_CalendarTools_graph_getEvent

Obtiene un único evento de calendario del calendario de un usuario especificado.

Parámetros requeridos:

  • eventId: identificador único del evento

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • select: parámetro de consulta de OData \$select
  • expand: OData para propiedades de navegación \$expand

mcp_CalendarTools_graph_getSchedule

Obtenga la agenda de disponibilidad de un usuario, lista de distribución o recurso.

Parámetros requeridos:

  • listas: direcciones SMTP de usuarios o recursos
  • startTime: hora de inicio con dateTime y timeZone
  • endTime: hora de finalización con dateTime y timeZone

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • availabilityViewInterval: duración del espacio de tiempo en minutos

mcp_CalendarTools_grafico_listaVistaCalendario

Recupere las apariciones del calendario dentro de un intervalo de tiempo especificado para un usuario.

Parámetros requeridos:

  • startDateTime: inicio del intervalo de tiempo (ISO 8601)
  • endDateTime: fin del intervalo de tiempo (ISO 8601)

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • top: número máximo de eventos
  • orderby: cláusula de ordenamiento

mcp_HerramientasCalendario_grafico_listarEventos

Recupere una lista de eventos del calendario de un usuario especificado.

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • startDateTime: inicio del intervalo de tiempo (ISO 8601)
  • endDateTime: fin del intervalo de tiempo (ISO 8601)
  • top: número máximo de eventos
  • filter: consulta de filtro de OData
  • orderby: ordenar por consulta de OData

mcp_HerramientasDelCalendario_grafico_actualizarEvento

Actualice un evento de calendario existente en el calendario de un usuario especificado.

Parámetros requeridos:

  • eventId: identificador único del evento

Parámetros opcionales:

  • userId: id. de usuario o userPrincipalName
  • asunto: asunto actualizado
  • body: contenido del cuerpo actualizado
  • start: hora de inicio actualizada
  • end: hora de finalización actualizada
  • ubicación: ubicación actualizada
  • attendees_addresses: mensajes de correo electrónico de asistentes actualizados
  • attendees_types: tipos de asistentes actualizados
  • attendees_names: nombres de asistentes actualizados
  • isCancelled: se establece en true para cancelar
  • recurrencia: patrón de recurrencia actualizado

Características principales

Administración de eventos

  • Crear, leer, actualizar y eliminar eventos.
  • Acepta, rechaza y cancela invitaciones.
  • Soporte para eventos recurrentes.
  • Integración con reuniones online (Teams, Skype).

Disponibilidad y programación

  • Consigue horarios libres o ocupados.
  • Busca horarios de las reuniones con comprobación de disponibilidad.
  • Vista de calendario con filtrado por rango de tiempo.
  • Análisis de disponibilidad de asistentes.

Administración de asistentes

  • Gestiona los asistentes necesarios, opcionales y los recursos.
  • Compatibilidad con propuestas de horario.
  • Haz un seguimiento de las respuestas.
  • Compatibilidad con listas de distribución.

Patrones de periodicidad

  • Patrones diarios, semanales, mensuales y anuales.
  • Recurrencia absoluta y relativa.
  • Fecha de finalización o recuento de ocurrencias.
  • Especificaciones del día de la semana y del mes.

Reuniones de Internet

  • Integración con Teams para empresas
  • Compatibilidad con Skype Empresarial
  • Compatibilidad con Skype (para uso personal)
  • Generación automática de vínculos de reunión

Notas

  • Todas las marcas de tiempo utilizan el formato UTC/ISO 8601 con zona horaria
  • Calendar MCP se basa en UserprofileMCP para encontrar usuarios en la organización.
  • Las direcciones de correo electrónico deben estar en formato válido
  • Las matrices de asistentes (direcciones, tipos, nombres) deben estar en el mismo orden
  • Las reuniones online requieren isOnlineMeeting=true y onlineMeetingProvider
  • La periodicidad requiere objetos de patrón y rango
  • Las zonas horarias deben ser coherentes en las horas de inicio y finalización
  • TransactionId Permite idempotent la creación de eventos
  • Last updated on