> 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/user-guide/administration/account-management/roles/view-domain.md).

# ドメインを表示

大規模な組織は通常、さまざまな国や地域に子会社を持ち、複雑な内部構造を持っています。 さらに複雑さを加えるのは、さまざまなITチームによってサポートされる多数の部門に分かれていることです。 法的、コンプライアンス、またはセキュリティ上の理由であれ、ITチームがデバイスと関連イベントのデータに対する明確な視界を持つことは便利です。

ビュードメインは、Nexthinkユーザーの役割でそのような視界を定義できる手段を提供します。

ビュードメイン機能：

* データへのアクセスが必要最小限の情報に基づいていることを保証するコンプライアンスルールを施行します。
* ITチームが担当外のデバイスに対してアクションを実行するのを防ぐことで、セキュリティを強化します。

## 設定 <a href="#viewdomain-configuration" id="viewdomain-configuration"></a>

### 組織の定義 <a href="#viewdomain-definingorganization" id="viewdomain-definingorganization"></a>

役割でビュードメインを定義する前に、デバイスと組織構造との関係を定義する必要があります。 デバイスをエンティティと、必要に応じて1つまたは複数のカスタム分類と、**製品構成**の**デバイス組織**機能で定義されたルールを使用して関連付ける必要があります。 詳細については、[Product configuration](/platform/ja/user-guide/administration/system-configuration/product-configuration.md)ドキュメントを参照してください。

{% hint style="info" %}
**組織** が設定されていない限り、システムはイベントにエンティティまたはカスタム分類をタグ付けしません。
{% endhint %}

### ビュードメインの設定 <a href="#viewdomain-configuringviewdomain" id="viewdomain-configuringviewdomain"></a>

ビュードメインを設定するには：

* メインメニューから **Administration** を選択します。
* ナビゲーションパネルのアカウント管理セクションで **Roles** をクリックします。
* **ビュードメイン** セクションまでスクロールして、次のオプションのいずれかを選択します：
  * **フルアクセス**：役割はすべてのデバイスにアクセスできます。
  * **制限付きアクセス**：選択した組織レベルに基づいて、役割がアクセスできるデバイスの範囲を限定できます。

### **制限付きアクセス**

**制限付きアクセス** を選択した場合、組織レベルとそれに対応する視界範囲を指定できます。 各範囲は、役割内のユーザーが表示できるデバイスのサブセットを決定します。

ビュードメインを定義するには、ドロップダウンメニューから **組織レベル** を選択します。 利用可能なオプションは次のとおりです：

* **エンティティ**: エンティティのみを追加することを有効にする選択。
* **カスタム分類**: 選択されたカスタム分類に関連する可能性のあるカスタム分類値のみを追加することを有効にする選択。 (カスタム分類ルールセットで定義された任意のカスタム分類を追加できます)。

{% hint style="info" %}
時間が経つとともに、カスタム分類、カスタム分類値、エンティティを削除できます。 既存の役割は削除されたアイテムを指すことがあります。 この場合、役割を保存することはできません。
{% endhint %}

メインロールで複数の組織ディメンションを組み合わせたビュードメインの範囲を定義できます。これにより、組織が実際にどのように機能するかに応じて視界範囲を一致させることができます。例えば、**地域**、**エンティティ**、または**部門**による可視性を同じ役割に組み合わせることができます。

例えば、次の2つの視界範囲を持つ **制限付きアクセス** があります。

* **地域:** ヨーロッパ
* **部門:** 財務

これは、ヨーロッパ内のすべてのデバイスと財務部門内のすべてのデバイスへのアクセスが含まれることを意味します。 これはヨーロッパ内のみの財務デバイスへの視界を制限しません。

役割に対して制限付きアクセスを選択した場合、役割がアクセスできるデバイスの範囲をリストアップします。 制限付きアクセスのある役割は、特定のエンティティまたはカスタム分類でタグ付けされたデバイスとその関連イベントにのみアクセスできます。

