> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/ja/changelog.md). # 変更履歴 {% hint style="success" %} ご希望であれば **KONNEKT の変更履歴における最新の変更とニュースを常に把握しておきたい場合は**、メール更新サービスに登録できます。登録者には **メール通知** が、変更履歴に新しい更新があるたびに送信されます。 [**メール通知に登録するには、こちらをクリックしてください**](https://feedback.konnekt.io/)**.** {% endhint %} ## バージョン ### 2.12.1 (公開 2026-07-15) 修正: * SharePoint のスロットリング: レート制限に達する可能性を低減 * 複数ラベルの public suffix を持つドメインの UPN でログインに失敗 * 無効な tempauth トークンにより、SharePoint Online でファイルのダウンロードに失敗する場合がありました * Windows でプロキシ検出に失敗する場合がありました * 安定性の改善 **ダウンロード** * [KONNEKT 2.12.1.0 Windows X64 64 ビット](https://trial.konnekt.io/releases/Konnekt-X64-2.12.1.0.Msi) * [KONNEKT 2.12.1.0 Windows X86 32 ビット](https://trial.konnekt.io/releases/Konnekt-X86-2.12.1.0.Msi) * [KONNEKT 2.12.1.0 Windows ARM 64 ビット](https://trial.konnekt.io/releases/Konnekt-Arm64-2.12.1.0.Msi) * [KONNEKT ADMX-ADML 2.12.0.0](/ja/configuration/management-options.md#admx-adml-files) ### 2.12.0 (公開 2026-04-08) 追加: * ポリシー [Office 365 の共同編集](/ja/configuration/system-settings/office365-co-authoring.md) Browser で Office Online を使用して Office ファイルを開けるように拡張 修正: * ユーザー UPN にカスタム DNS サブドメインが含まれている場合、SharePoint サイトの検出に失敗することがあります * [管理マッピング](/ja/configuration/mappings/managed-mappings.md) しばらくするとドライブが削除される * 安定性の改善 ### 2.11.4 (公開 2025-12-01) 修正: * 安定性の改善 ### 2.11.3 (公開 2025-09-18) 追加: * 動的スロットリング防止のための Ratelimit ヘッダーの評価 修正: * 安定性の改善 ### 2.11.2 (公開 2025-08-04) 修正: * [管理マッピングによって空のドライブが作成される場合があります](/ja/troubleshooting/causes-of-missing-content/empty-libraries/empty-document-libraries-for-managed-mappings.md) * 安定性の改善 ### 2.11.1 (公開 2025-06-23) 修正: * 安定性の改善 ### 2.11 (公開 2025-05-19) 追加: * 強化 [SharePoint のスロットリング防止](/ja/configuration/system-settings/throttling-prevention.md) を導入することで [時間あたりのリクエスト数に基づくローカル制限（クライアント側スロットリング）](/ja/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md) * 非共同編集シナリオ（例: PDF ファイル）における Microsoft Purview Information Protection（旧称 Microsoft Information Protection MIP）による感度ラベルのサポート * 複数のファイルが Windows File Explorer で同時に開かれる共同編集シナリオでの処理を改善 修正: * ドライブ文字に割り当てられたファイルの名前を変更すると、エラー「ソース ファイルから読み取れません」が発生することがあります * クライアントにネットワーク問題があると、ディレクトリが消えることがあります * ユーザー名にマルチバイト文字（例: 漢字）が含まれていると、アカウント作成に失敗する場合があります * 読み取り専用権限のあるサイト、ライブラリ、ファイルの動作を最適化 * 安定性の改善 ### 2.10.2 (公開 2024-12-12) 追加: * SSO 対応環境向けのサイレント認証 (80) 修正: * プロキシ検出の改善 (9669) * ファイルの移動と名前変更が不安定になることがある (9594) * 安定性の改善 ### 2.10.1 (公開 2024-11-22) 修正: * SharePoint のスロットリング管理を改善 * チェック時の解析エラー `IsSiteReadOnly` 一部の SharePoint サイトで * 一部のドライブから Microsoft Office テンプレート ファイルを開くと、テンプレートから新しいドキュメントを作成するのではなく、テンプレートが開かれてしまう * Shellext.dll がクラッシュの原因になる可能性がある * 安定性の改善 ### 2.10 (公開 2024-08-28) 追加: * オプトインして [新しい OAuth コンポーネント](/ja/configuration/system-settings/enhanced-authentication.md) (EnhancedOAuth) * 新しい Azure アプリ登録 * 必要な権限を減らした新しい権限セット * OAuth 2.0 API ルートを使用 * 名前空間は [デフォルト ドメイン](https://learn.microsoft.com/en-us/microsoft-365/admin/setup/domains-faq?view=o365-worldwide#how-do-i-set-or-change-the-default-domain-in-microsoft-365) (\\\onedrive-\\\...) から作成され、もはや [初期ドメイン](https://learn.microsoft.com/en-us/microsoft-365/admin/setup/domains-faq?view=o365-worldwide#how-do-i-set-or-change-the-default-domain-in-microsoft-365) (\\\onedrive-\\\...) からは作成されません。 * 認証時に Intune DeviceIDs が送信されます * 除外されたアプリを使用している場合、Conditional Access ポリシーで動作します (743) * ファイルとディレクトリのロックおよび読み取り専用チェックを改善 (725) * Windows File Explorer のコンテキストメニューに、Microsoft Office テンプレートを編集用（="open"）の共同編集を追加。(68) 修正: * File Explorer は末尾が空白文字のサイトを処理できない (63) * 互換モードで実行しないと Adobe Acrobat がクラッシュする可能性がある (67) * 新しい Notepad はファイルを保存できない（無効な関数）(8599) * 安定性の改善 ### 2.9.1 (公開 2024-02-15) 追加: * 10 を超える KONNEKT アカウントのサポート 修正: * アカウント削除後にゴースト ボリュームが残る場合がある * KONNEKT アカウントまたは共有が削除されると Explorer がフリーズする * 共有または管理マッピングを追加する際、KONNEKT は名前にドットが含まれるサイトを見つけられない * Windows Update 後の konnektrx.sys タイムアウトにより、Windows Terminal Servers（Windows Server 2019）がフリーズする場合がある * 安定性の改善 ### 2.9.0 (公開 2023-11-16) 追加: * Edge Browser コンポーネント（WebView2）を無効にするポリシー * ARM64 マシン上の x64 プロセスを完全にサポート 修正: * SharePoint のスロットリング: Retry-After ヘッダーの解析問題 * ディスク IO の圧力が高い場合、遅延書き込みデータが失われる可能性がある * ARM64 セットアップで警告が表示される場合がある * ブラウザー コンポーネントのネゴシエーション失敗による灰色のログイン ウィンドウ * 安定性の改善 ### 2.8.0 (公開 2023-10-11) 追加: * CoAuthoring モードで Office テンプレートから新しいドキュメントを作成 (#30) 修正: * のセキュリティ修正 [libcurl CVE-2023-38545 (HIGH) SOCKS5 ヒープ バッファー オーバーフロー](https://curl.se/docs/CVE-2023-38545.html) * のセキュリティ修正 [libcurl CVE-2023-38546 (LOW)](https://curl.se/docs/CVE-2023-38546.html) * デジタル署名がないため konnektUpdate.exe に対してマルウェア警告 (#31) * パスワード リセット後に再認証がトリガーされない (#23) * 再起動を抑制してアンインストールとインストールを行うと、次回の再起動後にドライバーがアンインストール済みのままになる可能性がある (#3855) * キャッシュ TTL が非常に長い場合、SharePoint のマッピングが空として表示されることがある (#6) * 安定性の改善 ### 2.7.2 (公開 2023-09-07) 修正: * 認証ウィンドウに内容が表示されない場合がある * 安定性の改善 ### 2.7.0 (公開 2023-08-10) 追加: * フォルダーに対する「View Online」は、SharePoint の対応するサブフォルダーへ移動する (591) * [管理マッピングはルート サイト URL と Teams URL をサポート](/ja/configuration/mappings/managed-mappings.md#policy-definition) (741) * ログイン プロンプトが Edge Browser をネゴシエートする (791) * OneNote ノートブックのファイル サポート (2730) * OneNote ドキュメントの共同編集 (2730) 修正: * OneDrive で「SharePoint サイトを表示」コンテキスト メニューが壊れている (1509) * ログオフ後に追加したお気に入りが失われる (2894) * 安定性の改善 ### 2.6.0 (公開 2023-07-13) 追加: * [SharePoint Search のエラー/障害を回避](/ja/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty.md) (703) * [ポリシーで Cache TTL の範囲を拡張](/ja/configuration/system-settings/cache-setting.md#cache-ttl-time-to-live) (756) * [ダウンロード ディレクトリを構成するポリシー](/ja/configuration/system-settings/download-directory.md) (792) * .xslb や Office テンプレート ファイルを含む追加のファイル種類に対する共同編集サポート * [新しい Intune ADMX および ADML 管理テンプレートのインポートに対応（パブリック プレビュー）](/ja/configuration/management-options/setting-for-intune-managed-devices.md) (753) * [「Connect drive」ポリシーの新しい構成と動作](https://docs.konnekt.io/ja/pages/6796893fe0d37c36bf0d75c10971689945d614f0#konnekt-2.6.0-and-newer) (753) * 新しいポリシー (754) * [アカウント ウィザードをスキップ](/ja/configuration/system-settings/configure-konnekt-for-a-subset-of-users.md) * [オープン ファイル サイズの制限](/ja/configuration/system-settings/open-file-size-limitations.md) 修正: * 感度/暗号化が有効な一部の Office ファイル（例: XLSB）を開く際のエラー (768) * カーネル ドライバーが modern standby をデッドロックした userland と誤認識する (809) * 単一文字の名前のファイルとフォルダーが検索で問題を引き起こす (866) * 安定性の問題 ### 2.5.8 (公開 2023-06-28) 修正: * SharePoint ライブラリで Copy Link To Clipboard が失敗する (1271) * content-range ディレクティブが SharePoint に無視されると、Konnekt の読み取り操作が失敗する場合がある。 * ドキュメント ライブラリのルートにアクセスしたときにエラーが記録される * ファイルのロック/チェックアウト確認でログに解析エラーが発生する * 安定性の問題 ### 2.5.7 (公開 2023-05-30) 修正: アクセス トークンを取得できない場合、アプリがクラッシュすることがある ### 2.5.6 (公開 2023-05-25) 修正: SSO ログイン試行中にアプリがクラッシュすることがある (1046) ### 2.5.4 (公開 2023-05-16) 修正: * HTTP/2 多重化のネゴシエーションを試みる際の応答時間が遅い (836) * ポリシー「Add all SharePoint libraries」が無効の場合、管理マッピングで空のドライブが表示される (932) ### 2.5.2 (公開 2023-05-11) 修正: * ボリュームの空きサイズと合計サイズが正しくない (896) * 安定性の問題 ### 2.5.1 (公開 2023-05-10) 修正: 無効なアカウント トークンが問題を引き起こす可能性がある (895) ### 2.5.0 (公開 2023-05-08) * 追加 * 更新された API の処理 * のサポート [SharePoint ドメイン名変更](https://learn.microsoft.com/en-us/sharepoint/change-your-sharepoint-domain-name) (765) * カスタム/バニティ SharePoint ドメイン名のサポート (780) * [Multi-Geo サポート ](/ja/configuration/mappings/multi-geo.md)は常に有効です。もう専用の設定は不要です。 * 修正 * Konnekt 共有内にある MSI ファイルをインストールできない (748) * 末尾がドットの名前のサイトにアクセスできない (761) * 感度/暗号化が有効な場合、.XLSB ファイルを開けない (768) * ライブラリ内のフォルダー移動が数秒後に逆になる (775) {% hint style="info" %} KONNEKT のバージョン番号 2.3 と 2.4 は、大規模なコード再構築のためスキップされました。 {% endhint %} ### 2.2.1（2022-12-30 - KONNEKT 2.2.0 のバグ修正版） * 修正 * SharePoint ルートで新しいフォルダーを作成すると Explorer が応答しなくなる場合がある - パート 2 (648) * 削除したフォルダーが一部のシナリオで再表示される場合がある (738) * マシン再起動後、管理マッピングが動作しないことがある (763) * バージョン 2.2.0 のライセンス確認の問題 (766) #### ダウンロード {% file src="/files/cf21e8cad7382a0063efeea30cedf8c5faae197b" %} KONNEKT 2.2.1.0（64 ビット、32 ビット、Arm64 版があります） {% endfile %} ### 2.2.0 (公開 2022-11-17) * 追加 * [ARM64 プロセッサ プラットフォームのサポート ](/ja/installation/system-requirements.md#processor-platform)(662) * [SharePoint Throttling Prevention ポリシー](/ja/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md) (730) * [管理マッピングのお気に入りに追加](/ja/configuration/mappings/managed-mappings.md#make-mapping-a-konnekt-favorite) (733) * Microsoft SharePoint Online REST API のパフォーマンス低下を回避するため、フォルダー参照の検索戦略を変更 (736) * 修正 * SharePoint ルートで新しいフォルダーを作成すると Explorer が応答しなくなる場合がある - パート 1 (648) * 再インストールまたはアンインストール後に「このファイルは存在しません」と表示される (649) * 既存ファイルの部分文字列など特殊な条件で、新しいファイルの保存が機能しない (651) * 一部の環境でドライバー更新中のブルー スクリーンを防止 (672) * 一部のエントリで履歴の UNC にあるバックスラッシュが 1 つ不足する (721) * 削除したフォルダーが一部のシナリオで再表示される場合がある (738) ### 2.1.1 (公開 2022-07-05) * 修正: マシン ポリシーが正しく適用されない場合がある ### 2.1.0 (公開 2022-05-12) * 追加 * OneDrive と SharePoint Online の Multi-Geo サポート * 高負荷環境向けの改善 * 1 サイトあたり 192 ライブラリの制限を削除 * ログ レベル ポリシー * 修正 * タスクバーのピン留めリンクが UNC ではなく SPO サイトを開く * の CoAuthoring 設定 [ADMX](/ja/configuration/management-options/settings-via-gpo.md#admx-file) 動作しない * 一部の RDS 環境でのセットアップ中のインストーラー コーディネーターの問題 * 一部の環境で休止後に望ましくないポリシー変更が発生する * GPO/Intune ポリシーを適用した後も「Enable Sharepoint Sites」オプションがグレーアウトしない。 * SharePoint Online からのエラー応答の処理により空のフォルダーが発生する * 「Add site favorite」機能 ### 2.0.0 (公開 2021-12-03) * 追加 * explorer UI をカスタマイズ ([いくつかのオプションを非表示にする](/ja/configuration/gui-behavior/konnekt-explorer-ui.md), [トレイ アイコンを非表示にする](/ja/configuration/gui-behavior/hide-tray-icon.md)) * カスタム サイト範囲 ([個別の検索文字列](/ja/configuration/mappings/auto-mapping.md)) * 自動マッピング ([管理マッピング](/ja/configuration/mappings/managed-mappings.md)) * [キャッシュ設定](/ja/configuration/system-settings/cache-setting.md) （SharePoint Online への個別の書き込み処理、例: VDI 環境） * [Intune 管理](/ja/configuration/management-options/setting-for-intune-managed-devices-1.md) * 特定のファイル種類で explorer のプレビューを有効にするための Offline Attribute Filter * [ADMX と ADML ファイル ](/ja/configuration/management-options/settings-via-gpo.md#admx-file)新しいポリシーと構造を取得 * 修正 * マッピングされたドライブを解決する際の壊れたファイルリンク（例: Outlook でパスをコピー） * 1 GB を超えるファイルのアップロード時の安定性問題 * キャッシュ ディレクトリがいっぱいになる可能性がある * SharePoint のドキュメント ライブラリが空として表示される場合がある ### 1.20.0 (公開 2021-04-21) * 追加: 高度な SharePoint スロットル処理 * 修正: 同じテナント内の複数アカウントの処理 * 修正: 書き込み負荷下での安定性の問題 ### 1.19.0 (公開 2021-04-06) * 追加: 共有を追加するダイアログを改善 * 修正: アップグレード後に Konnekt がドライバーに到達できない * 修正: 休止後に Konnekt を再起動する必要がある ### 1.18.0 (公開 2021-02-10) * 追加: SSO フローを改善 * 修正: SharePoint トークンが期限切れになる可能性がある * 修正: ネットワーク接続の変更時にプロキシ設定が再評価されない * 修正: プロファイル パスにウムラウトが含まれている場合のパスの問題 ### 1.16.0 (公開 2020-10-22) * 修正: Azure AD に参加したクライアントで外部テナントにアクセスできない * 追加: 再認証の頻度を減らす ### 1.15.1 (公開 2020-09-24) * 修正: 移動/コピー操作中に Explorer が応答しなくなる * 修正: お気に入りを追加または削除できない ### 1.15.0 (公開 2020-09-03) * 修正: Google Chrome から PDF として保存できない ### 1.14.1 (公開 2020-07-25) * 修正: 手動で追加した共有は常に既定のドキュメント ライブラリを開く ### 1.14.0 (公開 2019-05-14) * 修正: いくつかの Adobe 製品で PDF ファイルを保存できない * 追加: Teams からプライベート チャネルを手動で追加 ### 1.12.6 (公開 2019-04-20) * 修正: ログインの問題 ### 1.12.4 (公開 2019-02-26) * 修正: ワイルドカード マッチング ### 1.12.3 (公開 2019-12-19) * 修正: アカウントを作成できない（キーが見つからない） * 修正: SharePoint リンク スコープ ポリシー * 修正: ライセンス ポリシーの順序 ### 1.12.0 (公開 2019-11-18) * 追加: 追加の SharePoint ドキュメント ライブラリの処理を改善 * 追加: 個人用 OneDrive ボリュームのドライブ文字を設定 * 追加: SharePoint リンク スコープを設定（既定、組織、匿名、無効） * 修正: SharePoint のサブグループのグルーピングが誤っている ### 1.10.1 (公開 2019-09-02) * 追加: アップロード エラーの視覚化を改善 * 修正: アップロード エラーが発生するとシェル拡張が共有を表示しない ### 1.10.0 (公開 2019-08-30) * 追加: エクスプローラーの左側に表示されている場合、共有名にアカウント エンドポイントを追加 * 修正: Windows Explorer の二重メニュー * 修正: ドイツ語でアカウントのコンテキスト メニューが完全に表示されない * 修正: カーネル ドライバーのクラッシュ ### 1.9.0 (公開 2019-04-17) * 追加: 古い Office ファイル形式向けの Office 共同編集サポート * 追加: 追加の SharePoint ドキュメント ライブラリを共有として追加 * 追加: 手動で追加した共有を削除するオプション * 追加: Windows Explorer で「Konnekt」の名前を変更するポリシー * 追加: OneDrive の「Personal」を「OneDrive」に変更 * 追加: OneDrive の個人用フォルダー名を設定するレジストリ設定 ### 1.8.2 (公開 2019-04-02) * 追加: ドイツ語ローカライズ * 追加: ボリューム更新中にメッセージを表示 * 修正: Adobe Acrobat と Acrobat Reader で PDF ファイルを開けない ### 1.8.0 (公開 2019-02-20) * 追加: FILE\_ATTRIBUTE\_OFFLINE を無効にするポリシー * 修正: ターミナル サーバーでの起動時のパフォーマンスを改善 * 修正: ユーザーが再作成された場合、Office 共同編集が個人用 OneDrive で誤った URL を開く (#366) * 修正: 共同編集がマップされたネットワーク ドライブで動作しない * 修正: 共同編集がマクロ有効の Excel ファイルで動作しない (#360) * 修正: ドイツ語クラウド向けのアカウント追加エントリを削除 (#342) * 修正: 起動時の競合状態 * 修正: ドライバーが Windows 7 x64 で動作しない * 修正: ロギングを改善 ### 1.7.4 (公開 2018-11-23) * 修正: シェル拡張で利用可能なサイトを閲覧中にターミナル サービスでパフォーマンスが低下する (#304) * 修正: Excel マクロ有効ファイル使用時に共同編集が動作しない (#360) ### 1.7.1 (公開 2018-10-18) * 修正: MS Office アプリケーションによる TMP ファイル作成 (#336) * 修正: UNC パスから PDF ファイルを開けない (#340) ### 1.7.0 (公開 2018-09-27) * 追加: プロキシ認証サポートを改善 * 修正: MS Office アプリケーションによる TMP ファイル作成 (#336) * 修正: ファイル名のワイルドカード一致を改善 * 修正: エラー状態のアカウントを削除できない * 修正: UNC パスから PDF ファイルを開けない (#340) * 修正: 設定で「Enable SharePoint sites」がグレーアウトしている (#347) * 修正: カーネル ドライバーのクラッシュ ### 1.6.0 (公開 2018-06-15) * 修正: 個人用 OneDrive が Konnekt の外部で変更されても更新されない * 修正: 名前変更操作を改善 * 修正: 削除中の競合状態を修正 ### 1.5.0 (公開 2018-06-05) * 追加: 既定のドキュメント ライブラリがない SharePoint サイトをサポート * 追加: OneDrive プロバイダーを改善 * 追加: 既定のログ レベルを INFO に設定 * 修正: 名前変更操作中の競合状態 * 修正: 起動時のクラッシュ ### 1.4.15 (公開 2018-05-14) * 追加: 評価版では既定で SharePoint サイトを有効化 * 修正: Windows Server 2008 でセットアップに失敗する ### 1.4.10 (公開 2018-05-02) * 修正: Konnekt が 0 バイト ファイルを作成する * 修正: OneDrive プロバイダーで潜在的なデッドロック * 修正: 更新ウィンドウが DPI 対応でない ### 1.4.4 (公開 2018-04-09) * 修正: バージョン番号をクリックした後も更新ウィンドウが閉じない * 修正: Acrobat Reader で複数の PDF ファイルを開けない ### 1.4.2 (公開 2018-03-05) * 修正: ローカライズされた SharePoint サイトのコンテキストメニュー ### 1.4.1 (2018-02-16 公開) * 修正: Office の共同編集で、UPN にマイナス文字が含まれていると URL を開けない ### 1.4.0 (2018-01-30 公開) * 追加: ターミナルサーバーでの起動を高速化 * 追加: SharePoint ボリュームの処理を改善 * 追加: 共同編集のグループポリシー設定 ### 1.3.3 (2017-12-19 公開) * 修正: 競合状態 (#303) ### 1.3.2 (2017-12-08 公開) * 修正: Konnekt-UNC パスで Acrobat Reader が動作しない (#216) * 修正: Windows 10 Anniversary Update の Konnekt-UNC パスに Outlook の添付ファイルを保存できない (#301, #302) ### 1.3.0 (2017-11-06 公開) * 追加: 非公開の SharePoint グループを表示 ### 1.2.4 (2017-09-13 公開) * 修正: 自動更新中のクラッシュ ### 1.2.0 (2017-09-08 公開) * 修正: アカウント追加後にクラッシュする * 修正: 開いているファイルの名前を変更 ### 1.1.0 (2017-08-25 公開) * 追加: 設定ダイアログ * 追加: エクスプローラーの左側に、お気に入りと個人用の共有を表示 * 追加: Chromium Embedded Framework を削除し、MSHTML を採用 * 追加: コンピューターが Azure AD に参加している場合、初回起動時にアカウントを自動作成する * 追加: 最初の個人用ボリュームを H: ドライブに接続する設定 * 修正: SharePoint サイト名に特殊文字が含まれているとアクセスできない (#258) * 修正: Konnekt で OneNote ファイルを開けない (#261) * 修正: フォルダー名変更後に内容が表示されない (#255) * 修正: プロキシ使用時に O365 アカウントを追加できない ### 1.0.2 (2017-05-17 公開) * 追加: ライセンスキー管理 * 追加: クラッシュダンプでより多くの情報を収集 ### 1.0.1 (2017-05-15 公開) * 修正: MS Edge を使用して Web サイトから SharePoint サイトにドキュメントを保存できない ### 1.0.0 (2017-05-12 公開) * 修正: ファイルが含まれている場合にディレクトリを削除できない --- # 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.konnekt.io/ja/changelog.md?ask=&goal= ``` `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.