ServiceNow Knowledge Base コネクター
ServiceNow ナレッジベース コネクタは、ServiceNow ナレッジベース システムとの安全かつ構成可能なインテグレーションを提供します。 ナレッジベースのコンテンツを毎日自動的に取り込み、同期し、最新バージョンの記事が常に利用可能であるようにするとともに、古いエントリや重複するエントリを削除します。 シームレスなデータインテグレーションのための標準搭載機能により、最新のナレッジへ一貫してアクセスでき、顧客の ServiceNow 環境内で信頼できる情報源を維持します。
このコネクタは ServiceNow のナレッジ記事を Spark で利用可能にし、最新の承認済みナレッジにアクセスして、より正確な推奨と応答を提供できるようにします。 詳細については、Managing Spark data inputs を参照してください。
コネクタの認証情報の設定
Nexthink が ServiceNow ナレッジベースから記事を取得できるようにするには、適切なアクセスレベルを持つ専用の統合アカウントを ServiceNow で設定します。
ナレッジ記事の取得に使用する ServiceNow 認証情報を設定するには、以下の手順に従います：
ServiceNow 管理コンソールで、Nexthink 統合用の専用のアクティブな ServiceNow ユーザーアカウントを作成します。 API 認証用にアカウントを有効にします。
コネクタに必要な最小限の読み取りアクセス権のみを割り当てます。 管理者ロールまたは書き込みアクセス権を持つロールは割り当てないでください。
必須の記事フィールド
numberおよびcontentへの読み取りアクセス権を付与します。 コネクタは、両方がなければ記事を取り込むことができません。 Nexthink はnumberを記事 ID として使用し、ServiceNow に戻る外部リンクの作成にも使用します。統合ユーザーのユーザー基準の割り当てを、コネクタパラメーターで選択するターゲットグループに合わせます。
コネクタ認証情報の詳細については、コネクタ資格情報ドキュメンテーションを参照してください。
ServiceNow ナレッジベース コネクタの設定
Nexthink web インターフェース から:
Administration > Inbound connectors に移動します。
ページの右上隅にある 新しいコネクタ ボタンをクリックします。
ServiceNow Knowledge Base を選択します。
一般タブ
Name: コネクタにとって意味のある名前です。 この名前は管理ページに表示されます。
NQL ID：NQL クエリで ServiceNow コネクタを参照する際に使用される、コネクタ固有の識別子です. 提案された NQL ID は最初に変更できますが、コネクタを保存すると以後は変更できなくなります。
Description: コネクターの目的と動作に関する簡潔な説明です。
スケジューリング:
繰り返し：実行時刻と繰り返しを設定します。 実行は予定された時刻に開始され、その後1時間にわたって分散して行われます。
接続:
資格情報: コネクターの資格情報ページから事前設定済みの資格情報を選択します。 このコネクタは、OAuth 2.0 と Basic Auth の認証方法をサポートしています。 認証情報には、ユーザー基準の割り当てが標準従業員または技術従業員と一致する専用の統合ユーザーのものを使用する必要があります。 これにより、API はターゲットグループに表示されるナレッジ記事のみを返します。 統合ユーザーには、必須の記事フィールド
numberおよびcontentへの読み取りアクセス権も必要です。 詳細については、コネクタ資格情報ドキュメンテーションを参照してください。
パラメータ タブ
Knowledge base title: ServiceNow に表示されているとおりのナレッジベースのタイトルを入力します。 この値は、指定されたナレッジベースから記事をフィルタリングして取得するために使用されます。
クエリ (任意): ServiceNow ナレッジベースの記事をフィルタリングするためのクエリ。 Nexthink では、クエリに
workflow_state=publishedフィルターを含めることを推奨しています。 これにより、Spark は公開済みの記事のみを使用し、下書きや廃止済みの記事が返されるのを防ぐことができます。 このフィルターがデフォルトで適用されていないのは、ServiceNow のワークフローステートがカスタマイズ可能であり、publishedがすべての環境に一致するとは限らないためです。External link: ServiceNow のナレッジシステム内の個々のナレッジ記事にリンクする、パラメータ付きの完全な URL を入力します。 URL には記事識別子のプレースホルダーを含める必要があり、AI エージェントが元のコンテンツへの直接リンクを生成できるようにします。 ルートのみのホスト名はサポートされていません。
Example:
https://<instance>.service-now.com/sp?id=kb_article&sysparm_article={number}
Target group: ナレッジベース記事をフィルタリングする対象ユーザーグループを選択します。 Employee グループは一般従業員向けの記事を表示し、Technical Support グループはサポート担当者向けの記事を表示します。
カスタムヘッダー: OAuth 2.0 認証方式において、Client Credentials や Authorization Code などの追加資格情報を含めるためにカスタムヘッダーを使用します。 デフォルトのOAuth 2.0認証メカニズムを超えて追加の認証方法が必要な場合に便利です。 OAuth 2.0 - クライアント認証情報またはOAuth 2.0 - 認証コード認証に追加情報を含めるには、カスタムヘッダーを追加を選択します。
テスト結果パネル
テスト結果パネルは、サポートされているコネクタでのみ利用可能です。 コネクタの可用性はライセンスに依存します。
右側の Test results パネルを使用すると、実際のデータでコネクターをオンデマンドで実行し、レスポンスやエラーを確認できます。 テストパネルは、セットアップ時のデバッグと検証をより迅速に行うのに役立ち、試行錯誤を減らして、より信頼性の高いマッピングを実現します。
API を呼び出し、認証情報を検証し、対象のエンドポイントへの接続性を確認するには、Run test ボタンを選択します。
レスポンスのステータスコードや時間といった基本情報に加えて、パネルの下部にはレスポンスのサンプルレコードも表示されます。
エラーが発生した場合、問題の診断に役立てるためにシステムは API のレスポンスを表示します。
記事数の確認
初回の実行後、または設定を変更した後にコネクタを確認します。
コネクタの実行ログをクエリするには、ロールに プラットフォームログ が 表示 に設定されている必要があります。 https://github.com/nexthink/documentation.online-product-documentation/tree/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md のドキュメントを参照してください。
コネクタで処理された最新の実行ステータスと行数を確認するには、次の NQL クエリを実行します。
クエリ結果を使用して、number_of_processed_rows_ が ServiceNow から取得される予定のナレッジ記事数と一致していることを確認します。
最終更新
役に立ちましたか？