> 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-zh/chuan-dai-wu-yu-biao-qing-dong-zuo/biao-qing-dong-zuo/creating-emotes.md).

# 创建表情动作

创建 Decentraland 表情动作的技巧与指南。

本文档将介绍文件规格、Blender 动画基础、正确导出表情动画的方法，以及如何将其导入 Builder。

{% hint style="info" %}
**💡 提示**：安装 [Decentraland Tools Blender 插件](https://extensions.blender.org/add-ons/decentraland-tools/)。该插件包含多种实用功能，可帮助你编辑和导出 3D 模型、可穿戴物品和表情动画。
{% endhint %}

#### 动画规格表

| 帧速率        | 30 fps              |
| ---------- | ------------------- |
| 最长时长       | 10 秒（300 帧）         |
| 每个文件中的动画数量 | 1                   |
| 导出格式       | .glb                |
| 采样率        | 默认为 1（必要时可设为 2 或 3） |
| 最大文件大小     | 3 MB                |
| 最大动画距离     | 1 米（前后、左右）          |
| 最大动画高度     | 4 米                 |

你可以在下方找到关于动画规格的更详细说明 [**下方**](#the-animation-specifications).

### **资源**

本文档介绍 Rig 1.0 的设置、控件和功能。

[Decentraland Blender Rig](https://github.com/decentraland/docs/tree/main/creator/images/emotes/Avatar_File.blend)

{% hint style="info" %}
如果你使用 Maya，可以下载此 [Maya Rig](https://github.com/decentraland/docs/tree/main/creator/images/emotes/DCL_Maya_Rig.ma) 和 [选择器](https://github.com/decentraland/docs/tree/main/creator/images/emotes/emoteAvatar.pkr) 由 [SparkleStudios](https://www.sparkles.studio/) 提供 ❤️。
{% endhint %}

## **开始之前**

### **帧速率**

开始之前，请务必检查帧速率。Decentraland 的动画帧速率必须为 30 fps。Rig 文件默认设置为 24 fps，因此请在制作动画前将其改为 30（帧速率不正确会影响动画速度）。如下图所示，可在“输出属性”（打印机图标）的“格式”下找到此选项：

![开始前，请确保帧速率设为 30 fps。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/framerate.png)

开始前，请确保帧速率设为 30 fps。

### **姿态模式**

在 Blender 中，Rig 有三种模式：物体模式、编辑模式和姿态模式。动画只能在姿态模式下制作（在此模式中，控件会显示颜色）。选中 Rig 后，你可以在右上方的下拉菜单中找到该选项。

![切换到姿态模式。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/changing_pose_mode.gif)

切换到姿态模式。

### **动画界面**

在 Rig 文件中，除了两个视口窗口（正视图和侧视图）外，底部还有另外三个窗口：一个 ***曲线编辑器***, ***一个 Dope Sheet***，以及一个 ***时间轴***.

* ***曲线编辑器***：在此编辑器中，可以编辑所选控件各个变换属性的动画曲线。这些曲线显示插值的计算方式，你可以编辑它们以实现动画中所需的效果。此处和 Dope Sheet 中的 ***仅显示所选项*** 工具处于启用状态，这意味着它只会显示与所选控件相关的通道。只需点击箭头图标即可启用或关闭此选项。
* ***Dope Sheet***：在这里可以编辑关键帧，也可以创建新的动画或浏览已创建的多个动画。请注意，要访问动画，必须选中 ***动作编辑器*** 。此选项位于 *Dope Sheet* 图标旁边的下拉菜单中。
* ***时间轴***：时间轴和播放控件位于这里。在此处， ***自动插入关键帧*** 处于启用状态，这意味着每次操作控制器时，都会自动创建关键帧。你也可以随时点击播放控件旁边的圆点来停用此功能。

使用此工作区，你就具备了开始制作动画所需的一切！

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-03350a89b325d84bc6d310efe4b58ba65921058f%2Fworkspace.webp?alt=media)

这些是底部的窗口。最上方的是 ***曲线编辑器，*** 中间的是 ***摄影表，*** 最下方的是 ***时间轴。*** 上方的红色箭头指向 ***仅显示选中项*** 工具，下方的箭头指向 ***自动插入关键帧***.

{% hint style="info" %}
**💡 提示！**

由于 Blender 的可自定义程度很高，现在也是设置最适合自己的布局的好时机。你可以添加、调整或移除窗口。每位动画师都有自己的偏好，因此可以随心所欲地编辑布局！
{% endhint %}

## 入门

#### **起始姿势**

在提供的绑定文件中，已经有一个名为 ***Starting\_Pose***&#x7684;动作。考虑到所有 Avatar 动作都从待机姿势开始， **我们强烈建议从该姿势开始制作动画，并在最后一帧再次使用该姿势**。这样可以让从待机状态过渡到表情动作时更加自然，动画也更加流畅。

{% hint style="info" %}
**💡 提示！**

如果要制作循环动画，则不必从起始姿势开始。欢迎使用最适合你的动画的姿势！\*\*
{% endhint %}

要让循环播放流畅，首尾关键帧必须完全一致。例如，30 fps、时长 4 秒的循环动画，第 1 帧和第 121 帧必须使用相同的姿势。只要两者存在差异，片段每次重复播放时，玩家都会看到明显的跳变。

#### 动画区域 <a href="#ground-reference-and-animation-area" id="ground-reference-and-animation-area"></a>

在提供的 Avatar 文件中，你会找到一个名为 ***Animation\_Area\_Reference***&#x7684;集合。其中包含三个对象，可帮助你直观地设置动画范围： ***Animation\_Area\_Reference***, ***Ground\_Reference*** 和 ***Root\_Animation\_Area***.

* Animation\_Area\_Reference 是一个 4×4 的立方体，也就是边界框。在整个动画过程中，Avatar 网格和道具都应保持在此区域内。只要不超出立方体范围，道具可以自由移动。
* Ground\_Reference 是一个平面，可用于检查动画过程中是否有物体穿透地面。它还包含重要信息：较小的圆直径为 2 米，标示了 Avatar 根节点可移动的范围。这意味着 Avatar 在地面上时，只能向前、向后、向左和向右各移动 1 米。
* Root\_Animation\_Area 是一个圆柱体，标示了 Avatar 根节点/重心（CTRL\_Avatar\_UpperBody 或 Avatar\_Hips）可移动的范围。圆柱体高 4 米，这意味着只要没有网格超出边界框，根节点就可以一直向上移动。Avatar 的腿、手臂和其他身体部位可以超出圆柱体范围，但绝不能超出 Animation\_Area\_Reference。

![动画区域参考。](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cb07d8271e7dd52914a609671f9f79966e7e94ee%2FAnimation_area.webp?alt=media)

总而言之，Avatar 可以向右、向左、向前和向后移动，只要根节点保持在圆柱体内即可，也就是说，四个方向各可移动 1 米。

![Avatar 的移动。](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-37c55753bf37c2df6761e6aa8af1be4614800f64%2Favatar_movement.webp?alt=media)

至于高度，只要 Avatar 保持在边界框内，就可以一直向上移动（最高 4 米）。下方展示了一些高度设置正确的示例（整个身体都在边界框内）和错误的示例（网格超出边界框）。

| ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9dbcadaed65d104f9a1f2c6b20baa87ef7555593%2Fheight_right_1.webp?alt=media) | ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ae307de92484215014c3a147302c3a3222c14ffa%2Fheight_right_2.webp?alt=media) |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ebebd9241a49ede68332ee09786c6d0d198bf826%2Fheight_right_3.webp?alt=media) | ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-adf3eb2b6b8548013987586fca8b1e3fc5c3df6b%2Fheight_wrong_1.webp?alt=media) |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a97e12a99a869d71689c351970bae151a0707afa%2Fheight_wrong_2.webp?alt=media)

