注:
この記事は、SharePoint のナレッジ エージェントのプレビュー バージョンに適用されます。
現在、ナレッジ エージェントは、Microsoft 365 Government (GCC、GCC High、DoD、Office 365エアギャップ クラウド環境) ではサポートされていません。
Knowledge Agent は、organizationが AI 用のコンテンツを準備するのに役立つ組み込みの SharePoint 機能です。 SharePoint コンテンツは、Microsoft 365 Copilot エージェント用に最適化された、構造化された権限のある形式で強化、整理、保守されます。
対象となるテナントの場合、SharePoint サーフェスの右下隅に新しいエージェント ボタンが表示され、対象ユーザーは高度な AI 機能にアクセスできます。 これには、自動コンテンツ エンリッチメント、メタデータの最適化、インテリジェントなページ要約が含まれます。
前提条件
SharePoint 管理者 (またはグローバル管理者) は、まずナレッジ エージェント (プレビュー) を有効にする必要があります。
重要
Microsoft では、アクセス許可が可能な限りで少ないロールを使用することをお勧めします。 アクセス許可の低いアカウントを使用すると、組織のセキュリティが向上します。 グローバル管理者は高い特権を持つロールであり、既存のロールを使用できない場合の緊急時に限定する必要があります。 詳細については、「Microsoft 365 管理センターの管理者ロールについて」を参照してください。
この機能を使用するには、エージェント ボタンを表示するには、ユーザーにMicrosoft 365 Copilot ライセンスが割り当てられ、サイト所有者またはメンバーである必要があります。 使用量は、Microsoft 365 Copilotに含まれています。
サイト アクセスのロール定義
- サイト所有者: 完全なサイト所有者アクセス許可を持つユーザー。
- コンテンツ マネージャー: 読み取り、書き込み、およびリストのアクセス許可を持つユーザー。
- コンテンツ作成者: サイト コンテンツに対する読み取りおよび書き込みアクセス許可を持つユーザー、または少なくとも Site Members グループアクセス権を持つユーザー。
- コンテンツ コンシューマー: サイト コンテンツに対する読み取りアクセス許可を少なくとも持つユーザー、または少なくとも Site Visitors グループ アクセス権を持つユーザー。
ナレッジ エージェントを有効にする
プレビューでは、PowerShell を使用して可用性を構成します。
Set-SPOTenantでKnowledgeAgentパラメーターを使用して、すべてのサイトでナレッジ エージェントを有効にするか、サイトを選択的に含めるか、サイトを選択的に除外します。
複数地域テナントの場合、そのリージョンでナレッジ エージェントを有効にするには、各 geo で PowerShell スクリプトを実行する必要があります。
有効化プロセスは、一般提供のために変更されます。
SharePoint Online 管理シェル バージョン 16.0.26615.12013 以降を使用して、Copilot ライセンスを持つユーザーのナレッジ エージェント プレビューへのアクセスを管理します。 セットアップ手順については、「SharePoint Online 管理シェルの概要」を参照してください。
SharePoint Online 管理シェルが既にインストールされている場合は、管理モードで次のコマンドを実行して、最新バージョンを実行していることを確認します: Update-Module -Name Microsoft.Online.SharePoint.PowerShell。
バージョン管理エラーを解決するには
次のエラーが発生した場合は、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: ナレッジ エージェントは、KnowledgeAgentSelectedSitesList で指定されたサイトでのみ使用できます。ExcludeSelectedSites: ナレッジ エージェントは、KnowledgeAgentSelectedSitesList で指定されているものを除くすべてのサイトで使用できます。NoSites: ナレッジ エージェントはどのサイトでも使用できません。 (これは既定値です)。
注: ライセンスMicrosoft 365 Copilot必要です。
KnowledgeAgentSelectedSitesList
説明: 管理者は、SharePoint サイト URL の一覧を渡して、ナレッジ エージェント機能を含めたり除外したりできます。
KnowledgeAgentScope = ExcludeSelectedSites: リストは EXCLUDE (サイト オプトアウト リスト) のサイトとして扱われます。
- KnowledgeAgentScope = IncludeSelectedSites: リストは INCLUDE (サイトオプトイン リスト) のサイトとして扱われます。
既定では、既存のリストが指定されたリストで上書きされます。
このパラメーターは、
KnowledgeAgentScopeがIncludeSelectedSitesまたはExcludeSelectedSitesに設定されている場合にのみ呼び出すことができます。サイト 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