달력 참조 (미리보기)

메모

이 글의 특징들은 표준 하네스로 구동되며, 표준 하네스로 구동되는 에이전트에 대한 라이선스 청구 옵션을 사용합니다. Access 표준 에이전트와 에이전트 플로우에서 표준 기능에 접근하는 방법을 배워보세요.

Important

미리 보기 기능입니다.

  • Microsoft 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 미리 보기 기능을 릴리스합니다.
  • 미리 보기 기능은 기능이 제한되어 있으며 프로덕션용으로 사용되지 않습니다.
  • Microsoft 미리 보기 MCP 도구 이름 및 매개 변수를 변경할 수 있습니다. 하드 코딩된 종속성을 방지합니다. Microsoft 시나리오 지원을 유지 관리합니다.
  • 미리 보기 기능은 Microsoft 추가 사용 약관 적용됩니다.

Overview

서버 ID 테넌트 수준의 URL 표시 이름 Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools		 Calendar 캘린더 생성, 업데이트, 이벤트 검색, 초대 관리, 가용성 확인 등 달력 운영을 위한 도구들.

사용 가능한 도구

mcp_CalendarTools_graph_acceptEvent (특정 이벤트를 수락하는 함수)

사용자의 일정에서 지정된 이벤트 초대를 수락합니다.

필수 매개 변수:

  • eventId: 수락할 이벤트의 ID입니다.

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • 주석: 응답에 포함된 선택적 텍스트
  • sendResponse: 이끌이에게 응답을 보낼지 여부

mcp_CalendarTools_graph_cancelEvent

지정된 사용자의 일정에서 이벤트를 취소하고 참석자에게 알립니다.

필수 매개 변수:

  • eventId: 취소할 이벤트의 고유 식별자입니다.

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • 주석: 선택적 취소 메시지

mcp_캘린더도구_그래프_이벤트생성

지정된 사용자의 일정에 새 일정 이벤트를 만듭니다. 되풀이 이벤트 및 온라인 모임을 지원합니다.

필수 매개 변수:

  • 주제: 이벤트 제목 또는 제목(없음)
  • start: dateTime 및 timeZone가 있는 시작 타임스탬프
  • end: dateTime 및 timeZone가 있는 종료 타임스탬프
  • attendees_addresses: 참석자 전자 메일 주소 배열

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • body: contentType(텍스트/HTML) 및 콘텐츠가 있는 이벤트 본문
  • 위치: displayName이(가) 있는 위치
  • attendees_types: 참석자 역할(필수, 선택 사항, 리소스)
  • attendees_names: 참석자 표시 이름
  • 되풀이: 되풀이 패턴 및 범위
  • isOnlineMeeting: 온라인 모임에 대해 true로 설정
  • onlineMeetingProvider: teamsForBusiness, , skypeForBusinessskypeForConsumer
  • allowNewTimeProposals: 시간 제안 허용(기본값: true)
  • transactionId: Idempotence 식별자

mcp_CalendarTools_graph_declineEvent

사용자의 일정에서 지정된 이벤트 초대를 거절합니다.

필수 매개 변수:

  • eventId: 거절할 이벤트의 ID

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName

  • 주석: 응답의 선택적 텍스트

  • sendResponse: 응답을 보낼지 여부

mcp_CalendarTools_graph_deleteEvent

지정된 사용자의 일정에서 이벤트를 삭제합니다.

필수 매개 변수:

  • eventId: 삭제할 이벤트의 고유 식별자입니다.

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

이끌이 및 참석자 가용성에 따라 모임 시간 및 위치를 제안합니다.

필수 매개 변수:

  • meetingDuration: 모임 기간(예: 'PT1H')

선택적 매개 변수:

  • userId: 주최자 ID 또는 userPrincipalName
  • attendees_addresses: 참석자 전자 메일 주소
  • attendees_types: 참석자 유형
  • attendees_names: 참석자 표시 이름
  • timeConstraint: timeslots 및 activityDomain이 있는 시간 가용성
  • locationConstraint: 위치 옵션
  • maxCandidates: 최대 제안 수
  • isOrganizerOptional: 주최자 선택 여부 플래그
  • returnSuggestionReasons: 이유 포함
  • minimumAttendeePercentage: 최소 출석 임계값

mcp_CalendarTools_graph_getEvent