以下是一些动作表情未超出动画区域边界的示例。

| ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6675439f56630b35a68b21fec306b0b4a73fc27e%2Fwhack-a-frog.webp?alt=media) | ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c2f943f681d9e30de667840508900e82b14eba6b%2Flove-grenade.webp?alt=media) |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

{% hint style="info" %}
**💡 注意！**

请留意这些边界，超出边界可能会导致游戏玩法出现问题。
{% endhint %}

## **创建动画**

blend 文件中已有一个可供编辑的动画片段： *StartingPose\_Avatar*。你可以根据需要复制并重命名该动画片段。无需从头创建！

在 *浏览动作* 部分中，只需点击 ***创建新动作*** 按钮，即可复制当前动画。要重命名动画片段，只需点击文本并输入新名称。

Belnder 4.4 引入了 *插槽动作*，它是之前版本中 *浏览动作* 部分右侧的图标。如果你要创建不带道具的表情动作，无需调整此项，保持原样即可。如果你要为虚拟形象制作动画，请确保插槽动作是 Avatar\_Animation。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c3944b17eefcefce8bb7643bdd4e7fd3d3bb73cc%2Fduplicating_animation.webp?alt=media)

通过复制现有动画或点击 ***取消关联动作*** ，然后点击 ***新建***.

