참고
이 문서는 SharePoint의 기술 자료 에이전트 미리 보기 버전에 적용됩니다.
지식 에이전트는 현재 Microsoft 365 Government - GCC, GCC High, DoD 또는 Office 365 공극 클라우드 환경에서 지원되지 않습니다.
지식 에이전트는 organization AI용 콘텐츠를 준비하는 데 도움이 되도록 설계된 기본 제공 SharePoint 기능입니다. Microsoft 365 Copilot 에이전트에 최적화된 구조적이고 신뢰할 수 있는 형식으로 SharePoint 콘텐츠를 보강, 구성 및 유지 관리합니다.
적격 테넌트인 경우 SharePoint 화면의 오른쪽 아래 모서리에 새 에이전트 단추가 표시되어 적격 사용자에게 고급 AI 기능에 대한 액세스 권한을 부여합니다. 여기에는 자동화된 콘텐츠 보강, 메타데이터 최적화 및 지능형 페이지 요약이 포함됩니다.
필수 구성 요소
SharePoint 관리자(또는 전역 관리자)는 먼저 지식 에이전트(미리 보기)를 사용하도록 설정해야 합니다.
중요
사용 권한이 가장 적은 역할을 사용하는 것이 좋습니다. 사용 권한이 낮은 계정을 사용하면 organization 대한 보안을 개선하는 데 도움이 됩니다. 전역 관리자는 기존 역할을 사용할 수 없는 경우 긴급 시나리오로 제한해야 하는 매우 권한이 높은 역할입니다. 자세한 내용은 Microsoft 365 관리 센터 관리자 역할 정보를 참조하세요.
이 기능을 사용하려면 사용자에게 할당된 Microsoft 365 Copilot 라이선스가 있어야 하며 에이전트 단추를 보려면 사이트 소유자 또는 구성원이어야 합니다. 사용량은 Microsoft 365 Copilot 포함됩니다.
사이트 액세스에 대한 역할 정의
- 사이트 소유자: 전체 사이트 소유자 권한이 있는 사용자입니다.
- Content Manager: 읽기, 쓰기 및 목록 권한이 있는 사용자입니다.
- 콘텐츠 작성자: 사이트 콘텐츠 또는 사이트 구성원 그룹 액세스에 대한 읽기 및 쓰기 권한이 있는 사용자입니다.
- 콘텐츠 소비자: 사이트 콘텐츠 또는 적어도 사이트 방문자 그룹 액세스에 대한 읽기 권한이 있는 모든 사용자입니다.
지식 에이전트 사용
미리 보기의 경우 PowerShell을 사용하여 가용성을 구성합니다. 의 Set-SPOTenant 매개 변수를 사용하여 KnowledgeAgent 모든 사이트에서 지식 에이전트를 사용하도록 설정하거나, 사이트를 선택적으로 포함하거나, 사이트를 선택적으로 제외합니다.
다중 지역 테넌트에서 PowerShell 스크립트를 각 지역에서 실행하여 해당 지역의 지식 에이전트를 사용하도록 설정해야 합니다.
일반 공급 프로세스는 변경됩니다.
SharePoint Online 관리 셸 버전 16.0.26615.12013 이상을 사용하여 Copilot 라이선스가 있는 사용자의 지식 에이전트 미리 보기에 대한 액세스를 관리합니다. 설치 지침은 SharePoint Online 관리 셸 시작을 참조하세요.
SharePoint Online 관리 셸 이미 설치되어 있는 경우 관리 모드Update-Module -Name Microsoft.Online.SharePoint.PowerShell에서 다음 명령을 실행하여 최신 버전을 실행하고 있는지 확인합니다.
버전 관리 오류를 resolve
다음 오류가 발생하면 SharePoint Online 관리 셸 여러 버전 또는 충돌하는 버전이 설치되어 있음을 나타낼 수 있습니다.
Set-SPOTenant : A parameter cannot be found that matches parameter name 'KnowledgeAgentScope'
이 문제를 해결하려면 다음 단계를 따릅니다.
프로그램 추가 또는 제거를 열고 SharePoint를 검색하여 충돌하는 SharePoint 모듈을 제거합니다. 찾은 SharePoint 관리자 모듈을 제거합니다.
다음 명령을 실행하여 설치된 모듈을 확인합니다.
Get-Module -Name *SharePoint* -ListAvailable여러 버전이 나열된 경우 다음을 사용하여 제거합니다.
Uninstall-Module -Name <ModuleName>나머지 모듈을 수동으로 삭제합니다. 제거하는 동안 예외가 발생하는 경우 이 명령을 사용하여 모듈 경로를 찾습니다.
(Get-Module -Name *SharePoint* -ListAvailable).Path부모 폴더로 이동하여 수동으로 삭제합니다.
PowerShell을 다시 시작합니다. 터미널을 닫고 다시 열어 메모리에 로드된 모듈을 지웁니다.
정리를 반복합니다. SharePoint Online PowerShell 모듈이 남아 있지 않을 때까지 2단계와 3단계를 반복합니다.
최신 SharePoint Online PowerShell 모듈을 설치하려면 다음을 실행합니다.
Install-Module -Name Microsoft.Online.SharePoint.PowerShell참고
설치된 버전을 확인하려면 다음 명령을 사용합니다.
(Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable).Version여러 버전이 표시되면 이전 정리 단계를 반복합니다.
KnowledgeAgentScope
설명: 관리자는 지식 에이전트 기능을 사용할 수 있는 SharePoint 사이트를 제어할 수 있습니다.
유효한 값:
AllSites: 지식 에이전트는 모든 사이트에서 사용할 수 있습니다.IncludeSelectedSites: Knowledge Agent는 KnowledgeAgentSelectedSitesList에 지정된 사이트에서만 사용할 수 있습니다.ExcludeSelectedSites: KnowledgeAgentSelectedSitesList에 지정된 사이트를 제외한 모든 사이트에서 기술 자료 에이전트를 사용할 수 있습니다.NoSites: 지식 에이전트는 어떤 사이트에서도 사용할 수 없습니다. (기본값입니다.)
참고: Microsoft 365 Copilot 라이선스가 필요합니다.
KnowledgeAgentSelectedSitesList
설명: 관리자가 기술 자료 에이전트 기능을 포함하거나 제외할 SharePoint 사이트 URL 목록을 전달할 수 있습니다.
KnowledgeAgentScope = ExcludeSelectedSites: 목록은 EXCLUDE (사이트 옵트아웃 목록)로 처리됩니다.
- KnowledgeAgentScope = IncludeSelectedSites: 목록은 INCLUDE (사이트 옵트인 목록)로 처리됩니다.
기본적으로 제공된 목록으로 기존 목록을 덮어씁니다.
이 매개 변수는 가 또는
ExcludeSelectedSites로 설정된 경우에만 호출KnowledgeAgentScope할IncludeSelectedSites수 있습니다.사이트 URL 목록은 100개 항목을 초과할 수 없습니다.
참고: Microsoft 365 Copilot 라이선스가 필요합니다.
KnowledgeAgentSelectedSitesListOperation
설명: 지식 에이전트 기능의 현재 사이트 목록에서 수행할 작업을 지정합니다.
유효한 값:
Overwrite: 기존 사이트 목록(기본값)을 덮어씁니다.Append: 사이트의 입력 목록을 기존 사이트 목록에 추가합니다.Remove: 기존 사이트 목록에서 사이트의 입력 목록을 제거합니다.
참고: 이 매개 변수를 없이
KnowledgeAgentSelectedSitesList호출해도 아무런 효과가 없습니다.
사용 예제
모든 사이트에서 지식 에이전트 사용
# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com
# Enable Knowledge Agent for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope AllSites
# Verify the configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope
지정된 사이트에서 지식 에이전트 사용
# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com
# Set Knowledge Agent to be available only on the included sites
Set-SPOTenant -KnowledgeAgentScope IncludeSelectedSites
# Specify sites to enable Knowledge Agent (initial inclusion list)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site5", "https://yourtenant.sharepoint.com/sites/site7")
# Add additional sites to the existing inclusion list (if needed)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append
# Verify the inclusion configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList
지정된 사이트를 제외한 모든 사이트에서 지식 에이전트 사용
# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com
# Set Knowledge Agent to be available on all sites except selected sites
Set-SPOTenant -KnowledgeAgentScope ExcludeSelectedSites
# Specify sites to exclude from Knowledge Agent (initial exclusion list)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site1", "https://yourtenant.sharepoint.com/sites/site2")
# Add additional sites to the existing exclusion list (if needed)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append
# Verify the exclusion configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList
기술 에이전트 사용 안 함
# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com
# Disable Knowledge Agent for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope NoSites
# Verify Knowledge Agent is disabled
Get-SPOTenant | Select-Object KnowledgeAgentScope