> 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/3d-jian-mo-yu-dong-hua/create-a-rig.md).

# 创建骨架

了解如何为 Decentraland 中的角色创建骨架。

本文介绍如何在 Blender 中设置一个基础骨架。如果你想进一步了解一些绑定概念，请参阅 [《骨架：基本概念》](https://docs.decentraland.org/creator/emotes/avatar-rig/).

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

### 添加骨架

首先，你需要将 3D 模型导入 Blender；如果模型已经是在 Blender 中制作的，直接打开你的 blend 文件即可。在对象模式下，按 `Shift+A` 并在菜单中选择 ***骨架*** ，如下所示。然后，在 ***对象数据属性***&#x7684; ***视图显示***&#x4E2D;，启用 ***前方***，这样就能透过网格看到骨骼。网格和骨架应彼此对齐，因此在添加骨骼前，请确保模型已准确放置在世界中心。骨架的原点应位于 0,0,0 (X,Y,Z)。

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

*添加骨架并使其显示在网格前方。*

### 编辑骨架

添加骨架对象后，选中它并进入 ***编辑模式***。你可以在此通过挤出原始骨骼（按 `E`）、复制骨骼（`Shift+D`），或直接按 `Shift+A`添加新骨骼。骨架应像真实骨骼一样贴合模型的形状。骨骼可以缩放、移动和旋转，并由两部分组成：头部和尾部。头部是枢轴点，也就是说，旋转和缩放都会以此为起点。这也意味着网格会在此处发生变形，因此应尽可能将骨骼放置在网格的中心位置。

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

*骨骼结构。*

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

*骨骼绕其枢轴点旋转。*

现在无需担心创建左右两侧的骨骼。先专注于创建一侧即可。

### 重命名骨骼

请务必记住，所有骨骼都应按照 [Blender 的命名惯例](https://docs.blender.org/manual/en/latest/animation/armatures/bones/editing/naming.html)正确命名。这不仅能让一切井然有序，还能支持镜像姿势和权重绘制。你可以直接按骨骼所代表的身体部位命名，例如 Spine\_01；也可以使用更具体的名称，例如 DEF\_spine.001（DEF 表示变形骨骼，因此你可以知道这根骨骼属于变形层级）。

### 骨骼方向

继续之前，应检查骨骼的方向。进入 ***对象数据属性*** ，然后在 ***视图显示***&#x4E2D;启用 ***坐标轴***。这样会显示骨骼的坐标轴，你就能检查它们是否会沿正确的方向旋转。

坐标轴应与骨骼预期旋转的方向对齐。如果方向不太理想，选中骨骼，然后在视图右侧的 ***项目变换*** 菜单中调整 ***滚转*** ，直到方向合适为止。

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

*修正骨骼滚转。*

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

*启用坐标轴，以查看骨骼的旋转方向。*

修正骨骼滚转对于手指尤为重要，这样所有关节才能朝正确且一致的方向弯曲。不过，无需调整手指上的每一根骨骼，只要调整好其中一根即可。先选中要修正的骨骼，最后选中滚转正确的那根，然后前往 ***骨架 > 骨骼滚转 > 重新计算滚转 > 活动骨骼*** ，这样它们的滚转就会一致。或者，你也可以直接按 `Shift+N` > ***活动骨骼***。在许多情况下都可以使用此功能，例如骨骼链很长时，像是触手、尾巴、长马尾或机械臂。

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

*按下 `Shift+N` 以重新计算骨骼滚转。*

### 镜像骨架

不必为两侧都创建骨骼。先完成一侧，修正所有名称和骨骼方向后，选中要镜像的所有骨骼，点击鼠标右键并选择 ***对称化***。这样所有骨骼都会以正确方向镜像。请记住，此工具要正常工作，骨骼名称必须遵循 Blender 的命名规范。如果名称中包含大写或小写的“L”、“R”、“left”或“right”，Blender 就能正确处理对应骨骼。

以下是符合命名规范的示例：

* Hand\_L –> Hand\_R
* Hand.L –>Hand.R
* HandLeft –> HandRight

**以上示例都有效，但请选择一种并在整个骨架中保持一致。**

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

*使用“对称化”选项镜像骨骼。*

{% hint style="info" %}
**⚠️ 注意！** 只有正确重命名骨骼后，“对称化”才能生效。如果镜像结果不正确，请仔细检查骨骼名称。
{% endhint %}

### 蒙皮

蒙皮是将网格绑定到骨架的过程。为此，请在 ***物体模式***&#x4E0B;先选中网格，再选中骨架，然后按 `CTRL+P` > ***骨架变形 > 使用自动权重。*** 然后进入 ***姿态模式*** 并尝试不同姿势，测试网格的变形效果。通常还需要进行一些调整，如下所示。

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

*要进行蒙皮，请按 `CTRL+P` 将网格设为骨架的子级，然后在姿态模式下进行测试。*

如果觉得某根骨骼的位置不正确，或枢轴点不准确，可以随时返回骨架的 ***编辑模式*** 进行调整。这完全不会影响蒙皮，你也可以随时使用 ***对称化*** 来镜像这些更改。

要修正异常变形，请进入 ***物体模式***，选中网格并进入 ***权重绘制***。在 ***物体数据属性*** 中可以找到 ***顶点组***.

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

*在权重绘制模式下编辑骨骼的影响范围。*

开始编辑前，如果希望绘制权重时自动镜像，请启用 ***镜像顶点组*** 并在 ***X*** 中选择 ***镜像*** 在 ***对称*** （在 Blender 3.4.0 中）要编辑影响设置，请选择所需的顶点组，然后在 ***工具*** 菜单的 ***混合***&#x4E0B;，在 ***添加*** 和 ***减去*** 之间切换。你还可以调整笔刷的大小、权重和强度。

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

*将混合模式改为添加或移除影响。确认对称设置正确。*

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

使用屏幕左侧的 ***模糊*** 工具来平滑权重绘制，使其更加均匀。

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

*模糊工具。*

### 设置 IK

如果希望某个部位保持在原位，IK 就非常重要。腿部是最典型的应用场景，但它也适用于各种情况，例如以下示例：

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

*IK 在机械臂上的应用。*

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

*IK 在线缆上的应用。*

由于 IK 会改变骨骼层级，最好将其设置为独立配置。因此，首先需要复制受 IK 影响的骨骼链。以腿部为例：选中骨骼，按 `Shift+D` 复制它们，然后按 `M` 并选择另一个图层槽位，将它们移到其他图层。

记得重命名复制的骨骼，在名称中添加 IK，以便识别它们属于 IK 设置。由于它们不应使网格变形，请全选这些骨骼，然后在 ***骨骼属性***&#x4E2D;按住 `Alt` 并取消勾选 ***变形***.

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

*复制骨骼，并将它们移到另一个图层。*

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

*选中所有 IK 骨骼，然后按住 `Alt`并取消勾选“变形”。*

接下来，需要创建一根用于驱动 IK 链的骨骼。选中脚部骨骼的头部，并沿 Y 轴挤出。然后按 `Alt+P` 取消其父级关系，因为 IK 骨骼不能属于该骨骼链，也不能与其他骨骼连接。你需要将脚部设为 IK 骨骼的子级，因此先选中脚部骨骼，再最后选中 IK 骨骼，然后按 `CTRL+P` > ***保持偏移***.

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

*创建 IK 骨骼。*

在 ***姿态模式***&#x4E2D;，点击小腿骨骼，按 `CTRL+Shift+C` 并选择 ***反向运动学***。此时看起来会一团糟，不过不用担心，调整几个设置后就会恢复正常。选中小腿骨骼后，前往下方所示的 ***骨骼约束属性*** 。

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

*在骨骼约束属性中，可以编辑 IK 设置。*

对于 ***目标***，选择 ***骨架***。完成后，目标下方会出现一个名为 ***骨骼*** 的选项。请选择你创建的 IK 骨骼。在 ***链长*** 中设置 IK 应影响的骨骼数量。由于我们要制作腿部，因此希望它影响小腿和大腿，所以将其设为 ***2***.

### 极向目标

极向目标可控制骨骼弯曲的方向。以下是为 IK 链正确添加极向目标（或极向量）的步骤：

* 在 ***编辑模式***&#x4E0B;，复制大腿骨骼并将其放置在任意位置。
* 选择膝关节（或大腿骨骼的尾端），按 `Shift+S` > ***游标到所选项。***
* 选中复制的大腿骨骼，按 `Shift+S` > ***所选项到游标***.
* 在 ***变换方向***&#x4E2D;，将其改为 ***法线*** ，然后在 ***变换轴心点*** 中将其改为 ***活动元素***.
* 将骨骼绕 X 轴旋转 -90 度（或 90 度，具体取决于你设置的方向），使其朝前，然后沿 Y 轴移动，直到它位于腿前方合适的位置。你也可以稍微缩小它。

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

*创建极向目标。*

回到 ***姿态模式***，再次选中小腿，然后前往 ***骨骼约束属性***。对于 ***极向目标*** ，选择 ***骨架*** ；对于 ***骨骼***，选择刚才创建的极向目标骨骼。如果显示变形骨骼，就会看到极向目标使 IK 稍微旋转了一些。

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

*由于极向目标的作用，IK 链与变形骨骼不再对齐。*

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

*可以通过调整极向角来修正旋转。*

只需更改 ***极向角***&#x5373;可轻松修正。通常设为 -90° 就能解决问题，但你也可以手动调整，确保它们完全对齐。

最后，同时选中 IK 骨骼和极向目标，再选中根骨骼，按 `CTRL+P` > ***保持偏移***.

将大腿和小腿移到另一个层，因为动画时不需要它们，它们只是 IK 设置的一部分。

### 将变形骨骼绑定到非变形骨骼

IK 链已经设置完毕，但它应该驱动变形骨骼；目前还没有实现这一点，不过可以使用约束来解决。在 ***姿态模式***&#x4E2D;，先选择 IK 链中的一根骨骼，最后选择对应的变形骨骼，按下 `CTRL+Shift+C` 并选择 ***复制变换***。对所有骨骼执行此操作，示例中包括大腿、小腿、脚和脚趾。变形骨骼会显示为绿色，表示它们带有约束。点击 ***骨骼约束属性***，即可查看使用了哪种约束，以及由哪根骨骼驱动。

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

*绿色骨骼带有约束。可以在“骨骼约束属性”中查看。*

{% hint style="info" %}
**💡 提示**：另一侧不必重新设置 IK。在 *编辑模式*中，只需删除没有 IK 的那一侧的所有骨骼，然后选中要镜像的所有变形骨骼和 IK 链，右键单击并选择 *对称化*。这不仅会镜像骨骼，还会镜像所有约束！
{% endhint %}

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

*使用“对称化”选项也可以镜像约束！*

### 非变形骨架与控制器\*\*

通常不应直接为变形骨骼制作动画，因为这可能会破坏绑定；此外，向变形骨架添加约束会影响层级结构以及导出时的骨骼行为。

解决方法是创建一个非变形骨架，通过约束来驱动变形骨架。这样就可以安全地为其制作动画，而不必担心破坏任何内容。你还可以自定义骨骼形状，以便更容易辨认其功能。它们将作为绑定的控制器。

此操作的流程与设置 IK 基本相同。使用 `Shift+D` 复制所有骨骼（IK 设置除外），然后按 `M` 并选择另一个槽位，将它们移到其他层。为所有骨骼重命名，在名称前添加 **Control\_** 或 **CTRL\_** ，以便知道它们属于控制器层级。按 `A` 全选，然后在 ***骨骼属性***&#x4E2D;，按住 `Alt` 并取消勾选 ***变形***.

现在需要添加约束，将两个骨架连接起来。为了简化这一过程，可以点击 ***物体数据属性*** ，然后在 ***视图显示***&#x4E0B;，将 ***显示为*** 从 ***八面体*** 改为 ***B 骨段***。然后按下 `CTRL+Alt+S` 将骨骼稍微放大一些，使其比原来的骨骼更大。

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

*更改骨骼形状并将其放大，以便更容易区分这两套骨架。*

设置约束时，先选择控制骨骼，再选择对应的变形骨骼，然后按 `CTRL+Shift+C` 并选择 ***复制变换***。对所有控制骨骼重复此操作。

你可以将控制骨骼分成不同的组并为其指定颜色。转到 ***姿态模式*** > ***对象数据属性*** > ***骨骼组***。点击 ***+*** 图标以添加新组，根据需要为其重命名并选择颜色。然后选择要加入该组的骨骼，并点击 ***分配***。你可以根据需要创建任意数量的组，让所有内容井然有序。你也可以将不同的骨骼组移到不同的图层。

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

*骨骼组有助于让绑定井然有序、更加直观。*

自定义骨骼形状是改进绑定的另一种方法。为此，请转到 ***物体模式***，按 `Shift+A` 添加一个网格物体，例如圆形。为保持井然有序，请为形状创建一个集合，并将刚创建的圆形移入其中。返回姿态模式，然后在 ***对象数据属性*** > ***视口显示*** 勾选 ***形状***。选择所需的骨骼，然后在 ***骨骼属性***&#x4E2D;点击 ***视口显示*** > ***自定义形状***。在 ***自定义物体***&#x4E2D;，从大纲视图中选择圆形。

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

*自定义骨骼形状。*

如果形状看起来不太合适，你可以随时在 ***编辑模式***&#x4E2D;进行编辑，如下所示。确保形状与骨骼的朝向一致。

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

*在编辑模式中编辑形状。*

根据不同控制器的功能为其创建不同形状，让绑定更加直观。

### 弹簧骨骼

除了标准的变形骨架外，可穿戴物也可以包含 **弹簧骨骼** ——这些额外的骨骼，其变换由物理模拟而非动画驱动。弹簧骨骼能让头发、耳环、披风和其他配饰随着化身的运动和重力动态摆动。

向绑定添加弹簧骨骼的步骤：

1. 在 **编辑模式**中，从合适的父骨骼挤出新骨骼（例如，头发可以从 `Avatar_Head` 挤出）。
2. 为每根骨骼命名，并在名称中包含 `springbone` 名称中（不区分大小写），例如： `SpringBone_hair_left`, `springbone_hair_left_01`, `Hair_SpringBone_left_tip` 只要包含 `springbone`.
3. 构建 **线性链** 至少由 **2 根骨骼** （一根根骨骼和一根末端骨骼）组成。单独一根弹簧骨骼不会产生任何运动——模拟需要一条骨骼链，其中根骨骼驱动物理效果，末端骨骼定义终点。链中的每根骨骼最多只能有一根弹簧骨骼子级。
4. 像往常一样，将网格的蒙皮权重分配给弹簧骨骼。
5. 导出为 `.glb` ——弹簧骨骼将包含在骨架中。

物理参数（刚度、重力、阻力）在上传后于构建器中配置，而不是在 Blender 中。完整指南请参阅 [弹簧骨骼](https://docs.decentraland.org/creator/wearables-and-emotes/wearables/spring-bones).

就这样！掌握了这些信息，你就可以开始进行基础绑定了！


---

# 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/3d-jian-mo-yu-dong-hua/create-a-rig.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.
