SAP Service Cloud ナレッジベースプロバイダ
SAP Service Cloud ナレッジベースプロバイダ
Knowledge Base Providerは、SAP Service Cloudの設定レコードであり、ネイティブのAgent Desktopウィジェットを外部ナレッジベースに接続します。これにより、オープン中のCaseやRegistered Productに関連する推奨記事、ウィジェット内での記事検索、人気記事リスト、URLコピー、メール送信が可能になります。Email Channel(SC-A03-01)やEmail Template(SC-A03-02)とは異なり、単一のフラットなマスタレコードではなく、3つのプロバイダタイプテンプレート(NICE CXone Expert/Mindtouch、SAP Build Work Zone、Generic)のいずれかからコピーされたCommunication Configurationであり、さらに、プロバイダがMindtouchの場合のみ、Provider Settingsの下に別途入力される個別の認証情報サブレコードが存在します。この記事では、両方のレイヤー、それらに依存するウィジェット消費動作、およびKnowledge Base Providerが意図的に接続しないオブジェクトについて説明します。
パート 1: ナレッジベースプロバイダ — 基本概念(全モジュール共通)
1.1 ナレッジベースプロバイダとは

Knowledge Base Providerは、エージェントデスクトップのネイティブKnowledge Baseウィジェットが外部ナレッジベースシステムからコンテンツを取得できるようにする接続性を表します。これは設定レコードであり、記事コンテンツそのものではありません。これにより、推奨記事の提案、ウィジェット内検索、トレンド記事一覧を、カスタム開発なしでライブのサードパーティナレッジベースに対して実行できます。管理者はCommunication ConfigurationをプロバイダのAPIエンドポイントに向け、特定のプロバイダタイプについては、2つ目の条件付きレコードでそのプロバイダの認証情報を提供します。
| 項目 | 詳細 |
|---|---|
| 役割 | Agent Desktopネイティブナレッジベースウィジェットを外部ナレッジベースプロバイダに接続するテナントレベルの設定であり、コンテンツや記事レコードそのものではありません |
| 使用するモジュール | SAP Service Cloud(ナレッジ — 単独所有者)。Agent Desktopネイティブナレッジベースウィジェット(カスタマーハブ)で、推奨記事、記事検索、人気トップリスト、記事URLのコピー、記事のメール送信に使用されます |
| トランザクション | SAP Service Cloud管理コンソール:システム設定 > 統合 > 通信設定(基本接続レコード、全プロバイダタイプ共通);システム設定 > ナレッジベース > プロバイダ設定(Mindtouch/NICE CXone Expert認証情報サブレコードのみ) |
| 主要テーブル | SAP Service Cloud:通信設定ビジネスオブジェクト(管理/Core API ODataエンティティ、汎用統合オブジェクト)およびMindtouch用のプロバイダ固有認証情報レコード。SAP Service CloudはマルチテナントSaaSソリューションであり、コンサルタントに従来のABAPテーブルは公開されません |
| S/4HANAに関する注意 | ナレッジベースプロバイダは、Service Cloudテナント内で外部ナレッジベースシステム(例:NICE CXone Expert/Mindtouch、SAP Build Work Zone)に対してネイティブに設定され、S/4HANAから複製されるものではありません。通信設定を作成する前に、通信システム(汎用統合前提条件、アウトバウンドプロトコルHTTPS)が存在している必要があります。これはプラットフォームレベルの統合依存関係であり、別のService Cloudビジネス基本データオブジェクトへの依存関係ではありません |
1.2 プロバイダタイプ

