> 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/es/mas-temas/28-inserting-images-es.md). # Insertar imágenes es Las imágenes son elementos esenciales en la mayoría de los documentos científicos. LaTeX ofrece varias opciones para manejar imágenes y hacer que se vean exactamente como las necesitas. En este artículo se explica cómo incluir imágenes en los formatos más comunes, cómo hacerlas más pequeñas o más grandes, y cómo añadir referencias a las imágenes dentro del documento. ## Introducción A continuación, un ejemplo de cómo importar una imagen en LaTeX. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} El universo es inmenso y parece ser homogéneo, a gran escala, a dondequiera que miremos. \includegraphics{universe} Hay una imagen de una galaxia arriba \end{document} ``` ![InsertingImagesEx1.png](/files/91715d8937b7d377835f4bfbb6aefc399af991cd) LaTeX no tiene la capacidad de manipular imágenes por sí mismo, por esa razón se debe importar el paquete **graphicx**. Para usar dicho paquete añade la siguiente línea en el preámbulo de tu documento ```latex \usepackage{graphicx} ``` El comando `\graphicspath{ {images/} }` le indica a LaTeX que las imágenes están guardadas en una carpeta llamada *images* bajo el directorio actual. El comando `\includegraphics{universe}` es el que se encarga de incluir la imagen en el documento. Aquí, *universe* es el nombre del archivo de la imagen, sin la extensión; así que *universe.PNG* se convierte en *universe*. El nombre del archivo de la imagen no debe contener espacios en blanco ni múltiples signos de puntuación. Nota: *Se puede introducir la extensión del archivo, pero es recomendable* omitirla. Si se omite la extensión, esto provoca que LaTeX busque todos los formatos compatibles. Para más detalles, consulta la sección [Generando imágenes en alta y baja resolución](#generando-imgenes-en-alta-y-baja-resolucin). [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## La ruta a la carpeta de imágenes Cuando se trabaja en un documento que incluye varias imágenes, una posibilidad para mantener tu proyecto organizado es guardarlas en una carpeta aparte. En el ejemplo de la introducción esto se logra mediante el comando `\graphicspath{ {images/} }` que le dice a LaTeX que las imágenes las debe buscar en la carpeta *images*. La ruta es *relativa* al directorio de trabajo actual. La ruta hacia la carpeta puede ser ***relativa*** (recomendado) si la carpeta está en el mismo directorio que el archivo .tex principal o en alguna de las subcarpetas, o puede ser ***absoluta*** si se requiere especificar exactamente la ruta. Por ejemplo: ```latex %Ruta absoluta en el formato de Windows: \graphicspath{ {c:/user/images/} } %Ruta absoluta en formato tipo Unix (Linux, OsX) \graphicspath{ {/home/user/images/} } ``` Nótese que este comando requiere una barra final `/` al final y que la ruta se debe poner entre dos pares de llaves. También es posible establecer múltiples rutas si guardaste las imágenes en más de una carpeta para mayor organización. Por ejemplo, si hay dos carpetas, una llamada *images1* y la otra *images2*, usa el comando ```latex \graphicspath{ {images1/}{images2/} } ``` Si no se especifica ninguna ruta, LaTeX buscará las imágenes en la carpeta actual, donde está guardado el archivo .tex. [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Cambiar el tamaño y rotar una imagen Si se quieren especificar parámetros adicionales al momento de importar una imagen en LaTeX para modificar la anchura, altura, posición, etc. de la imagen, esto es posible mediante la siguiente sintaxis: ```latex Overleaf es una gran herramienta profesional para editar en línea, compartir y respaldar tus proyectos de \LaTeX. Además ofrece una documentación de ayuda bastante amplia. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/fa59298c69f09da25fcc06e5ada8508f2bcf632f) El comando `\includegraphics[scale=1.5]{lion-logo}` incluye la imagen *lion-logo* en el documento, el parámetro adicional `scale=1.5` escala la imagen a 1.5 veces su tamaño original. También es posible redimensionar la imagen a una altura y anchura determinadas. ```latex Overleaf es una gran herramienta profesional para editar en línea, compartir y respaldar tus proyectos de \LaTeX. Además ofrece una documentación de ayuda bastante amplia. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/14acb16c43a7dcf08bc76437c1979bcf2f3ff3e0) Como probablemente ya hayas adivinado, los parámetros dentro de los corchetes `[width=3cm, height=4cm]` definen el ancho y alto de la imagen. Pueden usarse [diferentes unidades](#gua-de-referencia) de medida en estos parámetros. Si solamente se establece el valor de *width*, la altura se escalará proporcionalmente para mantener el aspecto de la imagen. También es posible establecer la longitud de la imagen respecto a otros elementos en el documento. Por ejemplo, si quieres que la imagen tenga la misma anchura que el texto: ```latex Overleaf es una gran herramienta profesional para editar en línea, compartir y respaldar tus proyectos de \LaTeX. Además ofrece una documentación de ayuda bastante amplia. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/353eebbf1f2b995540a73c1e25231e280f90d385) En vez de `\textwidth` puedes usar cualquier otra de las unidades que LaTeX incluye por defecto: *\columnsep, \linewidth, \textheight, \paperheight, etc*. Consulta la [guía de referencia](#gua-de-referencia) para una mejor descripción de las unidades. Hay otra opción muy común a la hora de incluir imágenes en un documento: poder rotarlas. Esto es muy fácil en LaTeX: ```latex Overleaf es una gran herramienta profesional para editar en línea, compartir y respaldar tus proyectos de \LaTeX. Además ofrece una documentación de ayuda bastante amplia. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/d1827cac87ebadedb0733b1ca518b33cb4a541f0) El parámetro `angle=45` rota la imagen 45 grados en sentido antihorario. Para rotar la imagen en el mismo sentido que las manecillas del reloj usa un número negativo. [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Posicionar la imagen En la sección anterior se explicó cómo insertar una imagen en tu documento, pero a veces la combinación de imágenes y texto en tu documento puede no resultar como esperabas. Para cambiar esto es necesario usar un nuevo ambiente: ```latex En el siguiente ejemplo la figura se posicionará justo debajo de esta oración. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/2590c7a43a34cc0265a2979b9d6664f1056af49b) El ambiente `figure` se usa para mostrar las imágenes como elementos flotantes dentro del documento. Esto significa que basta con incluir tu imagen dentro del ambiente *figure* y ya no tienes que preocuparte por dónde aparecerá, LaTeX la posicionará de tal manera que encaje perfectamente con el flujo del documento. Aunque en principio esto suena muy bien, a veces uno quiere tener más control sobre dónde aparecerán las imágenes. Se puede usar un parámetro adicional para establecer el posicionamiento de la figura. En el ejemplo, `begin{figure}[h]`, el parámetro dentro de los corchetes establece la posición de la figura *aquí* (aquí, en inglés). A continuación, una tabla con una lista de posibles valores de posicionamiento. | Parámetro | Posición | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Establece la posición del elemento flotante «aquí». Es decir, aproximadamente en el mismo punto donde aparece en el código (sin embargo, el posicionamiento no siempre es exacto) | | t | Inserta la figura al inicio de la página. | | b | Inserta la figura al final de la página. | | p | Inserta los elementos flotantes en una página aparte, que solo contiene figuras. | | ! | Sobrescribe los parámetros que LaTeX usa para determinar una posición «buena» para la imagen. | | H | Establece el elemento flotante precisamente en el mismo lugar en el que aparece en el código; se requiere importar el paquete `float`. Es hasta cierto punto equivalente a h!. | En el siguiente ejemplo se puede ver una imagen que aparece al inicio del documento, a pesar de que el código que la produce se encuentra al final del documento. ```latex En esta imagen puedes ver una gráfica de barras que muestra los resultados de una encuesta que involucró algunos datos importantes estudiados a medida que pasaba el tiempo. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/db426dccc505fd0d786553e10b9e6777aadd6424) El comando adicional `\centering` se encarga de centrar la imagen. El valor de alineación predeterminado es a la izquierda. También es posible envolver el texto alrededor de la figura. Cuando el documento contiene imágenes pequeñas esto hace que el texto se vea mejor. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %esta figura estará a la derecha \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Hay varias maneras de trazar una función de dos variables, dependiendo de la información que te interese. Por ejemplo, si quieres ver la malla de una función para que sea más fácil ver la derivada, puedes usar una gráfica como la de la izquierda. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} Por otro lado, si solo te interesan ciertos valores, puedes usar la gráfica de contorno; puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, gráfica, puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, como la de la izquierda. Por otro lado, si solo te interesan ciertos valores, puedes usar la gráfica de contorno; puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, gráfica de contorno, puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, puedes usar la gráfica de contorno, como la de la izquierda. ``` ![InsertingImagesEx8.png](/files/60c9362f81449d747ee559330b076dcc5b3193be) Para que los comandos del ejemplo funcionen, se debe importar el paquete **wrapfig**. Añade al preámbulo la línea ```latex \usepackage{wrapfig} ``` Una vez importado el paquete se puede usar el ambiente *wrapfigure* mediante el comando `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Nótese que el ambiente tiene dos parámetros adicionales entre llaves. A continuación se explica el código con más detalle. **{l}** Establece la alineación de la figura. Usa l para izquierda y r para derecha. Además, si se está usando la clase book u otra similar, en vez de l y r se pueden usar o para el borde exterior e i para el borde interior de la página. **{0.25\textwidth}** Esto establece la anchura de la caja que contiene la imagen. No es la anchura de la imagen en sí misma; esa se debe establecer en el comando includegraphics. En el ejemplo se usan unidades relativas, pero se pueden usar unidades normales (cm, mm, in, etc.). Consulta la guía de referencia para ver una lista de unidades posibles. **\centering** Como ya se explicó anteriormente, en el ejemplo anterior la imagen se centrará respecto a la caja que la contiene, en lugar de centrarla respecto a la página. Para obtener información más completa acerca del posicionamiento de imágenes consulta el artículo [Colocación de imágenes y tablas](/latex/es/figuras-y-tablas/02-positioning-images-and-tables.md) [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Añadir etiquetas, leyendas y referencias La posibilidad de añadir leyendas con una breve descripción de la imagen y etiquetas que luego se pueden usar para referirse a la imagen son herramientas muy útiles cuando se trabaja con documentos muy largos. ### Leyendas Comencemos con un ejemplo sobre cómo añadir una leyenda: ```latex \begin{figure}[h] \caption{Example of a parametric plot ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/af8df379ff9b5c0400eefbdd7c3146a3b74f46e5) Es muy fácil, solo hay que añadir el comando `\caption{Some caption}` y dentro de las llaves escribir el texto a mostrar. El lugar donde se imprimirá la leyenda depende de dónde se inserta el comando; si está sobre el comando *includegraphics* entonces la leyenda aparecerá sobre la imagen; si está debajo de ese comando, entonces la leyenda aparecerá en la parte inferior de la figura. Las leyendas también se pueden posicionar al lado de las figuras. El paquete **sidecap** permite usar un código muy similar al del ejemplo anterior para añadir el texto. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %paquete para gestionar imágenes \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Ejemplo de una gráfica paramétrica. Esta leyenda estará a la derecha} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/d6760253757aa59ebabb05dbe798a2606c8a82ab) Hay dos nuevos comandos en este ejemplo: **\usepackage\[rightcaption]{sidecap}** Como posiblemente ya lo sabes, este comando importa el paquete llamado sidecap, pero hay un parámetro adicional: rightcaption. Este parámetro es el que establece el lugar donde se imprime la leyenda. En este caso, a la derecha de la imagen. También es posible usar leftcaption para mover la leyenda a la izquierda. En documentos que usan clases de tipo libro, adicionalmente se pueden usar las opciones outercaption e innercaption para imprimir la leyenda en la parte exterior o interior respecto al borde de la página. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Define un ambiente similar a figure. El primer parámetro es la anchura de la leyenda relativa al tamaño de la imagen. El segundo parámetro h tiene la misma función que en el ambiente figure. Consulta la sección sobre posicionamiento de imágenes para más información. Se puede lograr un manejo más avanzado del formato de las leyendas si así se desea. Consulta las [lecturas adicionales](#lecturas-adicionales) para ver más referencias. ### Etiquetas y referencias cruzadas Las figuras, al igual que muchos otros elementos en un documento LaTeX (ecuaciones, tablas, gráficas, etc.), pueden ser referidas desde dentro del texto. Lograr esto es muy fácil, solo hay que añadir una etiqueta al ambiente *figure* o *SCfigure*, y luego usar esa etiqueta para referirse a la figura. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{a nice plot} \label{fig:mesh1} \end{figure} Como puedes ver en la figura \ref{fig:mesh1}, la función crece cerca de 0. Además, en la página \pageref{fig:mesh1} está el mismo ejemplo. ``` ![InsertingImagesEx11.png](/files/48656c094b57c148ae1da6cc8a633382db26953d) Hay tres comandos en este ejemplo que generan referencias cruzadas. **\label{fig:mesh1}** Establece la etiqueta para la figura. Dado que las etiquetas se pueden usar en diversos tipos de elementos en el documento, es una buena práctica usar un prefijo, como fig: en el ejemplo. **\ref{fig:mesh1}** Este comando imprime el número que se le asignó a la figura. Los números se generan automáticamente y se actualizan si posteriormente se inserta una figura antes de la que se refiere. **\pageref{fig:mesh1}** Imprime el número de página donde aparece la imagen referida por la etiqueta. El comando `\caption` que añade una leyenda es obligatorio para poder añadir una etiqueta y referirse a la figura. Otra característica importante en LaTeX es la posibilidad de generar automáticamente una *lista de figuras*. Esto se logra fácilmente con: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/8030bf910fd9b35180fe8f45b745521756d02695) Este comando solo funciona con figuras que tienen una leyenda, dado que la usa para generar la tabla. El ejemplo anterior lista las imágenes usadas en el presente artículo. Nota importante: *Cuando se usan referencias cruzadas en LaTeX el proyecto debe ser compilado dos veces; de lo contrario, las referencias, las referencias a páginas y la tabla de figuras no funcionarán*. [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Generando imágenes en alta y baja resolución Por el momento, cuando introducimos el nombre del archivo de imagen en el comando *\includegraphics* omitimos la extensión del archivo. Sin embargo, eso no es necesario, aunque sí puede ser muy útil. Si se omite la extensión, LaTeX buscará cualquier tipo de imagen compatible en el directorio de imágenes preestablecido; la búsqueda se hará en un cierto orden, el cual puede ser modificado. Esto es muy útil para pasar de la versión en borrador de tu documento a la versión final. En el borrador (mientras escribes tu artículo, libro, reporte, etc.), es deseable poder usar imágenes con baja resolución (típicamente en formato .png) para que el documento compile más rápidamente. En la versión final, en cambio, uno prefiere incluir las imágenes en alta resolución, para tener un documento de calidad. Esto se puede lograr mediante: * No especificar la extensión del archivo en el comando *\includegraphics*, y * Especificar el orden de las extensiones en el preámbulo Así, si uno tiene dos versiones de la misma imagen, por ejemplo venndiagram.pdf (en alta resolución) y venndiagram.png (en baja resolución), se puede incluir la siguiente línea en el preámbulo mientras se escribe y depura el documento - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` El comando anterior se asegura de que si se encuentran dos imágenes con el mismo nombre pero con diferentes extensiones, entonces el archivo .png será usado, y si por alguna razón este archivo desaparece, la versión en pdf será la siguiente opción. Una vez que el documento ha sido escrito, para usar únicamente la versión en alta resolución se debe cambiar la línea que determina la extensión a: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Se puede incluso mejorar la técnica descrita anteriormente; podemos pedirle a LaTeX que genere imágenes .png de baja resolución mientras se compila el documento si el PDF no ha sido convertido a PNG con anterioridad. Para lograr esto, se debe incluir lo siguiente en el preámbulo después de `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Si venndiagram2.pdf existe pero no venndiagram2.png, el archivo venndiagram2-pdf-converted-to.png se creará y se cargará en su lugar. El comando *convert #1* es el responsable de la conversión Hay un par de cosas a tener en mente si se elige este método: * Para que la conversión automática funcione se debe ejecutar *pdflatex* con la opción `--shell-escape`. * Para la versión final no se debe olvidar comentar la línea `\epstopdfDeclareGraphicsRule`, de tal suerte que solo se carguen las imágenes en alta resolución. También se debe recordar cambiar el orden de precedencia. [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Guía de referencia **Unidades y medidas en LaTeX** | Abreviación | Definición | | ------------ | ---------------------------------------------------------------------------- | | pt | Un punto, es la unidad de longitud predeterminada. Aproximadamente 0.3515 mm | | mm | un milímetro | | cm | un centímetro | | % en | una pulgada | | ex | la altura de una **x** con la fuente actual | | em | la anchura de una **m** con la fuente actual | | \columnsep | distancia entre columnas | | \columnwidth | anchura de una columna | | \linewidth | amplitud de línea en el ambiente actual | | \paperwidth | anchura del papel | | \paperheight | altura del papel | | \textwidth | anchura del texto | | \textheight | altura del texto | | \unitlength | unidades de longitud en el ambiente *picture* | **Acerca de los tipos de imágenes que se pueden usar en LaTeX** **latex** Si se compila el documento con el comando latex, solo se pueden usar imágenes en formato EPS, el cual es un formato vectorial. **pdflatex** Si se compila el documento con el comando pdflatex para producir un PDF, entonces se pueden usar varios tipos de imágenes: ``` JPG: La mejor opción para insertar fotografías PNG: La mejor opción para insertar diagramas (si por alguna razón no puedes usar un gráfico vectorial) y capturas de pantalla PDF: A pesar de la costumbre de usar PDF para documentos, en general un PDF puede constar de únicamente una imagen que posteriormente puede importarse. EPS: Las imágenes EPS se pueden incluir usando el paquete epstopdf (el paquete solo se debe instalar en el equipo; una vez instalado no es necesario ningún comando adicional en el archivo .tex) ``` **¿Gráficos vectoriales o mapas de bits?** Las imágenes se pueden incluir ya sea en formato de mapas de bits o de gráficos vectoriales. En general uno no debe preocuparse por ello, pero si se tiene la opción de elegir un formato hay que tener en cuenta que para un gráfico vectorial lo mejor es guardarlo en formato PDF o EPS, mientras que para un mapa de bits los formatos JPG o PNG son los recomendados. Esto se debe a que un mapa de bits dentro de un archivo en formato PDF o EPS requiere mucho espacio de almacenamiento. [Abrir un ejemplo en Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Lecturas adicionales Para más información consultar: * [Colocación de imágenes y tablas](/latex/es/figuras-y-tablas/02-positioning-images-and-tables.md) * [Listas de tablas y figuras](/latex/es/figuras-y-tablas/03-lists-of-tables-and-figures.md) * [Documentos a una cara y a doble cara](/latex/es/formato/08-single-sided-and-double-sided-documents.md) * [Longitudes en LaTeX](/latex/es/formato/01-lengths-in-latex.md) * [**floatrow** paquete para la gestión avanzada de leyendas de elementos flotantes (tablas y figuras)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** documentación del paquete, para leyendas de figuras laterales](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** documentación del paquete (conversión de PDF a EPS)](https://www.google.com/url?sa=t\&rct=j\&q=\&esrc=s\&source=web\&cd=3\&cad=rja\&ved=0CEEQFjAC\&url=http%3A%2F%2Fmirror.hmc.edu%2Fctan%2Fmacros%2Flatex%2Fcontrib%2Foberdiek%2Fepstopdf.pdf\&ei=N4v2UpK7D4eHqQHz2IDACg\&usg=AFQjCNG9CxIXjrbc22kl-8QweEXeEauFew\&sig2=qamKo3qpid8CEqzsHhpIrQ\&bvm=bv.60983673,d.aWM) --- # 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/es/mas-temas/28-inserting-images-es.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.