> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/scene-editor-essentials.md).

# Conceptos esenciales del Scene Editor

Cómo usar el Scene Editor

La UI del Scene Editor está dividida en varias secciones diferentes, con distintos propósitos.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-80eb7f0f2596e0dde68a93113665f40c1157ea1e%2Feditor-layout.png?alt=media\&token=88a9399c-d2d6-421c-8400-82905670e298)

* **Canvas**: Manipula items directamente y ve cómo se ve tu escena.
* **Entity tree**: Contiene una lista de todos los items en la escena y su jerarquía.
* **Propiedades**: Muestra detalles sobre el item actualmente seleccionado.
* **Recursos**: Muestra recursos que están disponibles para usar.

## Moverse

Para orientarte en el Scene Editor:

* Usa **W** y **S** para acercarte o alejarte. También puedes usar la rueda de desplazamiento del mouse, o **+** y **-** teclas
* Usa **Un** y **D** para moverte lateralmente.
* Usa **Q** y **E** para moverte hacia arriba y hacia abajo.
* Haz clic en el **Botón derecho del mouse** y arrastra para girar la cámara.
* Pulsa **Barra espaciadora** para restablecer la cámara a la posición predeterminada
* Usa **Botón izquierdo del mouse** para hacer clic, seleccionar elementos y moverlos.

## Previsualización en móvil

El **Opciones de reproducción** menú junto al **Reproducir** botón tiene una **Mostrar código QR para móvil** opción. Escanea el código QR con un teléfono en la misma red Wi‑Fi para abrir tu escena en el [aplicación móvil de Decentraland](/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md). Esta es la forma recomendada de validar la UI, los controles y el rendimiento para jugadores móviles. Consulta [Previsualización en móvil](/creator/content-creator-es/desarrollar-para-movil/desarrollar/preview-on-mobile.md) para la guía completa.

## Establecer el Ground

El ground de la escena puede usar varias texturas diferentes. Puedes encontrarlas en los diferentes asset packs temáticos del menú de items.

Items de tipo **Ground** tienen un icono de cubeta de pintura. Si arrastras uno de estos a tu escena, cubre todo el ground de tu escena con copias de este item.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8d952452b5bf6475868c3392c6f0472690587580%2Fground.png?alt=media\&token=4c0c854a-72d9-4dc8-853d-7ef652c50cc3)

También puedes añadir una sola copia del item manteniendo pulsada la **Shift** mientras arrastras el ground a la escena.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-069d473c6ec47b6f54ae95ee9d91bb27c2e81665%2Fground-entities.png?alt=media\&token=46274493-559b-40d7-858a-181664dfe9b9)

La colección de ground items aparece en el [entity tree](#the-entity-tree) dentro de una carpeta. Cada uno está locked para evitar seleccionarlo accidentalmente. [Desbloquea](#lock-or-hide-items) los items para moverlos o editarlos.

## Añadir elementos

Navega por las categorías temáticas de asset packs en el menú inferior para encontrar distintos elementos que puedes colocar en tu escena.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-533d4553c3a38522cdd08dce8040a08c038699e7%2Fasset-packs.png?alt=media\&token=99210953-9718-4fa7-895c-317c45f74d6e)

También puedes usar el cuadro de búsqueda. Ten en cuenta que, cuando estás dentro de un asset pack, la búsqueda solo examina ese asset pack.

Para colocar un elemento, haz clic y arrástralo desde el menú de asset pack hasta una ubicación en tu escena en el canvas.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30237e6006c76b69f5cfe737e543875987ed67b8%2Fdrop-item.gif?alt=media\&token=5d263b79-cd82-4436-bc8e-3a07e68df559)

{% hint style="info" %}
**💡 Consejo**: Tus cambios se guardan automáticamente cada vez que añades, mueves o editas las propiedades de cualquiera de los items de tu escena.
{% endhint %}

