JinJin48
JinJin48
SAP Consultant | BTP · S/4HANA · US Global Rollout
· 15 min read

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 ナレッジベースプロバイダとは

ハブアンドスポーク図。ナレッジベースプロバイダーの2つのレイヤーを示しており、中央のコミュニケーション設定がエージェントデスクトップのネイティブウィジェットにフィードし、Mindtouchプロバイダータイプの場合にのみ条件付きでプロバイダー設定の認証情報サブレコードが表示される

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 プロバイダタイプ

3つのナレッジベースプロバイダタイプテンプレートの比較グリッド: NICE CXone Expert (Mindtouch)、SAP Build Work Zone、汎用 — Mindtouchのみが条件付きプロバイダ設定レイヤーを必要とするテンプレートであることを示すコールアウト付き

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 組織レベルとデータ階層

SAP Service Cloud マスタデータランドスケープのゾーンE拡大図。コミュニケーションとナレッジグループにおいて、ナレッジベースプロバイダカードが、EメールチャネルやEメールテンプレートと並ぶ、テナントレベルの独立したオブジェクトとして表示されています。

データ階層と具体例(ゾーン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オーナーシップの範囲

ナレッジベースプロバイダの2つの設定レイヤ(通信設定(ベース接続)およびプロバイダ設定(Mindtouch/NICE CXone Expert認証情報、条件付き))におけるSC所有権を示すチェックリスト

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

凡例: ◎ = オーナー / クリティカル、○ = 直接関与


2.1 通信設定(ベース接続)

ナレッジベースプロバイダの通信設定フィールドのチェックリスト: プロバイダタイプテンプレート、名前、HTTPデータ取得記事パス、HTTPデータ取得トップトレンド記事パス、アクティブ

これは、どのベンダーが背後にいるかにかかわらず、すべてのナレッジベースプロバイダ設定が通過するレイヤーです。これらのフィールドを正しく設定すれば、ウィジェットは少なくともプロバイダに呼び出すことができます。

フィールド説明実務上の使用例
プロバイダタイプテンプレートシステム設定 > 統合 > 通信設定でコピーされる事前構築済みテンプレート: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 認証情報)

ナレッジベースプロバイダの条件付きプロバイダ設定フィールドのチェックリスト、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

IDCategoryTitle
sc-001OverviewSAP Service Cloudとは何ですか?

L2-A) Master Data

IDCategoryTitle
sc-a01OverviewSAP Service Cloud マスタデータ:概要、階層、および関係性
sc-a02-01Master DataSAP Service Cloud 組織単位
sc-a02-02Master DataSAP Service Cloud 従業員
sc-a02-03Master DataSAP Service Cloud ビジネスロール
sc-a02-04Master DataSAP Service Cloud ビジネスユーザ
sc-a02-05Master DataSAP Service Cloud チーム
sc-a03-01Master DataSAP Service Cloud メールチャネル
sc-a03-02Master DataSAP Service Cloud メールテンプレート
sc-a04-01Master DataSAP Service Cloud ナレッジベースプロバイダ 📍
sc-a05-01Master DataSAP Service Cloud サービスカタログ
sc-a05-02Master DataSAP Service Cloud サービスカテゴリ
sc-a05-03Master DataSAP Service Cloud ケースタイプ
sc-a06-01Master DataSAP Service Cloud サービスレベル
sc-a06-02Master DataSAP Service Cloud サービスレベル決定
sc-a07-01Master DataSAP Service Cloud ケースルーティングルール
sc-a10-04Master DataSAP Service Cloud 保証
sc-a11-01Master DataSAP Service Cloud インストールベース
sc-a11-02Master DataSAP Service Cloud 機能場所

L2-B) Transaction

IDCategoryTitle
sc-b01OverviewSAP Service Cloud トランザクション:プロセスフロー、階層、リレーションシップ