인증 및 설정
Microsoft 365 통합은 Azure AD 앱 등록을 통한 OAuth 2.0 인증을 사용합니다. 조직은 Azure Portal에서 Azure AD 애플리케이션을 생성하고 적절한 API 권한을 구성해야 합니다. 필요한 자격 증명에는 클라이언트 ID(애플리케이션 ID), 클라이언트 시크릿(애플리케이션 시크릿) 및 테넌트 ID(디렉터리 ID)가 포함됩니다. 이를 통해 조직 보안 정책을 준수하면서 사용자 리소스에 대한 안전한 위임 접근이 보장됩니다.필요한 권한
- Mail.ReadWrite: 사용자 사서함에서 이메일을 읽고, 작성하고, 보내고, 삭제하는 완전한 접근 권한.
- Mail.Send: 전체 사서함 접근 없이 사용자를 대신하여 이메일을 보냅니다.
- Calendars.ReadWrite: 캘린더 이벤트 및 회의를 생성, 읽기, 업데이트 및 삭제합니다.
- Files.ReadWrite.All: OneDrive 및 SharePoint 파일 및 폴더에 대한 완전한 접근 권한.
- User.Read: 기본 사용자 프로필 정보를 읽습니다.
- Contacts.ReadWrite: 사용자 연락처 및 연락처 목록을 관리합니다.
사용 가능한 작업
모든 필요한 권한이 구성되면 툴킷은 다음 작업을 활성화합니다.이메일 작업
- 이메일 검색: 키워드, 발신자, 날짜 범위 및 폴더 필터를 사용하여 사서함을 조회합니다. 고급 검색 연산자를 지원합니다.
- 이메일 보내기: 첨부 파일, CC/BCC 수신자 및 HTML 서식으로 이메일을 작성하고 보냅니다.
- 이메일 답글: 대화 컨텍스트를 유지하면서 기존 이메일 스레드에 답글 또는 전체 답글을 보냅니다.
- 이메일 전달: 선택적 코멘트와 함께 메시지를 다른 수신자에게 전달합니다.
- 이메일 콘텐츠 가져오기: 전체 이메일 본문, 헤더 및 첨부 파일 메타데이터를 검색합니다.
- 이메일 이동: 폴더 간에 이메일을 이동하여 정리합니다(받은편지함, 보관함, 사용자 정의 폴더).
- 초안 생성: 나중에 검토하고 보내기 위해 이메일을 초안으로 저장합니다.
- 첨부 파일 다운로드: 이메일 첨부 파일을 에이전트 워크스페이스에 추출하여 저장합니다.
- 읽음/읽지 않음으로 표시: 이메일 상태 플래그를 업데이트합니다.
- 이메일 삭제: 이메일을 삭제된 항목으로 이동하거나 영구적으로 삭제합니다.
캘린더 작업
- 이벤트 목록 가져오기: 날짜 범위, 참석자 또는 키워드별로 캘린더 이벤트를 조회합니다.
- 이벤트 생성: 제목, 날짜/시간, 장소, 참석자 및 본문으로 회의를 예약합니다.
- 이벤트 업데이트: 일정 변경을 포함한 기존 캘린더 이벤트를 수정합니다.
- 이벤트 취소: 회의를 삭제하고 참석자에게 취소 통지를 보냅니다.
- 빈 시간 확인: 회의 예약을 위해 여러 캘린더에서 가용성을 확인합니다.
- 참석자 상태 가져오기: RSVP 응답을 봅니다(수락, 잠정, 거절).
- 참석자 추가: 기존 회의에 추가 참가자를 초대합니다.
- 알림 설정: 이벤트에 대한 알림을 구성합니다.
OneDrive 및 SharePoint 작업
- 파일 목록: OneDrive 또는 SharePoint 문서 라이브러리에서 파일과 폴더를 탐색합니다.
- 파일 업로드: 에이전트 워크스페이스에서 클라우드 스토리지로 문서를 업로드합니다.
- 파일 다운로드: 처리 또는 분석을 위해 파일을 검색합니다.
- 파일 검색: OneDrive/SharePoint에서 이름, 콘텐츠 또는 메타데이터별로 파일을 찾습니다.
- 폴더 생성: 새 폴더 구조로 파일을 정리합니다.
- 파일 공유: 보기/편집 권한과 만료 날짜가 포함된 공유 링크를 생성합니다.
- 파일 이동: 폴더 또는 사이트 간에 파일을 재배치합니다.
- 파일 삭제: 스토리지에서 파일과 폴더를 제거합니다.
- 파일 메타데이터 가져오기: 생성 날짜, 수정 날짜, 크기 및 작성자 정보를 검색합니다.
연락처 작업
- 연락처 목록 가져오기: 사용자 연락처 및 연락처 목록을 탐색합니다.
- 연락처 생성: 이름, 이메일, 전화 및 기타 세부 정보로 새 연락처를 추가합니다.
- 연락처 업데이트: 기존 연락처 정보를 수정합니다.
- 연락처 삭제: 연락처 목록에서 연락처를 제거합니다.
- 연락처 검색: 이름, 이메일 또는 기타 필드로 연락처를 찾습니다.
구성 옵션
- 기본 사서함: 접근할 사서함을 지정합니다(사용자의 기본 또는 공유 사서함).
- 폴더 범위: 특정 폴더로 접근을 제한합니다(예: 받은편지함과 보낸 편지만).
- 캘린더 범위: 접근할 캘린더를 선택합니다(기본, 공유 또는 리소스 캘린더).
- 파일 위치: 파일 작업을 위한 기본 OneDrive 폴더 또는 SharePoint 사이트를 설정합니다.
- 첨부 파일 처리: 첨부 파일에 대한 자동 바이러스 검사 및 크기 제한을 구성합니다.
- 시간대: 올바른 예약을 위해 캘린더 작업의 시간대를 설정합니다.
사용 사례
- 자동화된 회의 예약: 에이전트가 이메일 요청을 읽고, 캘린더 가용성을 확인하며, 시간을 제안하고, 회의를 자동으로 예약합니다.
- 이메일 분류: 콘텐츠, 긴급성 및 발신자를 기반으로 수신 이메일을 자동으로 분류하고 라우팅합니다.
- 보고서 배포: 다른 툴킷을 사용하여 보고서를 생성하고, OneDrive에 업로드하며, 이해관계자에게 링크를 이메일로 보냅니다.
- 회의 준비: 이메일에서 안건 항목을 추출하고, SharePoint에서 관련 문서를 찾으며, 회의 자료를 준비합니다.
- 후속 자동화: 회의의 후속 조치 항목을 추적하고 참가자에게 알림 이메일을 보냅니다.
- 문서 협업: 초안을 SharePoint에 업로드하고, 팀과 공유하며, 이메일을 통해 피드백을 수집합니다.
- 캘린더 관리: 가용성을 확인하고 최적의 시간대를 찾아 다자간 회의를 조율합니다.
모범 사례
- 서비스 계정 사용: 공유 시나리오에는 개인 계정 대신 전용 서비스 계정을 사용합니다.
- 속도 제한 구현: Microsoft Graph API에는 스로틀링 제한이 있습니다. 재시도를 위해 지수 백오프를 구현합니다.
- 일괄 작업: 더 나은 성능을 위해 단일 API 호출에서 여러 작업을 수행하기 위해 일괄 요청을 사용합니다.
- 할당량 모니터링: Microsoft의 일일 제한에 도달하지 않도록 API 사용량을 추적합니다.
- 보안 스캔: 처리 전에 항상 첨부 파일 및 업로드된 파일에 대한 악성FTWARE 스캔을 수행합니다.
일반적인 문제 및 해결 방법
- 인증 실패: Azure AD 앱 권한에 관리자 동의가 부여되었는지 확인합니다. 토큰 만료를 확인합니다.
- 권한 부족: Azure Portal에서 모든 필요한 API 권한이 부여되었는지 확인합니다.
- 캘린더 충돌: 이중 예약을 방지하기 위해 이벤트 생성 전에 빈 시간 확인 도구를 사용합니다.
- 첨부 파일 크기 제한: 대용량 파일은 먼저 OneDrive에 업로드한 후 이메일에 링크해야 합니다.