Para duplicar un item, selecciónalo y pulsa **Ctrl + C** y luego **Ctrl + V**. También puedes encontrar el item en el [entity tree](#the-entity-tree) para hacer clic derecho y seleccionar la opción **Duplicar**. El nuevo item se superpondrá perfectamente al original.

Para eliminar un item de la escena, selecciónalo y pulsa la *Delete* tecla.

Consulta [Importar items](/creator/content-creator-es/scene-editor/construir/import-items.md) para añadir tus propios modelos 3D personalizados desde el disco.

{% hint style="warning" %}
**📔 Nota**: Una vez que arrastras un modelo 3D a tu escena, se descarga en la carpeta de tu proyecto y permanece allí incluso si lo eliminas. Estos modelos no utilizados pueden aumentar el tamaño de tu escena.

Abre la **Local Assets** pestaña para eliminar cualquier modelo no utilizado.
{% endhint %}

## Posicionar items

{% embed url="<https://www.youtube.com/watch?v=cNl02PFPdcQ>" %}

Haz clic con el **Botón izquierdo del mouse** y arrastra un item seleccionado para moverlo libremente por la escena al nivel del suelo.

También puedes usar las herramientas del menú superior:

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4b95b511c15b05517739d57d024d0f0b23007782%2Fgizmos.png?alt=media\&token=72f1d0d2-cd0c-44dd-a3a0-bc32997577d3)

* **Herramienta de mover**: Haz clic y arrastra cada flecha para mover el item en un solo eje a la vez. Con esta herramienta también puedes posicionar cosas por encima del nivel del suelo.
* **Herramienta de rotar**: Haz clic y arrastra cada uno de los aros alrededor del item para rotarlo en un solo eje a la vez.
* **Herramienta de escala**: Haz clic en el centro del gizmo y arrastra hacia dentro o hacia fuera para agrandar. Esta herramienta también te permite estirar un item en un solo eje para cambiar sus proporciones; para hacerlo, haz clic en uno de los ejes del gizmo y arrastra.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-dfe9363a387a120ae140da69d76e1c66dc5d5399%2Fmove-items.gif?alt=media\&token=513ffbb0-992c-4a68-b2e8-8971081d1b57)

Para tener mayor precisión al mover, rotar o escalar un item, mantén pulsada la *Shift* tecla mientras realizas ajustes. Esto evitará que se ajuste a la cuadrícula.

Para cambiar la granularidad del movimiento y otros ajustes, haz clic en la flecha hacia abajo a la derecha de las herramientas. Las siguientes opciones están disponibles:

* **Snap**: Activa o desactiva la cuadrícula. Cuando está desactivada, el comportamiento de **Shift** se invierte: no sigues la cuadrícula por defecto; sí lo haces si mantienes pulsada la **Shift**.
  * **Posición**: El tamaño de los incrementos de movimiento en metros cuando **Snap** está activado.
  * **Rotation**: El tamaño de los incrementos de rotación en grados cuando **Snap** está activado.
  * **Scale**: El tamaño de los incrementos de escala cuando **Snap** está activado.
* **Alinear al mundo**: Una sola casilla que se refiere al eje usado por los gizmos. Cuando está marcada, el eje de la herramienta de mover y rotar siempre se alinea con el mundo y no cambia con la orientación del objeto. Cuando no está marcada, se alinean con la orientación del objeto.

Para seleccionar varios items al mismo tiempo, mantén pulsada la *Controlar* tecla mientras los seleccionas. Luego puedes mover, rotar, escalar, duplicar o eliminar todos ellos en una sola acción.

### Escribe una cantidad exacta

Cuando arrastrar no es lo suficientemente preciso, escribe la cantidad en su lugar:

1. Pulsa una tecla de herramienta: **M** o **G** para mover, **R** para rotar, **X** para escalar.
2. Pulsa **X**, **Y** o **Z** para elegir un eje. Scale no necesita uno: sin un eje, escala cada eje por el mismo factor.
3. Escribe el número. Usa **.** para los decimales, y **-** para alternar entre positivo y negativo.
4. Pulsa **Enter** para aplicar, o **Esc** para cancelar. **Backspace** borra lo que escribiste.

Una ficha en la parte inferior del Canvas muestra la entrada mientras la escribes, te dice qué falta todavía y confirma lo que se aplicó.