<figure><img src="/files/Su2eBWXBCb5LI8EzpuI0" alt="View domain diagram" width="760"><figcaption></figcaption></figure>

### **エンティティとカスタム分類**

* カスタム分類でデバイスにオプションのタグを付けることは、**組織** ルールセットファイルに依存します。
* 各カスタム分類値は、必ず1つ以上のエンティティに関連付けられます。 例えば、次の表では、**スイス** と **ヨーロッパ** が **ローザンヌ** と **チューリッヒ** に関連付けられています。
* エンティティは、同じカスタム分類の異なる値を持つ複数の関連付けを持つことはできません。 例えば、**ローザンヌ** が **ヨーロッパ** と **北米** の両方に関連付けられるのは不適切です。

| エンティティ | カスタム分類 - 国 | カスタム分類 - 地域 |
| ------ | ---------- | ----------- |
| ローザンヌ  | スイス        | ヨーロッパ       |
| チューリッヒ | スイス        | ヨーロッパ       |
| ニューヨーク | アメリカ合衆国    | 北米          |

## ビュードメインの使用 <a href="#viewdomain-usingviewdomain" id="viewdomain-usingviewdomain"></a>

### オブジェクトとイベント <a href="#viewdomain-objectsandevents" id="viewdomain-objectsandevents"></a>

システムは以下のオブジェクトとイベントに対してビュードメインを強制します：

#### **デバイス**

`devices` オブジェクトを照会する際、システムはデバイスのエンティティを使用してビュードメインを適用します。 `Organization.Entity` フィールドを使用してデバイスのエンティティを取得します。 これは旧 **エンティティ** フィールドでも表示されます。

#### **ユーザー**

`users` オブジェクトを照会する際、システムはユーザーが報告されたデバイスのエンティティを使用します。例えば、セッションイベントやユーザーにリンクされた実行イベントなどです。 役割は、ユーザーに関連付けられた少なくとも1つのデバイスのエンティティにアクセスできる必要があります。

#### **すべてのイベント**

{% hint style="info" %}
`dex.scores`は、ドメインの表示に完全なアクセス権を持つ役割に対してのみ表示されます。
{% endhint %}

イベントの時点でのデバイスのエンティティを示す`context.organization.entity`フィールドを使用してエンティティを取得します。 次を考慮してください:

* デバイスのエンティティが変更されると、その変更前にトリガーされたイベントのエンティティはそのまま残ります。 制限付きの表示ドメインアクセスを持ち、古いエンティティのみに割り当てられた役割は、デバイスの新しいエンティティに関連付けられたイベントを表示できません。
* `events`を照会するとき、システムはイベントのエンティティを使用して表示ドメインを強制します。
* 同じクエリで`devices`と`events`を照会する場合、ユーザーはデバイスのエンティティとイベントのエンティティにアクセスできます。例えば：

{% code lineNumbers="true" %}

```
device_performance.system_crashes during past 7d 
| list number_of_system_crashes, context.organization.entity 
```

{% endcode %}

一部のイベントには、デバイスにリンクできないためエンティティがない場合があります。 これには、特定のアラートやコラボレーションイベントが含まれる可能性があります。 イベントが特別な**n/a**エンティティでタグ付けされている場合、関連するユーザーのエンティティ（もしあれば）が表示ドメインを強制します。 デバイスまたはユーザーが存在せず、エンティティが**n/a**でタグ付けされている場合、すべてのユーザーがイベントを表示できます。 この状況は、すべてのユーザーに表示されるバイナリやパッケージのようなオブジェクトに関する一部のアラートで発生する可能性があります。

#### **デバイスにリンクされたすべてのインベントリオブジェクト**

`device.antiviruses`、`device.cpus`、`device.disks`および同様のオブジェクトなどのインベントリオブジェクトをクエリするとき、システムはデバイスのエンティティを使用して表示ドメインを強制します。