### **浏览和删除动画**

在 Blender 中，同一文件可以包含多个动画轨道。点击“浏览动作”下拉菜单即可浏览这些动画。带有 F（虚拟用户）的动画都会被保存。要删除动画，请按住键盘上的 Shift 并点击 X。完成后，动画旁边会显示 0，这表示下次关闭 Blender 或重新打开文件时，该动画将被删除。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3a9b4f6cc5d4842bb7973db7b408ef6d8b466dc5%2Fdeleting_animation.webp?alt=media)

浏览动画：带有 F 的动画会被保存，带有 0 的动画会被删除。

无需重新加载 Blender 即可删除动画的另一种方法，是将“显示模式”从“视图层”切换为“Blender 文件”。展开 Actions，右键点击不需要的动画并选择“删除”。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-76b031b95300da65fd44a77bf8df913329854298%2Fdeleting_animation2.webp?alt=media)

你可以在大纲视图的“显示模式”下，从“Blender 文件”中直接删除动画。

{% hint style="info" %}
**💡 提示！**

不要总是编辑同一个动画轨道。进行重大修改之前，先复制动画。这样，如果你后悔删除或更改了某些内容，还可以使用备份版本。这也是记录当前进度的好方法！
{% endhint %}

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c3944b17eefcefce8bb7643bdd4e7fd3d3bb73cc%2Fduplicating_animation.webp?alt=media)

复制动画片段。

### **命名**

**动画名称应以大写字母开头；如果名称由多个单词组成，单词之间应使用 \_ 分隔。** 不要使用空格或特殊字符。以下是一些命名示例：

* Snowfall
* Rainbow\_Dance
* Throw\_Money
* Talk\_To\_Hand

### **表情动作覆盖**

当变形骨骼的某个参数没有设置关键帧时，就会发生表情动作覆盖。没有关键帧，该骨骼就不会记录其位置、旋转和缩放信息，从而使对应通道处于开放状态。因此，如果你在世界中播放一个表情动作，而上一个动作尚未播放完毕时又触发了自己的动作，上一个表情动作的位置、旋转和缩放信息就会覆盖当前动作，导致两个动作叠加。除非这是有意为之，否则它会影响你的动画；有时结果会很有趣，但也可能彻底打乱表情动作。下面是表情动作覆盖的示例。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-59ca95d9f92fc7f25dd570267f32399099763f65%2F01_emote_override.webp?alt=media)

为避免这种情况，请选中所有包含骨骼的图层（可在 ***对象数据属性*** > ***骨架*** > ***图层***&#x4E2D;找到）。然后，在 ***姿态模式***&#x4E0B;，将时间轴光标停留在动画的第一帧，并将鼠标置于 ***视图显示***&#x4E2D;，按 ***A*** 以全选。在 ***曲线编辑器***&#x4E2D;，双击骨架通道旁的 ***眼睛*** 图标，以显示所有通道。选中所有骨骼后，按 ***I*** 设置关键帧。对最后一帧也执行相同操作。

**请务必选中变形骨骼，这一点尤其重要！** 变形骨骼位于最底部的图层中，在 ***视口***.

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d9c0340bf07e6dc3b2e32d0b11e6d05bbd501361%2Fkeyframe_bones.webp?alt=media) 在第一帧和最后一帧为所有骨骼设置关键帧，可防止表情被覆盖。

## **动画规格**

### **动画时长**

动画的最长时长为 **10 秒** 或 **300 帧**。请记得在第一帧和最后一帧为每个控制器的属性都设置关键帧。

{% hint style="warning" %}
⚠️ 在图表编辑器中关闭可见性的通道不会被设置关键帧或删除，甚至不会显示在动作编辑器中。除非这是有意为之，否则请特别留意通道的可见性。
{% endhint %}

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a45fb03aa3f728652b37a59b800739f33ec63035%2Fchannel_visibility.webp?alt=media)

设置关键帧前，请先显示通道！

### **动画数量**

如果是标准表情（不带道具），导出的文件只能包含一个动画。对于 2.0 表情，可以分别为化身和道具各添加一个片段。如果在制作过程中复制了动画，请务必在导出前将其全部删除，只保留最终版本。目前不支持需要多个动画才能运行的序列式表情（动作开始、动作循环和动作结束）。

