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이 필요한 PDF)에 대한 효과가 제한됩니다. 이 모드의 실시간 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 데이터 스토어 설정을 참고하세요.