Knowledge Base Providerは、空のレコードとして作成されるわけではありません。管理者は、システム設定 > 統合 > 通信設定にて、3つの事前構築済みテンプレートのいずれかをコピーします。コピーされたテンプレートによって、2つのHTTPデータパスで期待されるAPIの形状と、2番目の設定レイヤー(プロバイダ設定)が必要かどうかの両方が決まります。
| プロバイダタイプテンプレート | 標準構成 | ユースケース | 主要な動作 |
|---|---|---|---|
| NICE CXone Expert (Mindtouch) | テンプレートをコピー、名前変更、2つのHTTPデータAPIパスを設定、アクティブを切り替え — さらにプロバイダ設定(ユーザ/キー/シークレット)も完了 | NICEのMindtouchベースのナレッジベースを統合 — SAPが最も詳細に文書化しているプロバイダタイプ | 3つのテンプレートの中で、2番目の構成レイヤーが必要な唯一のもの。プロバイダ設定を完了しないと、ウィジェットはMindtouch APIに対して認証できず、通信構成がアクティブでAPIパスが正しくても記事を取得できない |
| SAP Build Work Zone | テンプレートをコピー、名前変更、2つのHTTPデータAPIパスを設定、アクティブを切り替え。別の相互参照されたサブ手順(「SAP Build Work ZoneネイティブKBウィジェット統合の構成」)で追加構成をカバー | SAP独自のBuild Work Zoneをナレッジソースとして統合 | 追加のサブ手順は名前が示されているが、同じ章では詳細が説明されていない — これはプロバイダ設定スタイルの認証情報画面ではなく、それ自体がフォローアップの構成ステップとして扱う |
| 汎用 - その他すべてのナレッジベースプロバイダ | テンプレートをコピー、名前変更、2つのHTTPデータAPIパスを設定、アクティブを切り替え — 2番目のレイヤーなし | 上記2つの名前付きテンプレートでカバーされていないその他のナレッジベースプロバイダ | 単一レイヤーの構成のみ。基盤となるベンダーに関係なく、プロバイダ設定ステップは適用されない |
設計原則: プロバイダタイプテンプレートの選択は、第2の設定レイヤーが存在するかどうかを決定する唯一の判断です。Mindtouchは3つの中で唯一、プロバイダ設定の完了を必要とし、他の2つは通信設定で終了します。
1.3 組織レベルとデータ階層

データ階層と具体例(ゾーンE · コミュニケーション&ナレッジ — テナントレベル;SAP Service Cloudには、この上位に会社コード/プラントのスコーピングはありません)
Client (SAP Service Cloud Tenant)
│
├── Communication System "COMSYS-KB-EXPERT" — outbound protocol HTTPS (Integration prerequisite, created first)
│
└── Communication Configuration "KB-PROVIDER-01" — copied from template "NICE CXone Expert (Mindtouch)"
HTTP Data: "Retrieve articles based on..." API path · "Get Top Trending Articles from..." API path · Active: Yes
│
└── (Mindtouch template only) Provider Settings — "Knowledgebase Providers > NICE CXone Expert (Mindtouch)"
User: kb-integration-account · Key: •••••••• · Secret: ••••••••
Communication Configuration "KB-PROVIDER-01" ── read at runtime by ──> Agent Desktop native Knowledge Base widget (Customer Hub)
└── recommended articles keyed off the linked Case or Registered Product設計原則: Communication SystemはCommunication Configurationの上位に位置し、真の前提条件として最初に存在する必要があります。Provider SettingsはMindtouchテンプレートにのみ適用される条件付き子要素であり、SAP Build Work ZoneおよびGenericプロバイダでは設定されないため、3つのプロバイダタイプすべてに一律に適用されるステップとして描画しないでください。
1.4 他のマスタデータオブジェクトとの統合