Algunos ejemplos:

* **R** **X** **1** **5** **Enter** rota la selección 15 grados alrededor de X.
* **X** **2** **Enter** hace que la selección sea el doble de grande.
* **M** **Y** **-** **3** **Enter** la mueve 3 metros hacia abajo.

Algunas cosas que vale la pena saber:

* La cantidad siempre es relativa a dónde está ahora la selección, no a una coordenada absoluta.
* Los valores escritos ignoran la cuadrícula de ajuste.
* Con varios items seleccionados, todos se mueven, rotan o escalan alrededor de su centro compartido, como un solo paso de deshacer.
* Pulsar **M**, **G** o **R** una segunda vez sigue apagando su gizmo. **X** no, porque mientras escribes significa el eje X.

{% hint style="info" %}
**💡 Consejo**: El icono de teclado en la esquina inferior derecha del Canvas abre la lista completa de atajos.
{% endhint %}

## Smart items

Los Smart items son items especiales que vienen con comportamientos interactivos integrados. Consulta [Smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) para más detalles.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f368bfdf7894d18f29875528bdd91cf8429e70b3%2Fsmart-items.jpg?alt=media\&token=8f5f5b70-db16-4d37-b41c-4ee0eafe87e4)

## El entity tree

En el margen izquierdo, verás una estructura en árbol con todas las entities en la escena. Esto incluye todos los items que agregas, así como algunas entities predeterminadas.

{% hint style="info" %}
**💡 Consejo**: Todo en una escena es una Entity; son los bloques básicos de construcción de las escenas. Los items son Entities que tienen al menos una posición y una forma visible.
{% endhint %}

En lugar de seleccionar un item haciendo clic sobre él desde la vista 3D de la escena, puedes seleccionarlo desde la vista en árbol. Haz clic con el botón derecho del ratón sobre una entity para ver más opciones: puedes renombrar, eliminar o duplicar, también crear una child entity, convertirlo en un Custom Item o añadir un component a la entity.

![La entity tree con el menú de clic derecho abierto en la entity Bird Fountain, mostrando Rename, Add child, Duplicate, Delete, Create Custom Item y Add component.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7e0e6082ae86443a0412c2f58c6bf75e94a754c4%2Fentity-tree-context-menu.png?alt=media\&token=45339b1e-d4df-4c63-aa89-408cda1c50e6)

### Buscando en el entity tree

Un cuadro de búsqueda en la parte superior del entity tree te permite encontrar entities por nombre. Escribe parte del nombre de una entity y el árbol se filtra para mostrar solo las entities que coinciden y su jerarquía de padres, para que puedas ver dónde se sitúa cada coincidencia en el árbol. La búsqueda no distingue mayúsculas de minúsculas. Las entities padre de las coincidencias se expanden automáticamente para que cada resultado sea visible.

Pulsa **Escape** o haz clic en el icono de borrar para quitar el filtro y volver al árbol completo. Si hay una entity seleccionada, al borrar la búsqueda se vuelve a desplazar hasta la entity seleccionada para que no pierdas el lugar.

![El entity tree filtrado por el término de búsqueda fount: solo siguen siendo visibles las entities Camera, Scene y Bird Fountain, con el padre Scene expandido para mostrar la coincidencia.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6a4ecf3021b21dc6e02f1bedabea0aa348d6de18%2Fentity-tree-search.png?alt=media\&token=1b43f8ba-3dbc-4d14-836c-87c27cddc493)

### Jerarquía de entities

Las entities siguen una jerarquía que puede tener tantos niveles como quieras. Establece una relación padre-hijo entre dos entities arrastrando un item sobre otro en el árbol. Una child entity hereda la posición del padre, por lo que cuando el padre se mueve, arrastra consigo a cualquier hijo. Esto puede ser práctico al construir una escena; por ejemplo, puedes establecer las gafas y los platos como hijos de una mesa, y luego mover la mesa sin necesidad de reajustar nada más. También puede ser importante al interactuar con la escena, para que los items se muevan juntos.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a184c50ad6e26c4a37418ff8c28de2067ad3b02a%2Fitem-hierarchy.png?alt=media\&token=ac266788-86d2-4793-bb76-073ea66b0439)

