カスタムナレッジファイルをKnowledge Hubにアップロードする

Knowledge Hubを介して、API アプリケーションプログラミングインターフェイス。組織で使用している他のソフトウェアとCXone Mpowerシステムを接続することにより、特定の機能を自動化できます。でナレッジベースにファイルを追加できます。これにより、カスタムナレッジソースナレッジ記事を管理および提供するナレッジマネジメントシステム。からのファイルをナレッジベースに入力できます。つまり、サポートされているナレッジソースKnowledge Hubを使用していない場合でも、を使用できます。その後、カスタムナレッジファイルを使用してコンテンツを生成するように Copilot for Agents を構成できます。

このメソッドは開発者の努力によるものです。 REST APIの知識と、APIを使用してファイルを送信するためのプログラミング能力が必要です。

ご注意:

個々のファイルの最大ファイルサイズは50MBです。
一度に最大100個のファイルを転送できます。

これらの各タスクを指定された順序で実行します。

ナレッジベースを構成する

以下の手順に従って、カスタムナレッジソースを使用するようにKnowledge Hubナレッジベースを構成します。これにより、ファイルを転送する API 呼び出しに含める必要があるナレッジベースに必要な ID が生成されます。

ナレッジベースをまだお持ちでない場合は、NiCEプロフェッショナルサービスにお問い合わせください。 NiCEプロフェッショナルサービスのみが新しいナレッジベースを作成できます。

CXone Mpowerで、アプリセレクターをクリックし、選択します：Admin > GenAI Manager >Knowledge Hub。
カスタムナレッジソースを追加するナレッジベースをクリックします。
ナレッジベースのソースドロップダウンで、カスタムを選択します。
[送信]をクリックします。

アクセストークンを取得する

Knowledge HubAPIを使用するには、通話のヘッダーにアクセストークンを含める必要があります。アクセストークンを取得するには、NiCEから提供された特定の資格情報を交換する必要があります。これを行うには、開発者ポータルのはじめにの手順に従います。後で、このアクセストークンを API 呼び出しに含める必要があります。これによりCXone Mpower通話が不正ではないことが通知されます。

API認証と認可に関する詳細をCXone Mpower で読むことができます。

ID の取得

Knowledge HubAPIでファイルを転送するには、次の2つのIDを含める必要があります。

Data Source ID: カスタムナレッジソースのユニークID文字列。これにより、API にコンテンツを取得する場所が指示されます。
Knowledge Hub ID: 構成したナレッジベースのユニークID文字列。これにより、API にコンテンツのプッシュ先が指示されます。

GET /knowledgehub APIを呼び出すことで、これらの両方を取得できます。

https://api-na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub APIを呼び出します。そのURLのna1を置き換える必要がある場合があります。それはあなたのURLnice-incontact.comのCXone Mpower前に来るものと一致するべきです。アクセストークンを必ず含めてください。
cURLの例を表示
```
curl --location 'https://api.na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [CXone token]'
		
```
応答で、Knowledge Hub ID配列のid属性でknowledgeBasesを見つけます。

サンプル画像の表示
data source ID配列のid属性でdataSourcesを見つけます。

サンプル画像の表示

Knowledge HubAPIでファイルをプッシュする

一度に最大100個のファイルをプッシュしてKnowledge Hubできます。ファイルあたりの最大サイズは50MBです。

POST /documents APIを使用してファイルをKnowledge Hubにプッシュするスクリプトを作成します。このスクリプトは、Python、C#、Java など、任意の言語で記述できます。このサンプル Python スクリプトをテンプレートとして使用できます。スケジュールに従って自動的に実行されるようにスクリプトを設定し、カスタムナレッジソースの最新コンテンツでKnowledge Hubを更新します。

呼び出しの要求本文に、前の手順で取得したPOST /documents API ID を文字列パラメーターとして入力します。

資格情報を使用してDEVone CXone Mpower Developer Communityにサインインします。
POST /documents のページに移動します。
Try it outをクリックします。
documents配列で次の値を編集します。
1. clientTokenに、認証で受け取ったアクセストークンを入力します。
2. dataSourceIdに、data source IDを入力します。
3. knowledgeHubIdに、Knowledge Hub IDを入力します。
設定したJSONをスクリプトにコピーします。

その後、カスタムナレッジがKnowledge Hubに送信されます。 Knowledge Hubはそれを取り込み、LLM 大規模言語モデル。文脈に基づいて人間の言語を処理、理解、生成するAIの一種。で使用するために解析します。これは、構成したナレッジベースの下にナレッジソースとして表示されます。