{% hint style="info" %}
表示ドメインへのアクセスが制限された役割を持つユーザーは、すべての`binaries`および`packages`を一覧表示できます。 ただし、これらのオブジェクト上でドリルダウンを行って、表示ドメインに属さないデバイスやイベントに関する情報を取得することはできません。
{% endhint %}

### 製品モジュール <a href="#viewdomain-productmodules" id="viewdomain-productmodules"></a>

表示ドメインは次のモジュールに適用されます:

#### 管理

| 権限                 | フルアクセス                                                              | 制限付きアクセス                                                            |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| 管理者権限              | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| データ管理              | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| すべてのカスタムフィールドを管理   | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| すべてのカスタムトレンドデータを管理 | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| すべてのNQL APIクエリを管理  | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| すべての評価を管理          | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| コレクターを管理           | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| 手動カスタムフィールドを編集     | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |

#### アプリケーション

| 権限                     | フルアクセス                                                              | 制限付きアクセス                                                            |
| ---------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのアプリケーションを管理        | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |                                                                     |
| すべてのアプリケーションダッシュボードを表示 | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |

#### アラート

| 権限                 | フルアクセス                                                              | 制限付きアクセス                                                            |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのアラートを管理        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |                                                                     |
| すべてのアラートダッシュボードを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### Amplify

| 権限                          | フルアクセス                                                              | 制限付きアクセス                                                            |
| --------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| Amplifyを管理                  | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |                                                                     |
| Amplifyを表示                  | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| Amplifyにインストールされているパッケージを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| チェックリストを見る                  | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| ワークフローを実行                   | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| リモートアクションを実行                | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### キャンペーン

<table><thead><tr><th width="249">パーミッション</th><th>フルアクセス</th><th>制限付きアクセス</th></tr></thead><tbody><tr><td>すべてのキャンペーンを管理</td><td><img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"></td><td></td></tr><tr><td>すべての手動キャンペーンを管理</td><td></td><td><img src="/files/BSE3bCTL5HwohWYaMkks" alt="" data-size="original"></td></tr><tr><td>すべての手動キャンペーンをトリガー</td><td><img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"></td><td><img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"></td></tr><tr><td>すべてのキャンペーンダッシュボードを表示</td><td><img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"></td><td><img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"></td></tr></tbody></table>

{% hint style="info" %}
キャンペーンのターゲティングはユーザーの閲覧ドメインに制限されたままです。 ユーザーは、自身の閲覧ドメインで定義された範囲外の従業員をターゲットにすることはできません。 閲覧ドメインが制限されたユーザーが非手動トリガーを使用するキャンペーンを開くと、そのキャンペーンは読み取り専用モードで表示されます。
{% endhint %}

#### コラボレーションツール

| 権限                        | フルアクセス                                                              | 制限付きアクセス                                                            |
| ------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのコラボレーションツールドッシュボードを見る | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### 診断

| 能力                               | フルアクセス                                                              | 制限付きアクセス                                                            |
| -------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのチェックリストを管理                   | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| Amplifyを管理（Amplifyのアドオンライセンスが必要） | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| すべてのチェックリストを表示                   | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| Amplifyを表示（Amplifyのアドオンライセンスが必要） | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| デバイスビューを表示                       | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| 診断ダッシュボードを表示する                   | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| Amplifyにインストールされたパッケージを表示        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |

#### デジタルエクスペリエンス

| 権限                     | フルアクセス                                                              | 制限付きアクセス |
| ---------------------- | ------------------------------------------------------------------- | -------- |
| デジタル体験のスコアを管理          | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |          |
| デジタルエクスペリエンスダッシュボードを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |          |

#### 調査

