Comparteix a través de


Referencia del calendario de WORK IQ (versión preliminar)

Importante

  • Esta es una función de vista previa.
  • Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a términos de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan obtener acceso temprano y brindar comentarios.

Información general

Id. de servidor Nombre para mostrar Descripción
mcp_CalendarTools Calendario de Trabajo IQ Servidor MCP para herramientas de calendario. Use este servidor MCP para operaciones de calendario, como crear, actualizar, recuperar eventos, administrar 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 id. del evento que se aceptará.

Parámetros opcionales:

  • userId: ID de usuario o nombrePrincipalDeUsuario
  • comentario: texto opcional incluido en la respuesta
  • sendResponse: indica si se 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 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/título del evento (no vacío)
  • Inicio: Marca de tiempo de inicio con dateTime y timeZone
  • Conclusión: Terminar la marca temporal 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
  • Ubicación: Ubicación con displayName
  • attendees_types: roles de los asistentes (obligatorio, opcional, recurso)
  • attendees_names: nombres de muestra de asistentes
  • recurrence: patrón e intervalo de periodicidad
  • isOnlineMeeting: Configurado como true para reunión en línea
  • ProveedorDe ReunionesOnline:teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: permitir propuestas de tiempo (valor predeterminado: verdadero)
  • 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: el id. del evento que se rechazará.

Parámetros opcionales:

  • userId: ID de usuario o userPrincipalName

  • comentario: texto opcional en la respuesta

  • sendResponse: indica si se 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 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 del organizador o userPrincipalName
  • attendees_addresses: direcciones de correo electrónico de asistentes
  • attendees_types: tipos de asistentes
  • attendees_names: nombres de muestra de asistentes
  • Restricción temporal: Disponibilidad de tiempo con franjas horarias y activityDomain
  • locationConstraint: opciones de ubicación
  • maxCandidates: sugerencias máximas
  • isOrganizerOptional: indicador opcional de organizador
  • returnSuggestionReasons: Incluir las 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
  • seleccionar: Parámetro de consulta OData \$select
  • Ampliar: OData \$expand para propiedades de navegación

mcp_CalendarTools_graph_getSchedule

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

Parámetros requeridos:

  • schedules: direcciones SMTP de usuarios o recursos
  • Hora de inicio: Hora de inicio con dateTime y timeZone
  • endTime: Tiempo 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 ORDER BY

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: OData ordenar por consulta

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
  • subject: 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 verdadero para cancelar
  • recurrence: patrón de periodicidad actualizado

Características clave

Administración de eventos

  • Crear, leer, actualizar y eliminar eventos
  • Aceptar, rechazar y cancelar invitaciones
  • Compatibilidad con eventos periódicos
  • Integración con reuniones en línea (Teams, Skype)

Disponibilidad y programación

  • Obtener horarios de disponibilidad
  • Buscar horas de reunión con comprobación de disponibilidad
  • Vista de calendario con filtrado de intervalo de tiempo
  • Análisis de disponibilidad de asistentes

Administración de asistentes

  • Administrar asistentes obligatorios, opcionales y de recursos
  • Soporte para propuestas de horarios
  • Seguir respuestas
  • Compatibilidad con listas de distribución

Patrones de periodicidad

  • Patrones diario, semanal, mensual y anual
  • Periodicidad absoluta y relativa
  • Fecha de finalización o número de ocurrencias
  • Especificaciones de día de semana y mes

Reuniones de Internet

  • Integración con Teams para empresas
  • Compatibilidad con Skype for Business
  • 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