Knowledge Base Providerの唯一の真の依存関係は、それが構築されている汎用統合オブジェクトへの上流方向にあります。CaseおよびRegistered Productとの関係は逆方向であり、ウィジェット表示/検索時にライブ読み取りとして機能するもので、保存されたフィールドレベルの参照としては決して使用されません。Zone Eの他の2つのメンバー(Email Channel、Email Template)も「このオブジェクトはCase Typeやルーティングに密かに接続されているのか?」という同じ疑問を引き起こすため、Knowledge Base Providerが接続しないオブジェクトについて明確にしておく価値があります。
| オブジェクト | 関係性 | 実務上の注意点 |
|---|---|---|
| 通信システム / 通信設定(汎用統合オブジェクト) | 上流の前提条件 | 通信システムが先に存在している必要があります(送信プロトコルHTTPS)。ナレッジベースプロバイダの接続性は、3つのプロバイダタイプテンプレートのいずれかからコピーされた通信設定です。これは汎用的なプラットフォーム/統合の依存関係であり、Service Cloudのビジネス基本データオブジェクトではありません。 |
| ケース(トランザクションオブジェクト、基本データではない) | 実行時、読み取り専用でのみ消費 | ネイティブウィジェットは「リンクされたケースに基づく推奨記事」を表示し、ケースフィールドデータを検索クエリとして外部ナレッジベースに渡すことができます(表示/検索時)。これはウィジェットがライブのケースコンテキストを読み取っているものであり、ナレッジベースプロバイダレコードとケースオブジェクト、または任意のケース基本データ(ケースタイプ、サービスカテゴリ)との間の保存されたフィールドレベルの参照ではありません。 |
| 登録製品(基本データ) | 実行時、読み取り専用でのみ消費 | ウィジェットの推奨は、登録製品コンテキストによっても駆動され、ケースと同じライブ読み取りパターンに従います。保存された基本データリンクは見つかりませんでした。 |
| ケースタイプ(SC-A05-03) | 関係なし | 公式セットアップガイドの全文構造スキャン(ナレッジベース用語との共起)を含む、いずれのソースでも関係は見つかりませんでした。 |
| サービスカテゴリ(SC-A05-02) | 関係なし | 同じ全文構造スキャンに基づき、いずれのソースでも関係は見つかりませんでした。 |
| ケースルーティングルール(SC-A07-01) | 関係なし | いずれのソースでも関係は見つかりませんでした。 |
| メールチャネル(SC-A03-01)/ メールテンプレート(SC-A03-02) | 関係なし | 両オブジェクトの独自調査結果(SC-A03-01、SC-A03-02)を裏付けています。「ナレッジベース」と「テンプレート」の概念が同時に出現するのは、エージェントワークスペースのUIレベル(エージェントがテンプレートとKB記事を1つの返信に組み合わせる可能性がある)のみであり、これはUI上の利便性であり、基本データの関係ではありません。 |
適用範囲注記: SAPの現在のセットアップガイドでは、上記の通信設定+プロバイダ設定のパスをネイティブウィジェットのメカニズムとして文書化しています。SAPサポートナレッジベースのコンテンツやMindtouch/NICEベンダー自身のドキュメントで参照されている、より古いHTMLマッシュアップ/OpenSearchベースの統合パスは、3つの組み込みテンプレート以外のサードパーティのOpenSearch準拠プロバイダに使用可能であると説明されています。この調査では、2つのメカニズムを調整するSAP公式の文書は見つかりませんでした。マッシュアップパスは、ネイティブウィジェットによって完全に確実に解決された、またはそれに取って代わられたものではなく、文書化された代替/レガシーパターンとして扱ってください。また、この同じ管理者設定レコードが(内部のエージェントデスクトップウィジェットだけでなく)外部の顧客セルフサービスポータルも駆動するかどうかは、ナレッジベースベンダー自身の資料にのみ文書化されており、SAP公式のService Cloud V2ドキュメントでは確認されていません。未確認の機能として、未解決項目として扱ってください。
パート 2: SC固有のフィールド詳細
2.0 SCオーナーシップの範囲

| データセクション | SC関与 | 備考 |
|---|---|---|
| 通信設定(基本接続) | ◎ オーナー | プロバイダタイプテンプレート、名前、2つのHTTPデータAPIパス、およびアクティブスイッチ — プロバイダタイプに関係なく、すべてのナレッジベースプロバイダ設定が持つレイヤー。 |
| プロバイダ設定(Mindtouch/NICE CXone Expert認証情報) | ◎ オーナー(条件付き) | ユーザ、キー、シークレット — 通信設定がNICE CXone Expert(Mindtouch)テンプレートからコピーされた場合のみ必須。SAP Build Work Zoneおよび汎用プロバイダはこのセクションを設定しません。 |
凡例: ◎ = オーナー / クリティカル、○ = 直接関与
2.1 通信設定(ベース接続)

これは、どのベンダーが背後にいるかにかかわらず、すべてのナレッジベースプロバイダ設定が通過するレイヤーです。これらのフィールドを正しく設定すれば、ウィジェットは少なくともプロバイダに呼び出すことができます。
| フィールド | 説明 | 実務上の使用例 |
|---|---|---|
| プロバイダタイプテンプレート | システム設定 > 統合 > 通信設定でコピーされる事前構築済みテンプレート:NICE CXone Expert (Mindtouch)、SAP Build Work Zone、または汎用 - その他すべてのナレッジベースプロバイダ | テンプレートをコピーして結果の名前を変更することで行う、一度限りの時間節約の選択です。また、プロバイダ設定が適用されるかどうか(Mindtouchのみ)も決定します。実際にはMindtouch互換のプロバイダに対して「汎用」を選択すると、接続はできてもベンダー固有の「ナレッジベースプロバイダ」資格情報画面が表示されないレコードが作成されます。 |
| 名前 | テンプレートコピー後に通信設定に付与される自由テキストラベル | このレコードに対して、名前とは別にシステム生成のIDが存在することを文書化したソースはありません。名前を唯一の識別属性として扱い、プロバイダタイプをエンコードした命名規則(例:KB-MINDTOUCH-PROD、KB-GENERIC-PARTNER)を選択してください。 |
| HTTPデータ — 「記事を取得(…に基づく)」APIパス | ウィジェットが推奨記事と検索可能な記事を取得するために呼び出す送信APIエンドポイント | このパスはウィジェットの推奨記事機能と検索機能を動作させます。この通信設定のプロバイダタイプについて、ナレッジベースベンダーが文書化している特定のエンドポイントを指定してください。 |
| HTTPデータ — 「人気のトレンド記事を取得(…から)」APIパス | ウィジェットが人気のトレンド記事リストを取得するために呼び出す送信APIエンドポイント | 上記の記事取得パスとは別のエンドポイントです。リストされているすべてのウィジェット機能が動作するには、両方が正しく設定されている必要があります。 |
| アクティブ | 通信設定を有効/無効にするスイッチ | ウィジェットがこのプロバイダに呼び出す前に、このスイッチをオンにする必要があります。設定済みでも非アクティブなレコードは、セットアップ直後にウィジェットにナレッジベースコンテンツが表示されない原因の一つです。 |
前提条件: このコミュニケーション設定を作成する前に、コミュニケーションシステム(送信プロトコルHTTPS)がすでに存在している必要があります。まだこのプロバイダのホスト用に存在しない場合は、最初にシステム設定 > 統合 > コミュニケーションシステムで設定してください。
2.2 プロバイダ設定 (Mindtouch/NICE CXone Expert 認証情報)