지정된 사용자의 일정에서 단일 일정 이벤트를 가져옵니다.

필수 매개 변수:

  • eventId: 이벤트의 고유 식별자입니다.

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • select: OData \$select 쿼리 매개 변수
  • expand: 탐색 속성에 대한 OData \$expand확장

mcp_CalendarTools_graph_getSchedule

사용자, 배포 목록 또는 리소스에 대한 사용 가능 여부 일정을 가져옵니다.

필수 매개 변수:

  • 일정: 사용자 또는 리소스의 SMTP 주소
  • startTime: dateTime 및 timeZone와 함께 표시되는 시작 시간
  • endTime: dateTime 및 timeZone가 포함된 종료 시간

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • availabilityViewInterval: 시간 슬롯 길이(분)

mcp_CalendarTools_graph_listCalendarView

사용자의 지정된 시간 범위 내에서 일정 발생을 검색합니다.

필수 매개 변수:

  • startDateTime: 시간 범위의 시작(ISO 8601)
  • endDateTime: 시간 범위 종료(ISO 8601)

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • top: 최대 이벤트 수
  • orderby: 정렬 기준 절

mcp_CalendarTools_graph_listEvents

지정된 사용자의 일정에서 이벤트 목록을 검색합니다.

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • startDateTime: 시간 범위의 시작(ISO 8601)
  • endDateTime: 시간 범위 종료(ISO 8601)
  • top: 최대 이벤트 수
  • 필터: OData 필터 쿼리
  • orderby: 쿼리별 OData 순서

mcp_CalendarTools_graph_updateEvent

지정된 사용자의 일정에서 기존 일정 이벤트를 업데이트합니다.

필수 매개 변수:

  • eventId: 이벤트의 고유 식별자입니다.

선택적 매개 변수:

  • userId: 사용자 ID 또는 userPrincipalName
  • 주제: 업데이트된 제목
  • 본문: 업데이트된 본문 콘텐츠
  • start: 업데이트된 시작 시간
  • 끝: 업데이트된 종료 시간
  • 위치: 업데이트된 위치
  • attendees_addresses: 업데이트된 참석자 이메일
  • attendees_types: 업데이트된 참석자 유형
  • attendees_names: 업데이트된 참석자 이름
  • isCancelled: true로 설정하여 취소
  • 되풀이: 업데이트된 되풀이 패턴

주요 기능

이벤트 관리

  • 이벤트를 생성, 읽기, 업데이트, 삭제할 수 있습니다.
  • 초대를 수락하고, 거절하고, 취소하세요.
  • 반복 이벤트 지원.
  • 온라인 회의(Teams, Skype)와의 통합.

가용성 및 예약

  • 자유롭거나 비효율적인 일정을 잡으세요.
  • 만남 시간을 확인하면 가능 시간 확인이 가능합니다.
  • 시간 범위 필터링이 포함된 캘린더 뷰.
  • 참석자 가용성 분석.

참석자 관리

  • 필수, 선택 및 자원 참석자를 관리하세요.
  • 시간 제안 지원.
  • 응답을 추적하세요.
  • 배포 목록 지원.

되풀이 패턴

  • 일간, 주간, 월간, 연간 패턴.
  • 절대적이고 상대적인 재발.
  • 종료일 또는 발생 횟수.
  • 요일과 월별 사양.

온라인 모임

  • 비즈니스용 Teams와 통합
  • 비즈니스용 Skype 지원
  • Skype 지원(개인용)
  • 자동 모임 링크 생성

Notes

  • 모든 타임스탬프는 표준 시간대와 함께 UTC/ISO 8601 형식을 사용합니다.
  • 일정 MCP는 조직의 사용자를 찾기 위해 UserprofileMCP를 사용합니다.
  • 전자 메일 주소는 유효한 형식이어야 합니다.
  • 참석자 배열(주소, 형식, 이름)은 순서가 같아야 합니다.
  • 온라인 회의에는 isOnlineMeeting=true 및 onlineMeetingProvider이 필요합니다
  • 되풀이하려면 패턴 및 범위 개체가 모두 필요합니다.
  • 표준 시간대는 시작 및 종료 시간에 걸쳐 일관되어야 합니다.
  • TransactionId이벤트를 만들 수 있습니다.idempotent
  • Last updated on