SharePoint은 지식 소스로서 SharePoint URL 또는 SharePoint 목록과 에이전트를 연결하여 작동합니다. 이 문서에서는 지식 추가 대화 상자에서 SharePoint 옵션을 선택하여 제공하는 전체 SharePoint 통합 기능에 대해 설명합니다.
참고
지식 추가 대화 상자에는 두 가지 SharePoint 옵션이 있습니다. 파일 업로드 섹션의 SharePoint 옵션은 개별 SharePoint 파일 또는 폴더를 업로드하는 데 사용되며 파일 동기화 기능을 사용하도록 설정합니다. 이 문서에서는 Copilot Studio에서 SharePoint 전폭적인 지원을 제공하는 SharePoint 옵션에 대해 설명합니다.
제한 및 지원되는 SharePoint 기능 목록은 Copilot Studio 웹앱 SharePoint 제한 참조하세요.
개별 SharePoint 파일 또는 폴더를 추가하려면 SharePoint 파일 및 폴더 추가 참조하세요.
SharePoint 기술 자료로 사용하는 에이전트 응답은 대화 기록 포함되지 않습니다.
SharePoint 지식 원본에 기반을 두는 에이전트의 경우 의미 체계 검색을 사용한 테넌트 그래프 접지를 켜면 더 나은 지식 검색 및 응답 품질을 제공합니다. 이 기능은 최첨단 내부 검색 도구를 사용하여 에이전트가 더 많은 양의 맥락을 더 정밀하게 얻을 수 있게 합니다. 하지만 시스템 복잡성이 증가함에 따라 특정 사용자와 쿼리가 약간의 지연 시간을 경험할 수 있습니다.
에이전트를 게시하면 에이전트에 구성된 인증 설정을 사용하여 에이전트와 채팅하는 사용자를 대신하여 생성형 응답을 사용하는 호출이 이루어집니다. 기본적으로 Copilot Studio 및 Microsoft Teams에서 만들어진 에이전트는 Microsoft Teams, Power Apps 및 Microsoft 365 Copilot 같은 환경에서 작동하는 Microsoft와 인증 옵션으로 구성됩니다.
참고
Microsoft Teams 채팅에서 SharePoint 데이터와 함께 생성 답변을 사용할 수 있으며 수동 인증이 필요하지 않습니다. 이전에 게시된 에이전트에 이 메서드를 사용하려면 Microsoft에서 인증을 사용하도록 에이전트를 다시 구성한 다음 Microsoft Teams 다시 게시합니다. 이 변경 사항이 적용되기까지는 몇 시간이 걸릴 수 있습니다. 사용자가 대화 중이고 변경 사항이 적용되지 않은 것 같으면 채팅에 "다시 시작"을 입력하여 최신 버전의 에이전트로 대화를 강제로 다시 시작할 수 있습니다. 이러한 변경 내용은 이제 사용자와 에이전트 간의 Teams 1:1 채팅에 사용할 수 있습니다. 아직 그룹 채팅이나 채널 메시지에는 사용할 수 없습니다.
에이전트에 수동 인증을 사용하려면 고급 인증 시나리오를 참조하세요.
SharePoint 사이트를 지식 원본으로 추가
사용자가 질문하고 에이전트에 답변에 사용할 주제가 없는 경우 에이전트는 URL과 모든 하위 경로를 검색합니다. 예를 들어, contoso.sharepoint.com/sites와 같은 URL에는 contoso.sharepoint.com/sites/policies와 같은 하위 경로도 포함됩니다. 생성형 답변은 이 콘텐츠를 대상 응답으로 요약합니다.
SharePoint 사이트를 지식 원본으로 추가하려면 다음 단계를 수행합니다.
에이전트를 엽니다.
개요 또는 참조 자료 페이지에서 참조 자료 추가를 선택하거나, 생성형 답변 노드의 속성을 선택합니다.
추천 섹션에서 SharePoint를 선택합니다.
지식 추가 대화 상자의 스크린샷이며, SharePoint 옵션이 강조 표시되어 있습니다. SharePoint URL을 제공합니다. 여러 URL을 수동 줄 바꿈으로 구분합니다(Shift + Enter 사용).
이름 및 설명을 추가합니다. 특히 생성형 AI가 활성화된 경우 설명은 최대한 자세하게 작성해야 합니다. 설명은 생성형 오케스트레이션에 도움이 됩니다.
에이전트에 추가를 선택하여 기술 자료 추가를 완료합니다.
SharePoint 목록을 기술 자료로 추가
SharePoint 목록은 테이블 형식 데이터를 저장하고 정보에 빠르고 쉽게 액세스할 수 있는 인기 있는 방법입니다. 에이전트는 이러한 목록을 참조 자료 원본으로 사용할 수 있습니다. SharePoint 목록을 지식 원본으로 추가하면 원본에 대한 실시간 연결을 만들 수 있으므로 가장 최신 데이터는 쿼리 및 추론에 사용됩니다. 사용자는 SharePoint 자격 증명을 사용하여 인증되므로 에이전트가 응답을 제공하기 전에 데이터에 액세스할 수 있는 권한이 있는지 확인합니다.
에이전트를 엽니다.
개요 또는 참조 자료 페이지에서 참조 자료 추가를 선택하거나, 생성형 답변 노드의 속성을 선택합니다.
파일 업로드 섹션에서 SharePoint를 선택합니다.
Browse 항목을 선택하여 원하는 목록을 찾거나 특정 SharePoint 목록의 URL을 입력합니다.
SharePoint 옵션이 선택된 후 지식 추가 대화 상자의 스크린샷으로, 항목 찾아보기 및 URL 입력 옵션을 강조 표시합니다. 항목 찾아보기를 선택하면 대화 상자가 자동으로 내 목록 및 최근 목록으로 채워집니다. My 목록 SharePoint 목록 앱에서 만든 목록만 표시합니다. 다른 모든 목록은 최근 목록에 표시됩니다. 필요한 목록이 표시되지 않으면 SharePoint 열고 목록에 액세스하면 목록이 Recent Lists 표시됩니다.
한 번에 최대 15 개의 목록을 선택할 수 있습니다. 각 목록은 에이전트의 참조 자료 원본에 개별 항목으로 추가됩니다. 에이전트에 목록을 더 추가하려면 다음 단계를 다시 사용하고 더 많은 목록을 선택합니다.
참고
공유 액세스 권한이 있는 SharePoint 목록을 사용하지만 리센트 목록 표시되지 않는 경우 목록의 URL을 URL 선택 영역에 붙여넣습니다.
원하는 목록을 선택한 후 선택 확인을 선택합니다.
이름 및 설명을 추가합니다. 특히 생성형 AI가 활성화된 경우 설명은 최대한 자세하게 작성해야 합니다. 설명은 생성형 오케스트레이션에 도움이 됩니다.
에이전트에 추가를 선택하여 기술 자료 추가를 완료합니다.
고급 인증 시나리오
기본적으로 Copilot Studio는 Microsoft Teams, Power Apps 또는 Microsoft 365 Copilot 통해 에이전트에 연결할 때 Microsoft 인증을 사용하여 사용자를 인증하여 SharePoint 원본에 액세스하도록 에이전트를 미리 구성합니다. 그러나 인증을 수동으로 구성해야 하는 경우 생성 답변이 SharePoint 데이터 원본에서 작동하려면 다음 단계가 필요합니다.
중요
제한된 SharePoint Search를 사용하도록 설정하면 SharePoint 사용이 차단됩니다.
SharePoint 원본의 생성 답변은 SSO 지원 앱의 게스트 사용자가 사용할 수 없습니다.
에이전트를 인증하려면 인증을 참조하세요.
필요한 Microsoft Entra ID 애플리케이션 등록을 만드는 방법에 대한 지침은
Microsoft Entra ID 참조하세요. 이 등록을 만들 때 사용자 또는 관리자는 Microsoft Entra ID 앱 등록에서 Sites.Read.All및Files.Read.All범위를 지정해야 합니다.인증 안 함 선택하면 에이전트가 SharePoint 정보를 검색하지 않습니다.
인증을 구성할 때, 스코프는 사용자 액세스를 제어합니다. Copilot Studio에서 기존
Sites.Read.All및Files.Read.All값 근처의 범위 필드에profile및openid지정합니다. 이러한 범위는 에이전트를 사용할 때 사용자에게 향상된 권한을 부여하지 않지만 생성 답변에 대해 구성된 대로 SharePoint 사이트의 허용 가능한 콘텐츠를 허용합니다.SharePoint 다음 인증 서비스 공급자를 사용하여 수동 인증 설정을 지원합니다.
- Microsoft Entra ID
- 페더레이션 자격 증명을 사용하는 Microsoft Entra ID V2
- Microsoft Entra ID V2 인증서 사용
- Microsoft Entra ID V2 클라이언트 비밀번호 사용
SharePoint 일반 OAuth를 사용하는 수동 인증을 지원하지 않습니다.
이 구성은 생성형 답변에만 적용되며 Power Platform 커넥터에는 적용되지 않습니다.
SharePoint 원본 필터링
작성자는 검색 쿼리 매개 변수를 지정하여 에이전트의 SharePoint 기술 자료의 성능을 향상할 수 있습니다. 이 쿼리 매개변수들은 지식 소스 내에서 무엇을 검색하는지 정의합니다. 예를 들어, 최근 6개월 이내에 수정된 항목만 검색하도록 지정할 수 있습니다. 이 유형의 필터는 다음과 같이 생성됩니다.
| 특성 | 연산자 | 값 |
|---|---|---|
Modified on |
on or after |
X date |
필터 조건 만들기
SharePoint 기술 자료를 추가한 후 검색 조건을 설정할 수 있습니다.
Knowledge 페이지에서 SharePoint 원본을 선택합니다.
세 개의 점(…)을 선택하여 SharePoint 원본을 편집하고, 수정을 선택합니다.
고급 설정을 선택합니다.
SharePoint 정보 원본에서 정보를 포함하거나 제외하도록 필터를 빌드합니다. 필터는 다음 선택 항목 중 하나를 기반으로 할 수 있습니다.
- 제목
- 작성자
- 수정한 사람
- 수정 일시
조건 값을 다음 값 중 하나로 설정할 수 있습니다.
- 정적 값
- 에이전트와의 대화 중에 사용자가 제공하는 변수 입력으로, 사용자 지정 전역 변수로 저장됩니다.
- 시스템 변수
필터 구성이 완료되면 저장 을 선택합니다.
검색을 개선하기 위한 추가 설정
SharePoint 원본을 필터링하려면 다음 설정을 해제해야 합니다.
- 웹 검색
- 에이전트 수준에서 에이전트의 생성 AI 설정에서 일반 지식 설정 사용
- 토픽 수준에서 AI가 생성 응답 노드에서 고유한 일반 지식(미리 보기)을 사용하도록 허용
이러한 설정을 해제하면 필터링된 SharePoint 기술 원본에서 결과를 찾을 수 없는 경우 에이전트가 "응답 없음"으로 응답합니다.