> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ja/fen-ye-bie/02-chemistry-formulae.md). # 化学式 この記事では、化学コンテンツの組版と文書化のために設計された 2 つの LaTeX パッケージを紹介します: * [chemfig](https://www.ctan.org/pkg/chemfig): 〜するためのパッケージ [分子の構造式を描画する](#using-chemfig-to-draw-molecules-structural-formulae) * [mhchem](https://ctan.org/pkg/mhchem): 〜するためのパッケージ [化学式や化学方程式を組版する](#using-mhchem-to-typeset-chemical-formulae-and-equations) ## chemfig を使って分子（構造式）を描く 分子を描くには、主に原子の समूहを線でつなぎます。単純な直線状の式は、次の例に示すように `chemfig` パッケージを使って簡単に描けます: ```latex \documentclass{article} \usepackage{chemfig} \begin{document} \section{はじめに} chemfig で化学式を書くのは簡単です。 \chemfig{A=B} \end{document} ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+1\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Csection%7BIntroduction%7D%0AWriting+chemical+formulae+with+chemfig+is+straightforward.%0A%0A%5Cchemfig%7BA%3DB%7D%0A%5Cend%7Bdocument%7D) 次の画像は、上の例で生成された出力を示しています。 ![chemfig の基本例](/files/9c248db562797e2ba3bb3b25581583e4656b4ffe) このパッケージは `\usepackage{chemfig}` で導入します。コマンド `\chemfig{A=B}` が分子を描画します。記号 `=` は結合の種類を決定します。 [リファレンスガイド](#reference-guide) 結合の種類一覧については ### 角度 分子内の結合間の角度を定義する方法はいくつかあります。 ```latex 化学式を定義するには、角度を定義する単位を使えます \chemfig{A-[1]B-[7]C} 絶対角 \chemfig{A-[:50]B-[:-25]C} 相対角 \chemfig{A-[::50]B-[::-25]C} ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+2\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ATo+define+chemical+formulae+you+can+use+units+that+define+the+angles%0A%0A%5Cchemfig%7BA-%5B1%5DB-%5B7%5DC%7D%0A%0AAbsolute+angles%0A%0A%5Cchemfig%7BA-%5B%3A50%5DB-%5B%3A-25%5DC%7D%0A%0ARelative+angles%0A%0A%5Cchemfig%7BA-%5B%3A%3A50%5DB-%5B%3A%3A-25%5DC%7D%0A%5Cend%7Bdocument%7D) 次の画像は、上の例で生成された出力を示しています。 ![Chemfig2OLV2.png](/files/1b3bcda160258ef8e9da0b129f327b932dcb0d20) 上の例にある 3 つのコマンドはそれぞれ、結合間の角度を決定する異なる方法を使っています。 * `デフォルト単位`: コマンド `\chemfig{A-[1]B-[7]C}` では、角括弧内のパラメータが特別な単位で角度を設定します。各単位は 45° に相当します。したがって、この例では角度は 45° と 315° です。 * `絶対単位`: 角度は絶対単位で設定できます。コマンド `\chemfig{A-[:50]B-[:-25]C}` では、角括弧内のパラメータが水平基準線から測った角度を度数で表します。負の角度も使えます。 * `相対角`: 3 つ目の例では `\chemfig{A-[::50]B-[::-25]C}` 角度は基準線ではなく、前の結合から測られます。 ### 環 次の例では、正多角形を描く構文を示します: ```latex 正多角形: \chemfig{A*5(-B=C-D-E=)} 不完全な環も可能です: \chemfig{A*5(-B=C-D)} ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ARegular+polygons%3A%0A%0A%5Cchemfig%7BA%2A5%28-B%3DC-D-E%3D%29%7D%0A%0AIncomplete+rings+are+also+possible%3A%0A%0A%5Cchemfig%7BA%2A5%28-B%3DC-D%29%7D%0A%5Cend%7Bdocument%7D) 次の画像は、上の例で生成された出力を示しています。 ![Chemfig3OLV2.png](/files/bc1f8301f963431e58c03c73944978a832e275b9) コマンドの構文 `\chemfig{A*5(-B=C-D-E=)}` は以下で説明します: * `1つの`: これは最初の原子で、残りの原子はここから描画されます * `*5`: 多角形の辺の数 * `(-B=C-D-E=)`: 残りの原子と結合。不足していて多角形を完成できない場合は、不完全な環が描画されます。 このコマンドには、追加で渡せるパラメータがあります: ダブルアスタリスクです。たとえば、 `**5` の代わりに `*5` を指定すると、多角形の内側に円が描かれます。 #### 接続した環 次の例ではカフェインの化学構造を描画します: ```latex \documentclass{article} \usepackage{chemfig} \begin{document} \section{I need caffeine.} \chemfig{*6((=O)-N(-)-(*5(-N=-N(-)-))=-(=O)-N(-)-)} \end{document} ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Drawing+caffeine+using+chemfig\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BI+need+caffeine.%7D%0A%0A%5Cchemfig%7B%2A6%28%28%3DO%29-N%28-%29-%28%2A5%28-N%3D-N%28-%29-%29%29%3D-%28%3DO%29-N%28-%29-%29%7D%0A%5Cend%7Bdocument%7D) 次の図は、カフェインの例で生成される出力を示しています: ![chemfig LaTeX パッケージを使用して生成したカフェイン分子の図](/files/d22d415d5c9eae826b5fe3f9f114c9294cb4e90f) ### 枝分かれ 化学式は必ずしも直線状ではなく、実際には枝分かれした式が最も一般的です。以下に、その作成例を示します。 ```latex 分岐した分子 \vspace{.5cm} \chemfig{H-C(-[2]H)(-[6]H)-C(=[1]O)-[7]H} ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+4\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ABranched+molecule+%5Cvspace%7B.5cm%7D%0A%0A%5Cchemfig%7BH-C%28-%5B2%5DH%29%28-%5B6%5DH%29-C%28%3D%5B1%5DO%29-%5B7%5DH%7D%0A%5Cend%7Bdocument%7D) 次の画像は、上の例で生成された出力を示しています。 ![Chemfig4OLV2.png](/files/63cf2372f09b47f1684442796be14ad5dd4e95e9) 各ノードの分岐は、括弧内に式を追加することで作成します。たとえば、コード ```latex C(-[2]H)(-[6]H) ``` は「C」に 2 つの分岐を作成し、1 つは 2 単位角（90°）、もう 1 つは 6 単位角（270°）になります。 環にも分岐を追加できます: ```latex 分岐した環 \vspace{.5cm} \chemfig{A*6(-B=C(-CH_3)-D-E-F(=G)=)} ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+5\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ABranched+ring%0A%5Cvspace%7B.5cm%7D%0A%0A%5Cchemfig%7BA%2A6%28-B%3DC%28-CH_3%29-D-E-F%28%3DG%29%3D%29%7D%0A%5Cend%7Bdocument%7D) 次の画像は、上の例で生成された出力を示しています。 ![Chemfig5OLV2.png](/files/318987eb613cf2181a70dfcf0f9f4e15b81d681f) 構文は似ており、括弧を使って分岐をノード（原子）に接続できます。たとえば ```latex F(=G) ``` は「F」というノードに分岐を接続します。より複雑な例は、入れ子の分岐を使ったり、環を分岐として接続したりして作成できます。 ### 式のカスタマイズ 色やノード間隔など、いくつかのパラメータを変更でき、式を説明する追加テキストも加えられます。 ```latex {\huge \setchemfig{atom sep=2em,bond style={line width=1pt,red,dash pattern=on 2pt off 2pt}} \chemname {\chemfig{H-C(-[2]H)(-[6]H)-C(=[1]O)-[7]H}} {アセトアルデヒド} } ``` [これを開く `chemfig` Overleafでの例](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+6\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0A%7B%5Chuge+%0A++++%5Csetchemfig%7Batom+sep%3D2em%2Cbond+style%3D%7Bline+width%3D1pt%2Cred%2Cdash+pattern%3Don+2pt+off+2pt%7D%7D++%0A++++%5Cchemname%0A++++%7B%5Cchemfig%7BH-C%28-%5B2%5DH%29%28-%5B6%5DH%29-C%28%3D%5B1%5DO%29-%5B7%5DH%7D%7D++++%0A++++%7BAcetaldehyde%7D%0A%7D%0A%5Cend%7Bdocument%7D) 次の画像は、上の例で生成された出力を示しています。 ![chemfig パッケージを使って LaTeX でアセトアルデヒドを描画](/files/e0ce29214bbf00052f8716bb935696cdea01d676) ここには 2 つの新しいコマンドがあります: * `\setchemfig{}`: このコマンドは、化学構造を描画するための設定を行うのに使います。 * `\chem``name{}{}` : このコマンドの最初の引数は `chemfig` 化学式で、2 つ目は化学式の下に表示されるテキストです。例では、そのテキストは「アセトアルデヒド」です。 使用されているフォントが `huge`であることにも注意してください。ほかの [フォントサイズ](/latex/ja/fonto/01-font-sizes-families-and-styles.md) を使うこともでき、式はそれに応じて拡大縮小されます。 ### リファレンスガイド（chemfig） **結合の種類** | 結合の種類 | コード | 出力 | | --------- | ------------------- | ------------------------------------------------------------- | | 単結合 | `\chemfig{O - H}` | ![Bond1.png](/files/dbc413cf51c2a1ca106b2bd48c27cec800c52211) | | 2倍の | `\chemfig{O = H}` | ![Bond2.png](/files/bc2df33ccdd70c92f538587116f2782efa573fb3) | | 三重結合 | `\chemfig{O ~ H}` | ![Bond3.png](/files/5cbcb87ea7fbc7b53551d0a05aec4e7801b2b573) | | 右向きの通常クラム | `\chemfig{O > H}` | ![Bond4.png](/files/b8c3c0ad0307d8468551cf40e5b9664d38f42971) | | 左向きの通常クラム | `\chemfig{O < H}` | ![Bond5.png](/files/5b47b4a61e0df3ca18f2850ee814e8374f3b3f00) | | 右向きの点線クラム | `\chemfig{O >: H}` | ![Bond6.png](/files/fb344dc4160869a6582a5f44e155a572dd67db9d) | | 左向きの点線クラム | `\chemfig{O <: H}` | ![Bond7.png](/files/5f324765bc862e790bc16420073f8b0980b94793) | | 右向きの中空クラム | `\chemfig{O >\| H}` | ![Bond8.png](/files/39ec4f33992160c5fe820402cb666d9c03e6426a) | | 左向きの中空クラム | `\chemfig{O <\| H}` | ![Bond9.png](/files/fcbba3334c52a61411d0a55b1cb1f3ea873d7208) | ## mhchem を使って化学式や化学方程式を組版する その `mhchem` パッケージの多用途な `\ce` コマンドは [Overleaf のビジュアルエディタのプレビューでも対応しており、](#visual-editors-preview-of-chemical-formulae-and-equations)を使うことで、化学式や化学方程式を組版できます。たとえば `\ce{H2O}` は $$\text{H}\_2\text{O}$$水の化学式を組版します。 * **注**: パッケージの最近のバージョンでは `mhchem` により [プロジェクトのコンパイルに必要な時間が増えることがあります](/latex/ja/narejjibsu/038-fixing-and-preventing-compile-timeouts.md#mhchemtimeout). そこで [`chemformula` パッケージ](https://ctan.org/pkg/chemformula?lang=en)に切り替え、その `\ch` コマンドを使うとコンパイル時間を短縮できますが、 `\ch` コマンドは現在、Visual Editor ではプレビューされません。 ### mhchem パッケージの読み込み方法 最新バージョンの `mhchem`を使うには、現在のバージョン 4 を、文書のプリアンブルに次の行を追加してください: ```latex \usepackage[version=4]{mhchem} ``` これで `mhchem` が読み込まれ、化学式や化学方程式の書式設定にデフォルトのスタイルが使われます。これらの既定値を変更するには、 `mhchem` パッケージオプションまたは `\mhchemoptions` コマンドを使えます。たとえば、テキストモードのフォントをサンセリフ体にし、PGF/Ti*k*Z を使って矢印を描くには、 `mhchem` を ```latex \usepackage[version=4,arrows=pgf-filled,textfontname=sffamily]{mhchem} ``` で読み込むか、あるいは `\mhchemoptions` コマンドを文書内で使えます ```latex \mhchemoptions{arrows=pgf-filled,textfontname=sffamily} ``` その [`mhchem` パッケージドキュメントに記載されているオプションがあります](http://mirrors.ctan.org/macros/latex/contrib/mhchem/mhchem.pdf) は、設定に関するさらなるガイダンスを提供します `mhchem`。さらに、化学式や化学方程式の多数の例があり、そのいくつかをここに再掲して、使い始める助けにしています。より複雑な入力では、 `\ce` コマンドへの入力内でスペース文字を使っている点に注意してください。これらのスペースは、 `mhchem` が化学式や化学方程式を正しく解析するために必要です。省略すると、 [Unexpected input character](#the-unexpected-input-character-mhchem-error). ### いくつかの例 次の Overleaf プロジェクトは `mhchem` を 3 つのパッケージオプション付きで読み込みます: * `arrows=pgf-filled`: PGF を使って塗りつぶし矢印を描画します * `textfontname=sffamily`: 数式モードの外では、化学式や化学方程式は既定のサンセリフ体フォントで組版されます * `mathfontname=mathsf`: 数式モードではサンセリフ体フォントを使います その `\ce` コマンドは、複数の例を組版するために使われます。 ```latex \documentclass{article} %いくつかのパッケージオプションを使って mhchem を読み込む \usepackage[version=4,arrows=pgf-filled, textfontname=sffamily, mathfontname=mathsf]{mhchem} \begin{document} \subsection*{単純な分子} \begin{itemize} \item 水: \verb|\ce{H2O}|, \ce{H2O} \item ベンゼン: \verb|\ce{C6H6}|, \ce{C6H6} \item 過酸化水素: \verb|\ce{H2O2}|, \ce{H2O2} \item 酢酸: \verb|\ce{C2H4O2}|, \ce{C2H4O2} \item ブドウ糖: \verb|\ce{C6H12O6}|, \ce{C6H12O6} \end{itemize} \subsection*{化学方程式} 基本的な例を 2 つ: \begin{itemize} \item \verb|\ce{2H2 + O2 -> 2H2O}| は \ce{2H2 + O2 -> 2H2O} を組版します \item \verb|\ce{CO2 + C -> 2 CO}| は \ce{CO2 + C -> 2 CO} を組版します \end{itemize} \subsection*{より複雑な例} \verb|\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}| と書くと、次のように組版されます:\vskip10pt \noindent \ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}. \subsection*{数式モードの例} 化学式は \verb|\frac| のような数式モードのコマンドを使って組版できます。 \vskip10pt \noindent \verb|\[K=\frac{[\ce{Hg^2+}][\ce{Hg}]}{[\ce{Hg2^2+}]}\]| と書くと次のようになります: \[K=\frac{[\ce{Hg^2+}][\ce{Hg}]}{[\ce{Hg2^2+}]}\] \end{document} ``` [これを開く `mhchem` Overleaf での例。](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=mhchem+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25Load+mhchem+using+some+package+options%0A%5Cusepackage%5Bversion%3D4%2Carrows%3Dpgf-filled%2C%0Atextfontname%3Dsffamily%2C%0Amathfontname%3Dmathsf%5D%7Bmhchem%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csubsection%2A%7BSimple+molecules%7D%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+Water%3A+%5Cverb%7C%5Cce%7BH2O%7D%7C%2C+%5Cce%7BH2O%7D%0A%5Citem+Benzene%3A+%5Cverb%7C%5Cce%7BC6H6%7D%7C%2C+%5Cce%7BC6H6%7D%0A%5Citem+Hydrogen+peroxide%3A+%5Cverb%7C%5Cce%7BH2O2%7D%7C%2C+%5Cce%7BH2O2%7D%0A%5Citem+Acetic+acid%3A+%5Cverb%7C%5Cce%7BC2H4O2%7D%7C%2C+%5Cce%7BC2H4O2%7D%0A%5Citem+Glucose%3A+%5Cverb%7C%5Cce%7BC6H12O6%7D%7C%2C+%5Cce%7BC6H12O6%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Csubsection%2A%7BChemical+equations%7D%0A%0ATwo+basic+examples%3A%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Cverb%7C%5Cce%7B2H2+%2B+O2+-%3E+2H2O%7D%7C+typesets+%5Cce%7B2H2+%2B+O2+-%3E+2H2O%7D%0A%5Citem+%5Cverb%7C%5Cce%7BCO2+%2B+C+-%3E+2+CO%7D%7C+typesets+%5Cce%7BCO2+%2B+C+-%3E+2+CO%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Csubsection%2A%7BA+more+complex+example%7D%0A%0AWriting+%5Cverb%7C%5Cce%7BHg%5E2%2B+-%3E%5BI-%5D+HgI2+-%3E%5BI-%5D+%5BHg%5E%7BII%7DI4%5D%5E2-%7D%7C+typesets+this%3A%5Cvskip10pt%0A%5Cnoindent+%5Cce%7BHg%5E2%2B+-%3E%5BI-%5D+HgI2+-%3E%5BI-%5D+%5BHg%5E%7BII%7DI4%5D%5E2-%7D.%0A%0A%5Csubsection%2A%7BA+math+mode+example%7D%0A%0AChemical+expressions+can+be+typeset+using+math+mode+commands+such+as+%5Cverb%7C%5Cfrac%7C.+%5Cvskip10pt%0A%0A%5Cnoindent+Writing+%5Cverb%7C%5C%5BK%3D%5Cfrac%7B%5B%5Cce%7BHg%5E2%2B%7D%5D%5B%5Cce%7BHg%7D%5D%7D%7B%5B%5Cce%7BHg2%5E2%2B%7D%5D%7D%5C%5D%7C+produces+this%3A%0A%0A%5C%5BK%3D%5Cfrac%7B%5B%5Cce%7BHg%5E2%2B%7D%5D%5B%5Cce%7BHg%7D%5D%7D%7B%5B%5Cce%7BHg2%5E2%2B%7D%5D%7D%5C%5D%0A%5Cend%7Bdocument%7D) このプロジェクトは次の出力を生成します: ![mhchem の例を示す図](/files/946ce22e4039bbfbfa8c6340ecec04c5efa67596) その [`mhchem` パッケージドキュメントに記載されているオプションがあります](http://mirrors.ctan.org/macros/latex/contrib/mhchem/mhchem.pdf) には、パッケージオプションや設定に関する情報に加えて、数多くの化学式や化学方程式の例が含まれているため、ぜひ読む価値があります。 ### Visual Editor による化学式と化学方程式のプレビュー Overleaf の Visual Editor では、次の動画クリップに示すように、 `\ce` コマンドで組版された化学式や化学方程式のプレビューを表示できます: {% embed url="" %} ### 「Unexpected input character」という mhchem エラー その `mhchem` パッケージエラー **`Assertion failed: Unexpected input character`** はしばしば、 `\ce` コマンド入力内のスペース不足が原因です。スペースは、 `mhchem` より複雑な化学式を正確に解析するために不可欠です。このエラーは、PDF 文書から例をコピー＆ペーストした際に発生することがあり、その場合スペースが正確に再現されないことがあります。 次の例でこのエラーを示します: ```latex \ce{CO2+C->2CO} ``` [これを開く **エラーを発生させる** `mhchem` Overleaf での例。](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=mhchem+errors+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bversion%3D4%5D%7Bmhchem%7D+%0A%5Cbegin%7Bdocument%7D%0A%5Cce%7BCO2%2BC-%3E2CO%7D%0A%5Cend%7Bdocument%7D) 最低でも、 `C` と `->` の間にスペースを入れる必要があります。しかし、それだけでは目的の式を組版するのに十分でない場合があります。すべてのスペースを正しく追加すると、次のようになります: ```latex \ce{CO2 + C -> 2 CO} ``` [この修正版を開く `mhchem` Overleaf での例。](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=mhchem+corrected+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bversion%3D4%5D%7Bmhchem%7D+%0A%5Cbegin%7Bdocument%7D%0A%5Cce%7BCO2+%2B+C+-%3E+2+CO%7D%0A%5Cend%7Bdocument%7D) このプロジェクトは次の出力を生成します: ![](/files/d20c06d455ac47828f2fb886e080f99f874a9308) ## 参考文献 詳しくは次を参照してください。 * [分子軌道図](/latex/ja/fen-ye-bie/04-molecular-orbital-diagrams.md) * [ファインマン図](/latex/ja/fen-ye-bie/03-feynman-diagrams.md) * [TikZ パッケージ](/latex/ja/to/05-tikz-package.md) * [画像の挿入](/latex/ja/sononotopikku/27-inserting-images.md) * [ギリシャ文字と数式記号の一覧](/latex/ja/shu-xue/11-list-of-greek-letters-and-math-symbols.md) * [その **chemfig** パッケージドキュメントに記載されているオプションがあります](http://www.ctan.org/pkg/chemfig) * [その **tikz/pgf** パッケージドキュメントに記載されているオプションがあります](http://www.ctan.org/pkg/pgf) --- # 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://overleaf-pro.ayaka.space/latex/ja/fen-ye-bie/02-chemistry-formulae.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.