También puedes minimizar o expandir los hijos de una entity para mantener la vista simple; esta acción no tiene efecto en la escena.

### Entities especiales

La escena incluye un par de entities especiales que puedes ver en el entity tree.

* **Scene**: Esto se refiere a la root entity; todo lo que agregas en la escena es hijo de esta entity. Puedes abrirla para ver [ajustes de la scene](#scene-settings).
* **Player**: El Avatar del jugador. Puedes añadir components especiales a esta entity que pueden cambiar las mecánicas de juego. También puedes arrastrar otras entities para que sean hijos del Avatar. Si una entity es hija del Avatar, su posición quedará fijada al jugador. Úsalo, por ejemplo, para añadir un marcador flotante sobre la cabeza del jugador que lo siga a donde vaya.
* **Camera**: La cámara del jugador. Puedes arrastrar otras entities para que sean hijos de la cámara. Si una entity es hija de la cámara, su posición quedará fijada en pantalla. Úsalo, por ejemplo, para mostrar un arma en un juego de disparos, que siempre esté a la vista incluso si el jugador apunta hacia arriba o hacia abajo.

### Bloquear u ocultar items

A veces puede resultarte útil bloquear un item para evitar seleccionarlo y moverlo accidentalmente. Esto es especialmente útil para items de fondo, como el suelo o un edificio. Para bloquear un item, búscalo en el entity tree de la izquierda, pasa el cursor sobre él y selecciona el icono de candado. Puedes activar y desactivar este comportamiento con ese mismo icono.

También puede que quieras ocultar un item que pueda obstruir tu vista mientras colocas otros. Esto es especialmente útil para ocultar el techo o un edificio mientras trabajas en el interior. Los items ocultos solo se ocultan en la ventana Canvas del Scene Editor, no para los jugadores que entran en la escena. Para ocultar un item, búscalo en el entity tree de la izquierda, pasa el cursor sobre él y selecciona el icono del ojo. Puedes activar y desactivar este comportamiento con ese mismo icono.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fb3144eb3c62fc5b632f69e8944f3392e91d8d0e%2Fhide-lock-item.png?alt=media\&token=648fe2be-673c-4890-ac27-c646bac6c28a)

## Properties panel

Selecciona un item haciendo clic en el Canvas o en el entity tree. Entonces verás sus components mostrados en el Properties panel, a la derecha de la pantalla. Los distintos items tienen distintos components que muestran ajustes específicos.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c9c570da87ad3e8ba629f2a0c0b64ea2587a34ac%2Fcomponents-in-editor.png?alt=media\&token=916b4ef9-6a25-4cc9-beaa-553b6ebed067)

La mayoría de los elementos no interactivos tienen los siguientes components:

* **Transform**: Establece la posición, la rotación y la escala del item.
* **GLTF**: Qué modelo 3D cargar.

[Smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) puede incluir otros components.

Consulta [Components](/creator/content-creator-es/scene-editor/construir/components.md) para saber más.

## Limitaciones de la scene

Las escenas de Decentraland deben seguir ciertas limitaciones para poder ejecutarlas unas junto a otras. Hay un número máximo de materials, textures, triangles, etc., proporcional al número de parcels de la escena. Consulta [limitaciones de la escena](/creator/content-creator-es/scenes-sdk7/optimizacion/scene-limitations.md) para más detalles.

Si el contenido de tu escena supera alguno de estos límites, el Scene Editor lo notificará en la esquina inferior izquierda.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88f68a93b0cfcb7f8c48270f31ba7137655ee2e1%2Ftriangle-limit1.png?alt=media\&token=6ba1a8ad-a1e4-472b-b9ca-a3b9d1aab9d8)

Puedes expandir este menú para ver detalles.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aebaad725f1d9397552b2fb36a318eec91589b9c%2Ftriangle-limit2.png?alt=media\&token=65973f60-8eda-4193-9a81-f5a42d4c5032)