### **格式**

动画应导出为 .**GLB**。文件只能包含变形骨架和动画。 **请勿导出网格、控制器或任何其他对象**。有关导出方法的更多详情，请见 [**下文**](#exporting).

### **采样**

由于约束无法导出，导出动画片段的唯一方法是烘焙。也就是说，动画的每一帧都会为所有变形骨骼的位置、旋转和缩放设置关键帧。如果片段过长（例如达到 300 帧），导出后就会有 300 个关键帧；关键帧越多，文件就越大。

采样是优化动画的一种有效方法。采样率决定动画中烘焙关键帧的频率。例如，采样率设为 2，表示每两帧创建一个关键帧；采样率设为 3，则每三帧烘焙一个关键帧，以此类推。采样率越高，文件越小。

不过，这样做的缺点是动画会变得越来越不流畅，因为它会丢失一些重要关键帧（这些关键帧在动画中的分布并不均匀）。还要注意， **采样并不是将动画的帧数除以采样率**.

通常， **采样率设为 2 或 3** 就足够了。这些数值可以优化动画，同时不影响质量。

{% hint style="info" %}
**💡 提示！**

如果动画帧数能够被采样率整除，那就更好了！这意味着最后一帧也会被烘焙，从而保留动画从结尾过渡回开头的效果。
{% endhint %}

### **文件大小**

文件大小上限为 **3 MB**。如果导出后的文件超过此大小，请检查是否误将网格导出，或动画时长是否超过 10 秒。如果文件仍超过 3 MB，可以尝试调整采样率；提高采样率可以进一步优化文件。

如果表情包含任何额外的 3D 模型，这些模型中的纹理尺寸不得超过 1024 像素。

## **导出**

由于我们只需要导出骨架和动画，请在导出前关闭网格以及除骨架以外所有对象的可见性，如下所示：

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7b50f5537388e54aba7365b5d805c70da1eedeca%2Fmesh_visibility.webp?alt=media)

导出前请关闭网格的可见性！

文件中也只能包含你要导出的那个动作。此绑定附带一个 `Starting_Pose` 动作，因此请 [将其删除](#browsing-and-deleting-animations) ，并删除其他所有遗留动作，否则导出的 `.glb` 文件会包含两个片段，而不是 Decentraland 所要求的 [每个文件包含一个动画](#number-of-animations) 。在移除任何内容之前，请先保存一份可编辑的 `.blend` 副本。

要导出，请依次选择 *文件* > *导出* > *glTF2.0 (.glb, .gltf)*

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5b4b7b482e3072e7b9d9422c7c1e8a982cfe2c08%2Fexport_gltf.webp?alt=media)

对于导出设置，展开 Include，并在 Limit to 中切换 Visible Objects。然后展开 Data 选项卡，展开 Armature，并启用 Export Deformation Bones Only。

| ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-903e8131757b96684bb0ca551c3a4e6ca9a55222%2Fexport_settings.webp?alt=media) | ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5a3e4e4e3f8ba808fda634d9926baf92db803162%2Fexport_settings_GIF.webp?alt=media) |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

如果需要对动画进行采样，请展开 Animation 选项卡，再展开 Sampling Animations，并选择所需的采样数。

| ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-889044f1a7d8c8f282acc28cbb8347fc71ec46bd%2Fsampling_rate.webp?alt=media) | ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-43e815217f6bb5fbe49969491da05942621df152%2Fsampling_rate_GIF.webp?alt=media) |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

动画导出就完成了！

## 参考资料

如果你还不确定该从哪里开始，或者需要一些参考或灵感，这里有一些动画片段可以帮到你。它们也很适合用来学习！

[Idle.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/idle.glb)

[Jump.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/jump.glb)

[Walk.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/walk.glb)

[Run.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/run.glb)

[Pose\_Jump.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/pose_jump.glb)

[Pose\_Spin.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/pose_spin.glb)

[Spotlight.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/spotlight.glb)

[Fashionista.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/fashionista.glb)

[Chic.glb](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/chic.glb)

[Flag\_Emote.glb](https://github.com/decentraland/docs/tree/main/creator/images/emotes/Flag_Emote.glb)

[Flag\_Emote.blend](https://github.com/decentraland/docs/tree/main/creator/images/emotes/Flag_Emote_Final.blend)


---

# 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-zh/chuan-dai-wu-yu-biao-qing-dong-zuo/biao-qing-dong-zuo/creating-emotes.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.
