> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft 365

> Azure AD를 통한 이메일, 캘린더, OneDrive 및 SharePoint 통합

## 인증 및 설정

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에서 이름, 콘텐츠 또는 메타데이터별로 파일을 찾습니다.
* **폴더 생성**: 새 폴더 구조로 파일을 정리합니다.
* **파일 공유**: 보기/편집 권한과 만료 날짜가 포함된 공유 링크를 생성합니다.
* **파일 이동**: 폴더 또는 사이트 간에 파일을 재배치합니다.
* **파일 삭제**: 스토리지에서 파일과 폴더를 제거합니다.
* **파일 메타데이터 가져오기**: 생성 날짜, 수정 날짜, 크기 및 작성자 정보를 검색합니다.

### 연락처 작업

* **연락처 목록 가져오기**: 사용자 연락처 및 연락처 목록을 탐색합니다.
* **연락처 생성**: 이름, 이메일, 전화 및 기타 세부 정보로 새 연락처를 추가합니다.
* **연락처 업데이트**: 기존 연락처 정보를 수정합니다.
* **연락처 삭제**: 연락처 목록에서 연락처를 제거합니다.
* **연락처 검색**: 이름, 이메일 또는 기타 필드로 연락처를 찾습니다.

## 구성 옵션

<img src="https://mintcdn.com/automationanywhere/KYLkRhJ6hNNnwL4a/img/agents-toolkits/23.jpg?fit=max&auto=format&n=KYLkRhJ6hNNnwL4a&q=85&s=738ca3b2d5a2457efac3d175abae8829" alt="인증 및 도구 선택이 포함된 Microsoft 365 툴킷 구성" width="1280" height="629" data-path="img/agents-toolkits/23.jpg" />

* **기본 사서함**: 접근할 사서함을 지정합니다(사용자의 기본 또는 공유 사서함).
* **폴더 범위**: 특정 폴더로 접근을 제한합니다(예: 받은편지함과 보낸 편지만).
* **캘린더 범위**: 접근할 캘린더를 선택합니다(기본, 공유 또는 리소스 캘린더).
* **파일 위치**: 파일 작업을 위한 기본 OneDrive 폴더 또는 SharePoint 사이트를 설정합니다.
* **첨부 파일 처리**: 첨부 파일에 대한 자동 바이러스 검사 및 크기 제한을 구성합니다.
* **시간대**: 올바른 예약을 위해 캘린더 작업의 시간대를 설정합니다.

## 사용 사례

* **자동화된 회의 예약**: 에이전트가 이메일 요청을 읽고, 캘린더 가용성을 확인하며, 시간을 제안하고, 회의를 자동으로 예약합니다.
* **이메일 분류**: 콘텐츠, 긴급성 및 발신자를 기반으로 수신 이메일을 자동으로 분류하고 라우팅합니다.
* **보고서 배포**: 다른 툴킷을 사용하여 보고서를 생성하고, OneDrive에 업로드하며, 이해관계자에게 링크를 이메일로 보냅니다.
* **회의 준비**: 이메일에서 안건 항목을 추출하고, SharePoint에서 관련 문서를 찾으며, 회의 자료를 준비합니다.
* **후속 자동화**: 회의의 후속 조치 항목을 추적하고 참가자에게 알림 이메일을 보냅니다.
* **문서 협업**: 초안을 SharePoint에 업로드하고, 팀과 공유하며, 이메일을 통해 피드백을 수집합니다.
* **캘린더 관리**: 가용성을 확인하고 최적의 시간대를 찾아 다자간 회의를 조율합니다.

## 모범 사례

* **서비스 계정 사용**: 공유 시나리오에는 개인 계정 대신 전용 서비스 계정을 사용합니다.
* **속도 제한 구현**: Microsoft Graph API에는 스로틀링 제한이 있습니다. 재시도를 위해 지수 백오프를 구현합니다.
* **일괄 작업**: 더 나은 성능을 위해 단일 API 호출에서 여러 작업을 수행하기 위해 일괄 요청을 사용합니다.
* **할당량 모니터링**: Microsoft의 일일 제한에 도달하지 않도록 API 사용량을 추적합니다.
* **보안 스캔**: 처리 전에 항상 첨부 파일 및 업로드된 파일에 대한 악성FTWARE 스캔을 수행합니다.

## 일반적인 문제 및 해결 방법

* **인증 실패**: Azure AD 앱 권한에 관리자 동의가 부여되었는지 확인합니다. 토큰 만료를 확인합니다.
* **권한 부족**: Azure Portal에서 모든 필요한 API 권한이 부여되었는지 확인합니다.
* **캘린더 충돌**: 이중 예약을 방지하기 위해 이벤트 생성 전에 빈 시간 확인 도구를 사용합니다.
* **첨부 파일 크기 제한**: 대용량 파일은 먼저 OneDrive에 업로드한 후 이메일에 링크해야 합니다.