{% hint style="info" %}
**💡 Consejo**: Si estás construyendo un Decentraland World, siempre puedes aumentar el [tamaño de la escena](/creator/content-creator-es/scene-editor/configurar/scene-settings.md#layout) para aumentar tus límites.
{% endhint %}

El contenido de una escena de Decentraland también debe evitar derramarse sobre parcelas vecinas. Si alguna parte de los modelos de tu escena se extiende más allá de los límites, cuando abras la vista previa de la escena verás esas partes recortadas. El Scene Editor marcará todo el modelo en rojo, pero en realidad solo debes preocuparte por las partes del modelo que se extienden más allá de los límites de la escena.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5eb877a01228cb5624728411a6bb06d3e0cfa194%2Fout-of-bounds.png?alt=media\&token=8c34ee0f-332c-4f3d-ad72-7a7a8ee04af6)

{% hint style="info" %}
**💡 Consejo**: Si los modelos que quieres mostrar no encajan, quizá quieras aumentar el tamaño de tu escena. Consulta [tamaño de la escena](/creator/content-creator-es/scene-editor/configurar/scene-settings.md#layout) para ampliar tu escena.
{% endhint %}

Incluso si toda la geometría del modelo 3D cabe en tu escena, un modelo puede marcarse en rojo si el Bounding Box se extiende más allá del área. Si este es el caso, puedes ignorar las advertencias, ya que el modelo completo se mostrará correctamente. Aprende más sobre [Bounding Boxes](/creator/content-creator-es/modelado-y-animaciones-3d/meshes.md#bounding-boxes).

## Limpiar assets

Mantén tu proyecto ordenado eliminando los assets que ya no se usan. Abre la **Local Assets** pestaña en la parte inferior de la pantalla y haz clic en el icono del pincel.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01a4d7c5065b98293092e6d7bad815766a62af29%2Fbrush-icon.png?alt=media\&token=834078d5-f08b-44a9-9dd3-413d66ee9a3f)

Se abre un diálogo que enumera todos los assets de tu escena y resalta los que no están referenciados por ningún item.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-496245893e408c868cc77aa4989002aa713c8e71%2Fclean-up-assets.png?alt=media\&token=9ef69edf-2d70-4bec-96c3-dbef10420763)

Selecciona los assets que quieres eliminar usando las casillas de verificación, luego haz clic en **Remove Selected** para eliminarlos permanentemente.

Eliminar un item de la escena no elimina sus archivos. Los modelos importados, texturas o sonidos permanecen en tu proyecto hasta que los limpies, así que revisa periódicamente los assets no utilizados.

{% hint style="warning" %}
**Importante:** Si tu escena contiene código que hace referencia a assets, algunos assets en uso pueden aparecer como no utilizados. Este diálogo solo detecta assets referenciados por components en la UI de Creator Hub. Después de hacer clic en **Remove Selected**, los archivos se eliminan de la carpeta del proyecto; esta acción es permanente y no se puede deshacer.
{% endhint %}

## Configuración de la escena

Haz clic en el **icono de lápiz** en la parte superior derecha de la pantalla. Esto abre una serie de propiedades de nivel de escena para editar.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d2147688ebde75948ba26a9fbe1261f9abdc66c7%2Fpencil-icon.png?alt=media\&token=21677d31-8915-4809-a60a-6674c7497d98)

Aquí puedes configurar varias propiedades, incluyendo el título y la miniatura, el tamaño de la escena, la categoría de la escena y la clasificación por edad, las ubicaciones de aparición del jugador y los interruptores de características.

Consulta [Ajustes de la escena](/creator/content-creator-es/scene-editor/configurar/scene-settings.md).

## Ver también

* Consulta [Smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) para saber cómo añadir interactividad sencilla a tu escena.
* Consulta [Combinar con código](/creator/content-creator-es/scene-editor/extender-con-codigo/overview.md) para ver en detalle cómo editar el código de tu escena.
* Consulta [Publicar escena](/creator/content-creator-es/scene-editor/publicar/publish-scene.md) para saber cómo publicar tu escena en Decentraland.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/scene-editor-essentials.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