この第2レイヤーは、3つのプロバイダタイプのうち1つにのみ存在します。これは、Mindtouchベースのナレッジベースを呼び出す際にウィジェットが認証に使用するアカウント資格情報を保持します。
| フィールド | 説明 | 実務上の使用方法 |
|---|---|---|
| ユーザ | Mindtouch/NICE CXone Expertアカウントのユーザ名。「システム設定 > ナレッジベース > プロバイダ設定」の「ナレッジベースプロバイダ」画面で入力します。 | サービス/統合アカウントのユーザ名を入力します。個々のエージェントのログイン情報ではありません。これは、ウィジェットがMindtouch APIを呼び出す際に認証されるアカウントです。 |
| キー | Mindtouch/NICE CXone ExpertアカウントのAPIキー資格情報。 | ベンダー側のMindtouch/NICE CXone Expert管理コンソールから取得します。この画面ではプレーンテキストの設定フィールドとして入力されるため、通常の資格情報管理の慣行に従って取り扱ってください。 |
| シークレット | キーと対になるAPIシークレット資格情報。 | 常にキーと一緒に管理してください。Mindtouch/NICE CXone Expert側でいずれかがローテーションされた場合、ウィジェットの接続を維持するために、ここで両方を再入力する必要があります。 |
前提条件: このセクションは、セクション2.1の通信設定がNICE CXone Expert (Mindtouch) テンプレートからコピーされた場合にのみ適用されます。SAP Build Work Zoneおよび汎用プロバイダは、この手順を完全にスキップします。
次に読むべきもの
L1) Big Picture
| ID | Category | Title |
|---|---|---|
| sc-001 | Overview | SAP Service Cloudとは何ですか? |
L2-A) Master Data
| ID | Category | Title |
|---|---|---|
| sc-a01 | Overview | SAP Service Cloud マスタデータ:概要、階層、および関係性 |
| sc-a02-01 | Master Data | SAP Service Cloud 組織単位 |
| sc-a02-02 | Master Data | SAP Service Cloud 従業員 |
| sc-a02-03 | Master Data | SAP Service Cloud ビジネスロール |
| sc-a02-04 | Master Data | SAP Service Cloud ビジネスユーザ |
| sc-a02-05 | Master Data | SAP Service Cloud チーム |
| sc-a03-01 | Master Data | SAP Service Cloud メールチャネル |
| sc-a03-02 | Master Data | SAP Service Cloud メールテンプレート |
| sc-a04-01 | Master Data | SAP Service Cloud ナレッジベースプロバイダ 📍 |
| sc-a05-01 | Master Data | SAP Service Cloud サービスカタログ |
| sc-a05-02 | Master Data | SAP Service Cloud サービスカテゴリ |
| sc-a05-03 | Master Data | SAP Service Cloud ケースタイプ |
| sc-a06-01 | Master Data | SAP Service Cloud サービスレベル |
| sc-a06-02 | Master Data | SAP Service Cloud サービスレベル決定 |
| sc-a07-01 | Master Data | SAP Service Cloud ケースルーティングルール |
| sc-a10-04 | Master Data | SAP Service Cloud 保証 |
| sc-a11-01 | Master Data | SAP Service Cloud インストールベース |
| sc-a11-02 | Master Data | SAP Service Cloud 機能場所 |
L2-B) Transaction
| ID | Category | Title |
|---|---|---|
| sc-b01 | Overview | SAP Service Cloud トランザクション:プロセスフロー、階層、リレーションシップ |