Referencia del calendario (vista previa)

Note

Las características de este artículo son impulsadas por el arnés estándar, que utiliza las opciones de facturación descritas en Licencias para agentes alimentados por el arnés estándar. Aprende cómo acceder a las funciones estándar en Access agentes estándar y flujos de agentes.

Important

Se trata de una característica en versión preliminar.

• 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 clave

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 de recursos.
• Apoyo a las propuestas de tiempo.
• 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 de día de semana y 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