> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-servicenow-knowledge-base.md).

# ServiceNow Knowledge Base コネクター

ServiceNow ナレッジベース コネクタは、ServiceNow ナレッジベース システムとの安全かつ構成可能なインテグレーションを提供します。 ナレッジベースのコンテンツを毎日自動的に取り込み、同期し、最新バージョンの記事が常に利用可能であるようにするとともに、古いエントリや重複するエントリを削除します。 シームレスなデータインテグレーションのための標準搭載機能により、最新のナレッジへ一貫してアクセスでき、顧客の ServiceNow 環境内で信頼できる情報源を維持します。

このコネクタは ServiceNow のナレッジ記事を Spark で利用可能にし、最新の承認済みナレッジにアクセスして、より正確な推奨と応答を提供できるようにします。 [Spark 設定とデータ入力の管理](/platform/ja/user-guide/spark/setting-up-and-managing-spark/managing-spark-settings.md) のドキュメントを参照してください。

## コネクタの認証情報の設定

Nexthink が ServiceNow ナレッジベースから記事を取得できるようにするには、適切なアクセスレベルを持つ専用の統合アカウントを ServiceNow で設定します。

ナレッジ記事の取得に使用する ServiceNow 認証情報を設定するには、以下の手順に従います：

1. ServiceNow 管理コンソールで、Nexthink 統合用の専用のアクティブな ServiceNow ユーザーアカウントを作成します。 API 認証用にアカウントを有効にします。
2. コネクタに必要な最小限の読み取りアクセス権のみを割り当てます。 管理者ロールまたは書き込みアクセス権を持つロールは割り当てないでください。
3. 必須の記事フィールド `number` および `content` への読み取りアクセス権を付与します。 コネクタは、両方がなければ記事を取り込むことができません。 Nexthink は `number` を記事 ID として使用し、ServiceNow に戻る外部リンクの作成にも使用します。
4. 統合ユーザーのユーザー基準の割り当てを、コネクタパラメーターで選択するターゲットグループに合わせます。

コネクタ認証情報の詳細については、[サードパーティ認証情報](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/connector-credentials.md)ドキュメンテーションを参照してください。

## ServiceNow ナレッジベース コネクタの設定

Nexthink web インターフェース から:

1. **Administration** > **Inbound connectors** に移動します。
2. ページの右上隅にある **新しいコネクタ** ボタンをクリックします。
3. **ServiceNow Knowledge Base** を選択します。

### 一般タブ

* **Name**: コネクタにとって意味のある名前です。 この名前は管理ページに表示されます。
* **NQL ID**：NQL クエリで ServiceNow コネクタを参照する際に使用される、コネクタ固有の識別子です. 提案された NQL ID は最初に変更できますが、コネクタを保存すると以後は変更できなくなります。
* **Description**: コネクターの目的と動作に関する簡潔な説明です。
* **スケジューリング**:
  * **繰り返し**：実行時刻と繰り返しを設定します。 実行は予定された時刻に開始され、その後1時間にわたって分散して行われます。
* **接続:**
  * **資格情報**: コネクターの資格情報ページから事前設定済みの資格情報を選択します。 このコネクタは、OAuth 2.0 と Basic Auth の認証方法をサポートしています。 認証情報には、ユーザー基準の割り当てが標準従業員または技術従業員と一致する専用の統合ユーザーのものを使用する必要があります。 これにより、API はターゲットグループに表示されるナレッジ記事のみを返します。 統合ユーザーには、必須の記事フィールド `number` および `content` への読み取りアクセス権も必要です。 詳細については、[サードパーティ認証情報](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/connector-credentials.md)ドキュメンテーションを参照してください。

<figure><img src="/files/krubvSXgyPvl0faUhW6e" alt=""><figcaption></figcaption></figure>

### パラメータ タブ

* **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 - 認証コード**認証に追加情報を含めるには、**カスタムヘッダーを追加**を選択します。

<figure><img src="/files/EJzdLvJ2YWnj087qSMHZ" alt=""><figcaption></figcaption></figure>

## テスト結果パネル

{% hint style="info" %}
**テスト結果**パネルは、サポートされているコネクタでのみ利用できます。 コネクタの可用性は、ライセンスによっても異なります。
{% endhint %}

右側の **Test results** パネルを使用すると、実際のデータでコネクターをオンデマンドで実行し、レスポンスやエラーを確認できます。 テストパネルは、セットアップ時のデバッグと検証をより迅速に行うのに役立ち、試行錯誤を減らして、より信頼性の高いマッピングを実現します。

API を呼び出し、認証情報を検証し、対象のエンドポイントへの接続性を確認するには、**Run test** ボタンを選択します。

<figure><img src="/files/PLl885mqimBjK0djsomM" alt=""><figcaption></figcaption></figure>

レスポンスのステータスコードや時間といった基本情報に加えて、パネルの下部にはレスポンスのサンプルレコードも表示されます。

<figure><img src="/files/HNOO9UOC8up7nND9wS3Y" alt="" width="316"><figcaption></figcaption></figure>

エラーが発生した場合、問題の診断に役立てるためにシステムは API のレスポンスを表示します。

<figure><img src="/files/aBnrPUlVkGJndts4wRmv" alt="" width="309"><figcaption></figcaption></figure>

## 記事数の確認​

初回の実行後、または設定を変更した後にコネクタを確認します。

{% hint style="warning" %}
コネクタの実行ログをクエリするには、ロールに **プラットフォームログ** が **表示** に設定されている必要があります。 [https://github.com/nexthink/documentation.online-product-documentation/tree/develop/ja\_docs/configuring\_nexthink/configuring-your-platform/administration/account-management/roles/README.md](https://github.com/nexthink/documentation.online-product-documentation/tree/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md "mention") のドキュメントを参照してください。
{% endhint %}

コネクタで処理された最新の実行ステータスと行数を確認するには、次の NQL クエリを実行します。

```sql
platform.inbound_connector_logs during past 8d
| where details.connector == "servicenow_knowledge"
| summarize last_update = time.last() , last_status = status.last(), number_of_processed_rows_ = details.number_of_processed_rows.last(), number_of_received_rows_ = details.number_of_received_rows.last()  by details.nql_id, details.name
```

クエリ結果を使用して、`number_of_processed_rows_` が ServiceNow から取得される予定のナレッジ記事数と一致していることを確認します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-servicenow-knowledge-base.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.