Gemini Enterprise용 Microsoft SharePoint 데이터 스토어를 사용하면 문서, 목록, 사이트를 비롯한 Microsoft SharePoint Online 데이터를 검색하고 작업을 수행할 수 있습니다.
지원되는 Microsoft SharePoint 버전
Microsoft SharePoint 데이터 스토어는 Microsoft SharePoint Online의 최신 클라우드 버전을 지원합니다.
지원되는 작업
Microsoft SharePoint 데이터 스토어가 사용 설정되면 최종 사용자는 Gemini Enterprise에서 자연어 명령어를 사용하여 다음 작업을 수행할 수 있습니다.
| 작업 | 설명 |
|---|---|
| 폴더 만들기 | 지정된 경로에 새 폴더를 만듭니다. |
| 목록 추가 | Microsoft SharePoint 사이트에 새 정형 데이터 목록 (예: 작업, 연락처)을 만듭니다. |
| 문서 업로드 | Microsoft SharePoint 사이트 또는 라이브러리에 문서를 업로드합니다. |
| 문서 다운로드 | Microsoft SharePoint 사이트 또는 라이브러리에서 문서를 다운로드합니다. |
| 페이지 추가 | Microsoft SharePoint 사이트에 새 페이지를 만듭니다. |
| 문서 체크아웃 | Microsoft SharePoint 라이브러리에서 문서를 체크아웃합니다. |
| 문서 체크인 | Microsoft SharePoint 라이브러리에 문서를 체크인합니다. |
| 첨부파일 또는 문서 이름 바꾸기 | Microsoft SharePoint 라이브러리에서 첨부파일 또는 문서의 이름을 바꿉니다. |
| 첨부파일 또는 문서 이동 | Microsoft SharePoint 라이브러리에서 대상 라이브러리, 폴더 또는 다른 SharePoint 사이트로 문서를 이동합니다. |
| 체크아웃 문서 삭제 | 문서의 체크아웃을 취소하고 변경사항을 저장하지 않고 되돌립니다. |
| 리소스 공유 | 지정된 수신자와 문서, 폴더 또는 리소스를 공유하거나 공유 링크를 생성합니다. |
| 파일 속성 업데이트 | Microsoft SharePoint 라이브러리에 있는 문서의 메타데이터 속성을 업데이트합니다. |
| 페이지 업데이트 | Microsoft SharePoint 사이트의 기존 페이지를 업데이트합니다. |
| 목록 업데이트 | Microsoft SharePoint 사이트에서 기존 구조화된 데이터 목록의 설정을 업데이트합니다. |
| 목록 항목 만들기 | Microsoft SharePoint 사이트의 지정된 목록에 새 항목을 만듭니다. |
| 목록 항목 업데이트 | 지정된 목록에 있는 기존 항목의 필드를 업데이트합니다. |
| 목록 나열 | 지정된 Microsoft SharePoint 사이트의 모든 목록과 문서 라이브러리를 가져옵니다. |
| 목록 항목 가져오기 | 모든 열 값을 포함하는 단일 목록 항목을 반환합니다. |
| 목록 필드 가져오기 | 모든 필드와 속성을 포함하여 지정된 목록의 스키마를 반환합니다. |
필수 권한
Gemini Enterprise가 Microsoft SharePoint 데이터 스토어를 사용하여 검색 및 데이터 수집을 수행하도록 하려면 다음 권한이 필요합니다.
Microsoft Graph API 권한
아래 표에는 각 연결 모드에 필요한 권한이 나와 있습니다.
참고: 다음 표에는 각 연결 모드에 필요한 권한이 요약되어 있습니다. 제휴 검색 또는 데이터 수집 연결 모드에 대해 작업을 사용 설정하는 경우 작업 행에 나열된 권한도 선택합니다.
| 연결 모드 | 범위 | 목적 |
|---|---|---|
| 제휴 검색 | 해당 사항 없음 | Graph API 권한은 필요하지 않습니다. |
| 데이터 수집 | GroupMember.Read.All |
(제휴 사용자 인증 정보 및 OAuth 2.0 갱신 토큰) 데이터 스토어가 로그인한 사용자 없이 모든 그룹의 멤버십과 기본 그룹 속성을 읽을 수 있도록 허용합니다. |
User.Read |
(제휴 사용자 인증 정보 및 OAuth 2.0 갱신 토큰) 데이터 스토어에서 로그인한 사용자의 프로필을 읽을 수 있습니다. 또한 데이터 스토어에서 로그인한 사용자의 기본 회사 정보를 읽을 수 있습니다. | |
User.Read.All |
(OAuth 2.0 갱신 토큰만 해당) 데이터 스토어에서 사용자 프로필을 읽을 수 있도록 허용합니다. | |
Sites.FullControl.All (옵션 1)Sites.Selected (옵션 2) |
(제휴 사용자 인증 정보 및 OAuth 2.0 갱신 토큰) 옵션 1을 사용하면 데이터 스토어가 모든 사이트 모음을 완전히 제어할 수 있습니다. 옵션 2를 사용하면 데이터 스토어가 사이트 모음의 하위 집합에 액세스할 수 있습니다. 특정 사이트 모음과 부여된 권한은 SharePoint Online에서 구성할 수 있습니다. | |
User.Read.All (옵션 1)User.ReadBasic.All (옵션 2) |
(제휴 사용자 인증 정보만 해당) 옵션 1을 사용하면 데이터 스토어에서 사용자 프로필을 읽을 수 있습니다. 옵션 2를 사용하면 데이터 스토어에서 조직 내 다른 사용자의 기본 프로필 속성 집합을 읽을 수 있습니다. | |
| 작업 | Sites.ReadWrite.All |
(제휴 검색 및 데이터 수집) 데이터 스토어가 로그인한 사용자를 대신하여 모든 사이트 컬렉션의 문서 및 목록 항목을 수정하거나 삭제할 수 있습니다. |
Sites.Read.All |
(제휴 검색 및 데이터 수집) 데이터 스토어가 로그인한 사용자를 대신하여 모든 사이트 모음의 목록, 목록 항목, 목록 스키마를 읽을 수 있습니다. 목록 나열, 목록 항목 가져오기, 목록 필드 가져오기 작업에 필요합니다. | |
Files.ReadWrite |
데이터 스토어에서 로그인한 사용자의 파일을 읽고, 만들고, 업데이트하고, 삭제할 수 있습니다. | |
Files.ReadWrite.All |
데이터 스토어에서 로그인한 사용자가 액세스할 수 있는 모든 파일을 읽고, 만들고, 업데이트하고, 삭제하고, 업로드하고, 다운로드할 수 있습니다. | |
Sites.Manage.All |
데이터 스토어가 사용자를 대신하여 모든 사이트 모음에서 문서 라이브러리 및 목록을 만들거나 삭제할 수 있습니다. |
Microsoft SharePoint API 권한
아래 표에는 각 연결 모드에 필요한 권한이 나와 있습니다.
| 연결 모드 | 범위 | 목적 |
|---|---|---|
| 제휴 검색 | Sites.Search.All (위임됨) |
데이터 스토어가 현재 로그인한 사용자를 대신하여 검색어를 실행하고 기본 사이트 정보를 읽을 수 있도록 허용합니다. 검색 결과는 앱의 권한이 아닌 사용자의 권한을 기반으로 합니다. |
AllSites.Read (옵션 1, 위임됨) |
데이터 스토어가 로그인한 사용자를 대신하여 모든 사이트 모음의 문서 및 목록 항목을 읽을 수 있도록 허용합니다. | |
Sites.Selected (옵션 2, 위임됨) |
데이터 스토어가 로그인한 사용자와 함께 사이트 모음의 하위 집합에 액세스할 수 있도록 허용합니다. 특정 사이트 모음과 부여된 권한은 SharePoint Online에서 구성할 수 있습니다. | |
| 데이터 수집 (제휴 사용자 인증 정보) | Sites.FullControl.All (옵션 1, 애플리케이션) |
데이터 스토어가 모든 사이트 모음을 완전히 제어할 수 있습니다. |
Sites.Selected (옵션 2, 신청) |
데이터 스토어가 로그인한 사용자와 함께 사이트 모음의 하위 집합에 액세스할 수 있도록 허용합니다. 특정 사이트 모음과 부여된 권한은 SharePoint Online에서 구성할 수 있습니다. | |
| 데이터 수집 (OAuth 2.0 갱신 토큰) | AllSites.FullControl (옵션 1, 위임됨) |
데이터 스토어가 로그인한 사용자를 대신하여 모든 사이트 모음을 완전히 제어할 수 있습니다. |
Sites.Selected (옵션 2, 위임됨) |
데이터 스토어가 로그인한 사용자와 함께 사이트 모음의 하위 집합에 액세스할 수 있도록 허용합니다. 특정 사이트 모음과 부여된 권한은 SharePoint Online에서 구성할 수 있습니다. | |
| 작업 | AllSites.Write (위임됨) |
데이터 스토어가 로그인한 사용자를 대신하여 모든 사이트 컬렉션에서 문서를 생성, 읽기, 업데이트, 삭제, 업로드, 다운로드하고 항목을 나열할 수 있습니다. |
Microsoft SharePoint 권한을 추가하는 방법은 Microsoft SharePoint 구성 및 필요한 권한 설정을 참고하세요.
제한사항
이 섹션에서는 Microsoft SharePoint 데이터 스토어 사용에 영향을 줄 수 있는 알려진 문제와 제한사항을 간략하게 설명합니다.
- 새 앱을 만들거나 기존 앱에 데이터 스토어를 추가할 때는 단일 커넥터 유형에 속하는 작업에 하나의 데이터 스토어만 연결하는 것이 좋습니다.
- 기존 Microsoft SharePoint 데이터 스토어에 VPC 서비스 제어 경계를 적용하는 것은 지원되지 않습니다. VPC 서비스 제어를 적용하려면 데이터 스토어를 삭제하고 다시 만들어야 합니다. VPC 서비스 제어 및 VPC 서비스 제어를 사용 설정한 후 작업을 사용하는 방법에 대한 자세한 내용은 VPC 서비스 제어로 앱 보호를 참조하세요.
- Microsoft SharePoint 데이터 스토어는
global,us및eu위치에서만 지원됩니다.
- 검색 품질 기본 요건: 최적의 검색 결과를 얻고 지식 그래프 기능을 최대한 활용하려면 Microsoft SharePoint 데이터 스토어 외에도 사용자 검색 데이터 스토어를 구성하고 동기화하는 것이 좋습니다.
Microsoft SharePoint 제휴 데이터 스토어에는 다음과 같은 제한사항이 있습니다.
- 검색 제한사항: 검색 결과는 다를 수 있으며 모든 파일 형식에 대해 항상 포괄적이지는 않습니다. 보관처리되거나 암호화된 폴더의 콘텐츠는 검색에 액세스하지 못할 수 있습니다. 제휴 검색은 첨부파일 내 검색을 지원하지 않습니다.
- 위임된 액세스: 공유 사이트 또는 라이브러리에 액세스하려면 표준 사용자 승인에 포함되지 않은 특정 권한이 필요할 수 있습니다.
- 제휴 검색 모드의 레이아웃 파서: 레이아웃 파서는 표준이지만 복잡한 PDF (표, 다중 열 레이아웃 또는 OCR이 필요한 경우)에 대한 효과는 제휴 검색 모드에서 제한됩니다. 이 모드의 실시간 API 호출은 데이터 수집 중에 레이아웃 파서가 수행하는 심층 분석에 필요한 전체 데이터 또는 시간을 제공하지 않을 수 있습니다.
- 지원되지 않는 PDF 기능: 따라서 복잡한 PDF 구조는 완전히 분석되거나 검색되지 않을 수 있습니다. 여기에는 다음이 포함됩니다.
- 다중 열 텍스트 레이아웃
- 삽입된 표 및 차트 내 데이터
- 광학 문자 인식 (OCR)이 필요한 스캔 문서의 텍스트
- 비선형 읽기 순서 또는 복잡한 서식이 있는 문서
추천
복잡한 기능 (예: 표, 다중 열 레이아웃, OCR 종속 콘텐츠)이 있는 PDF가 포함된 Microsoft Sharepoint 데이터의 경우 효과적인 검색을 위해 표준 수집 모드를 사용하는 것이 좋습니다. 이 모드를 사용하면 레이아웃 파서가 전체 문서 콘텐츠를 심층적으로 처리하고 색인을 생성할 수 있습니다.
SharePoint 커넥터 검색 결과 문제 해결하기
문서 누락, 잘못된 결과 또는 검색 관련성 저하 문제가 발생하는 경우 다음 진단 영역을 확인하세요.
- 사용자 데이터 스토어 확인: 관련성 또는 항목 일치 문제가 발생하는 경우 사용자 검색 데이터 스토어가 설정되어 있고 동기화되고 있는지 확인합니다.
- 인증 오류: 'Graph API 액세스 토큰을 가져오는 중에 오류가 발생했습니다'와 같은 지속적인 인증 오류가 발생하면 검색이 작동하지 않습니다. 이 문제를 해결하려면 Microsoft Entra ID 로그에서 세부정보를 확인한 후 연결을 다시 인증하세요.
- ID 불일치: Google 아이덴티티를 사용하는 경우 사용자의 Google 이메일이 Microsoft SharePoint 이메일과 정확히 일치하는지 확인합니다. 일치하지 않으면 결과가 반환되지 않습니다.
- 타겟팅된 폴더 검색 (.aspx URL):
/Forms/AllItems.aspx로 끝나는 풀 브라우저 URL로 검색하면 특정 폴더뿐만 아니라 전체 사이트에서 검색이 실행됩니다. 타겟팅된 검색에는 항상 절대 폴더 경로를 사용하세요. - 결과 제한: 통합 검색은 쿼리당 반환되는 문서 수에 제한이 있을 수 있습니다 (일반적으로 약 20개 결과로 제한).
- 인용 문제: 간헐적으로 잘못된 인용이 발생할 수 있습니다. 문제가 지속되면 지원팀에 문제를 신고하고 진단 토큰을 포함하세요.
- 커넥터-모델 호환성: 최신 Gemini 모델 버전을 사용하고 있는지 확인합니다. 일부 이전 모델 (예: 3.x)에는 Agent Builder 내의
download_document과 같은 SharePoint 작업의 도구를 확인하는 데 알려진 문제가 있습니다.
다음 단계
- Microsoft SharePoint로 데이터 스토어를 만들고 구성하려면 Microsoft SharePoint 데이터 스토어 설정을 참고하세요.