| 権限                                                                                                                                           | フルアクセス                                                              | 制限付きアクセス                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| プライベート調査を作成する; グローバル検索を使用する                                                                                                                  | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| 共有調査を管理                                                                                                                                      | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |
| プライベート調査を共有                                                                                                                                  | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |
| Nexthinkアシストを見る（当[更新されたデータプロセッサ](https://docs.nexthink.com/platform/ja/legal/global-privacy-hub/nexthink-data-processing-schedule)に明示的に同意する） | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |
| 共有調査を表示                                                                                                                                      | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/oBoJgQJq8QyX0j9snaia" alt="" data-size="original"> |

#### ライブダッシュボード

| 権限             | フルアクセス                                                              | 制限付きアクセス                                                            |
| -------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのダッシュボードを管理 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |                                                                     |
| すべてのダッシュボードを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### デバイスビュー

| 権限         | フルアクセス                                                              | 制限付きアクセス                                                            |
| ---------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| デバイスビューを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### リモートアクション

| 権限                      | フルアクセス                                                              | 制限付きアクセス                                                            |
| ----------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのリモートアクションを実行        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| すべてのリモートアクションを管理        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |                                                                     |
| すべてのリモートアクションダッシュボードを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### ソフトウェアメータリング

| 権限                         | フルアクセス                                                              | 制限付きアクセス                                                            |
| -------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのソフトウェアメータリングを管理        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| すべてのソフトウェアメータリングダッシュボードを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

#### スパーク

| 権限                             | フルアクセス                                                              | 制限付きアクセス                                                            |
| ------------------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| エージェント概要ダッシュボードを表示             | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| すべてのエージェントとの会話を表示              | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| インフィニティを通じてエージェントとチャットする       |                                                                     |                                                                     |
| Infinity を通じて別のユーザーの代わりにチャットする |                                                                     |                                                                     |
| すべてのエージェントのアクションを管理            | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| エージェントの知識ソースを管理                |                                                                     |                                                                     |
| エージェントの設定を管理                   |                                                                     |                                                                     |

#### ワークフロー

| パーミッション              | フルアクセス                                                              | 限定アクセス                                                              |
| -------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| すべてのワークフローを実行        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |
| すべてのワークフローを管理        | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |                                                                     |
| すべてのワークフローダッシュボードを表示 | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> | <img src="/files/vo1xoLU5FTla2jpPXX6G" alt="" data-size="original"> |

権限テーブルは各モジュールページにあります。

表示ドメインを役割に適用する場合、システムは権限レベルで一部のモジュールへのアクセスを削除します。 次のモジュールは、フルビューのドメインアクセスを持つロールで利用可能です。

* デジタル体験

制限付きの表示ドメインアクセスを持つ役割は、調査や表示ドメインが正しく強制されているライブダッシュボードで、たとえば`alert.alerts`や`campaign.responses`などを使用して、前述のモジュールにリンクされたデータを取得できます。

表示ドメインに完全なアクセス権を持つ役割にのみ関連付けることができる権利のリスト：

| 機能             | 機能権限                   | コンテンツ権限（共有） |
| -------------- | ---------------------- | ----------- |
| アラート           | すべてのアラートを管理            | 編集          |
| \[アプリケーション]    | すべてのアプリケーションを管理        | *-*         |
| カスタムフィールド      | すべてのカスタムフィールドを管理       | *-*         |
| キャンペーン         | すべてのキャンペーンを管理          | 編集          |
| ワークフロー         | すべてのワークフローを管理          | 編集          |
| ワークフロー         | すべてのワークフローを実行          | 実行          |
| デジタル体験         | デジタル体験のスコアを管理          | *-*         |
| デジタル体験         | デジタルエクスペリエンスダッシュボードを表示 | *-*         |
| データエクスポート      | 管理者権限                  | *-*         |
| NQL            | すべてのNQL APIクエリを管理      | *-*         |
| Remote Actions | すべてのリモートアクションを管理       | 編集          |
| 管理             | *すべての管理機能（Packs管理含む）*  | *-*         |

***

関連トピック:

* [製品構成](/platform/ja/user-guide/administration/system-configuration/product-configuration.md)
* [ロール](https://docs.nexthink.com/platform/ja/configuring_nexthink/configuring-your-platform/administration/account-management/roles/)


---

# 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/user-guide/administration/account-management/roles/view-domain.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.
