> 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/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items.md). # 智能物品 - 基础 在场景中使用智能物品来增加交互性。 场景编辑器目录中的一些物品包括 **智能物品**。玩家可以与它们交互，它们具有可配置的属性，并且可以触发其他智能物品上的动作。例如：可打开和关闭的门、上下移动的平台，或者可以激活其他物品的按钮和拉杆。 {% embed url="" %} 你可以在资源包浏览器中认出这些物品，因为它们带有闪电图标和不同颜色的背景。 ![](https://2460066822-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) 你可以在实体树中通过物品旁边的闪电图标识别场景里的哪些物品是智能物品。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-26c0c6fbe09714f92806651fe637acf153da0e80%2Fsmart-item-icon.png?alt=media\&token=d728c0a2-a90f-4dfd-993f-f65649059821) ## 使用物品 要使用智能物品，只需像其他物品一样把它拖到场景中。所有物品都包含默认行为，运行场景预览即可试用。 以下是一些常见物品及其默认行为： * **门**：门在点击时会打开或关闭。你可以更改此行为，让它们由按钮、触发区域等打开。 * **按钮**：点击时，它们会播放声音和动画作为反馈。向它们的触发事件添加更多动作，以激活其他智能物品。 * **拉杆**：点击时，它们会在两种状态之间切换。让拉杆的每个位置对其他智能物品执行不同的动作。 * **宝箱**：它们的行为类似于门，默认在点击时打开或关闭。你可以在其中放置更小的物品。 * **平台**：它们在两个位置之间移动。使用它们的补间动作来控制移动到哪里、速度等。 * **触发区域**：一种不可见的物品，当玩家走入其区域时可以触发其他智能物品。参见 [关于触发区域](#trigger-areas). * **Avatar 修改区域**：一种不可见区域，会改变头像在其中的行为或外观，例如隐藏头像或禁用护照弹窗。参见 [修改区域](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/modifier-areas.md). * **摄像机修改区域**：一种不可见区域，会强制玩家的摄像机在其中处于第一人称或第三人称视角。参见 [修改区域](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/modifier-areas.md). * **视频播放器**：用于显示视频或直播流的屏幕。参见 [播放视频](#playing-videos). * **音频流**：从直播流播放音频。参见 [播放音频流](#playing-audio-streams) * **NFT**：将 NFT 图像以肖像形式显示。参见 [显示 NFT](#displaying-nfts) * **地板压力按钮**：一个圆形压板，玩家站上去时会下沉，离开时会弹起。使用其 **按下时** 和 **松开时** 钩子来运行动作，例如在有人站在上面时让门保持打开。 * **水面平面** 和 **水柱**：玩家走进或跳进时会产生飞溅的水面。参见 [水](#water). 所有智能物品都可以配置为以自定义方式行为。例如平台移动多远，或者按钮激活什么。 ## 配置物品 在场景编辑器中选择一个物品，即可在右侧查看其所有属性。 大多数智能物品将其行为保存在 [脚本组件](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-yong-dai-ma-kuo-zhan/script-component.md)中。它们的设置会显示在 **脚本** 面板中，每个参数对应一个字段，每个字段都有一个工具提示来解释其作用。使用它们时不需要编写任何代码。 许多物品中都能找到的一些典型字段包括： * **悬停文本**：当玩家将光标移到物品上方时，UI 上显示的提示文字。例如，门可能会显示“打开” * **交互**：使用哪个按钮激活该物品？在普通键盘上： * **主操作** 是 **E** * **次操作** 是 **F** * **指针** 是 **鼠标左键** * **动作3** 对应按键为 **1** * **动作4** 对应按键为 **2** * **动作5** 对应按键为 **3** * **动作6** 对应按键为 **4** * **对物品作出反应的钩子**：你在这些参数中选择一个动作，以便在特定时刻运行。物品有哪些钩子取决于它的作用。按钮有 **onClick**，拉杆有 **onActivate** 和 **onDeactivate**，移动平台有 **onReachStart** 和 **onReachEnd**，铃铛有 **onRing**。将钩子留空，则在该时刻不会发生任何事情。 每个物品都有自己特定的设置，这些设置可能因物品而异。 少数物品仍保留旧的 **配置** 面板。例如，灯光仍在那里面设置颜色和强度。 所有物品都有一个 **高级模式** ，它允许你几乎配置它们的任何内容。包括播放哪些声音、平台朝哪个方向移动等。你还可以添加自定义动作，包含各种内容，比如传送玩家、播放头像动画、把物品绑定到玩家手上等等。你还可以添加条件逻辑，只在某些场景下激活某些内容。参见 [智能物品 - 高级](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items-advanced.md). ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-958f6f53945e119e770d84f808814c18d173c9c1%2Fadvanced-mode.png?alt=media\&token=978e65ee-3cf8-49ce-a477-1523e2a6f714) ## 在另一个物品上调用动作 智能物品可以在其他智能物品上触发动作，因此每次该物品被激活时都会发生相应效果。只需从场景中所有物品的列表里选择你要调用的物品，然后选择一个动作。不同物品会提供不同的动作。 例如，这里有一个按钮可以打开或关闭一扇门。每次按下按钮时，门都会打开或关闭。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-110156bc3c8fa17336e61490402e1cb19d83ff47%2Fbutton-to-door.png?alt=media\&token=1e558a4c-9887-435c-96c7-866d51a89cbd) 这里有一个拉杆，激活时会打开门，停用时会关闭那扇门。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6e4cb24dd1b7e3e9b438b8825c0479672bc2254c%2Flever-to-door.png?alt=media\&token=2cd5aa81-5ea8-4f08-8cc8-d4ab0c666a6c) 你可以添加来自不同物品的任意多个不同动作，让它们一起触发。只需点击 **+ 分配动作**. 通过点击某个动作旁边的三个点并选择 *移除动作*. 即可移除动作。物品提供的动作仍保持其熟悉的名称，例如 **打开**, **关闭**, **坐在这里**, **开启**，或 **传送**，因此物品之间的连线方式和一直以来一样。 你也可以将动作串联起来。例如，如果拉杆的 **onActivate** 会打开一扇门，而那扇门自身的钩子又触发了别的东西，那么拉杆就会间接触发整个链条。 如果你使用 [高级模式](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items-advanced.md) ，也可以为这类动作添加条件逻辑。 ## 特殊智能物品 某些智能物品具有独特特性，使它们在常见场景中特别实用： ### 触发区域 使用触发区域智能物品，在玩家走入某个区域时触发动作。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-649dfd99d06849f543399b5b89a6a31a015cb439%2Ftrigger.png?alt=media\&token=cbc5fb9b-ecff-4733-b799-38b59244f78b) 将它拖入场景，调整盒体或球体大小以覆盖你想要的区域，然后使用 **当玩家进入……** 和 **当玩家离开……** 按钮在其 **反应** 部分中描述应发生的事情。 [AI 助手](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-yong-dai-ma-kuo-zhan/ai-assistant.md) 会为你编写脚本。参见 [触发区域](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/trigger-area.md) 获取完整演练。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f8389cd077c495e0b8ada33ca0da01800eee7dcd%2Fon_player_enters.png?alt=media\&token=5e0a4e67-34a4-4a69-851e-e8745be16fa2) 参见 [触发区域](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/trigger-area.md) 了解更多信息。 ### 隐形墙 一组不可见的形状，可阻止玩家穿过某个区域或在其上点击。 当导入没有碰撞体网格的 3D 模型时，或者当你想创建玩家看不见的墙时，这些隐形墙会很有用。 参见 [碰撞体](/creator/content-creator-zh/chang-jing-sdk7/3d-nei-rong-ji-chu/colliders.md) 了解更多信息。 ### 点击区域 一个不可见的立方体，玩家可以点击它来触发任何其他智能物品上的动作。该物品可以被其他智能物品启用或禁用；禁用时它将不可点击。你也可以设置玩家将光标指向它时看到的文字。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e8ab432fd689e68f097f47e600c1789404f7ee4c%2Fclick-area.png?alt=media\&token=62f3aae5-fa22-413b-8d09-adeab8a24b70) ### 座位 椅子、长凳和其他座位可让玩家通过点击坐下。 * 座位只有在占用它的玩家 **离开** 超过 1.5 米后才会空出。 * 对于像长凳这样有多个位置的物品，点击后会让你坐在 **最近的空位**. * 当所有位置都被占用时，悬停文本会显示 **座位已被占用** ，并且点击不会有任何效果。 ### 水 在 **材料** 类别下，有两个可让玩家在其中拍打水花的水体物品： * **水面平面**：一个平坦的 16 x 16 米表面。可按比例缩放以覆盖池塘、运河或海面。 * **水柱**：一个圆形水池，宽 8 米、深 2 米。 当玩家走进或跳进时，两者都会产生飞溅效果。你可以设置： * **激活者**: `我的玩家` 这样只有你能看到自己的水花，或者 `所有玩家` 这样每个头像都会溅起水花。 * **深度**：溅水区域到水面以下有多深，单位为米。它不会延伸到水池底部以下。 * **飞溅大小**：飞溅效果的大小，单位为米。 * **声音**：物品文件夹中音频文件的名称，每次飞溅时都会播放。留空则为无声水体。 它们还提供 **进入** 和 **离开** 事件，以及一个 **飞溅** 动作，可按需让水中央产生一次飞溅。 {% hint style="warning" %} **📔 注意**：每个水层都需要自己的法线贴图。没有法线贴图的层将不再动画，如果没有剩余层，溅水区域会缩小到 1 x 1 米。 {% endhint %} ### 传送点 该 **传送** 物品在玩家与其交互时会把玩家送到别处。 设置 **x** 和 **y** 参数即可将他们发送到 Genesis City 中的某个地块。要将他们发送到一个 [世界](/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing-options.md#decentraland-worlds) ，请填写 **world** 参数，值为世界名称，例如 `myname.dcl.eth`，并将坐标留空。 {% hint style="warning" %} **📔 注意**：以前有一个单独的 **世界传送** 物品。它已被移除。请改用 **传送** 物品及其 **world** 参数。 {% endhint %} ### 移动设置 该 **移动设置** 物品会改变玩家在场景中的移动速度和跳跃高度。可用它让场景更有漂浮感、在博物馆里减慢玩家速度，或者在大地图中加快他们的移动。 将它拖到场景中的任意位置。场景开始时它会应用其数值，而其占位立方体只在编辑器中可见，玩家看不到。 每个字段都是一个滑块，预设为 Decentraland 的默认值： | 字段 | 默认值 | 范围 | | --------------------- | ------- | ------ | | `walkSpeed` | 1.5 米/秒 | 0 到 10 | | `jogSpeed` | 8 米/秒 | 0 到 30 | | `runSpeed` | 10 米/秒 | 0 到 50 | | `jumpHeight` | 1 米 | 0 到 10 | | `runJumpHeight` | 1.5 米 | 0 到 10 | | `doubleJumpHeight` | 2 米 | 0 到 15 | | `glidingSpeed` | 6 米/秒 | 0 到 30 | | `glidingFallingSpeed` | 1 米/秒 | 0 到 10 | | `hardLandingCooldown` | 0.75 秒 | 0 到 5 | 慢跑是玩家默认的移动速度。步行和奔跑则是在按住 Ctrl 或 Shift 键时获得的速度。 该物品还提供两个可由其他智能物品调用的动作： * `应用`：将当前字段值再次写回给玩家，例如在触发区域或按钮之后。 * `恢复默认值`：清除你的自定义值，让玩家恢复为 Decentraland 的默认设置。 参见 [移动设置与限制](/creator/content-creator-zh/chang-jing-sdk7/jiao-hu-xing/tou-xiang/locomotion.md) ，了解每项设置的详细作用，以及如何从代码中更改这些值。 ### 播放视频 播放视频来源可以是： * **本地文件** * **从 URL 流式传输** * **直播来源于** [**Decentraland Cast**](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-shi-yun-ying/live-streaming.md#dcl-cast-easy) * **直播来源于** [**RTMP 软件**](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-shi-yun-ying/live-streaming.md#stream-advanced) **（OBS、XSplit、StreamYard 等）** {% hint style="warning" %} **📔 注意**：播放视频对性能要求较高，因此请保持同时播放的视频数量较少。引擎会根据每位玩家的画质设置限制可同时播放的视频数量（低画质 1 个，中画质 5 个，高画质 10 个），并会暂停超过该限制的任何视频。参见 [播放视频](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/video-screen.md#play-videos). {% endhint %} 参见 [播放视频](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/video-screen.md) 了解更多信息。 ### 播放音频流 使用 **音频流** 智能物品，从 URL 播放音频流。 {% hint style="info" %} **📔 注意**：并非所有流媒体服务都允许你在其网站之外播放音频。以下是在 Decentraland 中可用的一些示例： ```ts GRAFFITI = 'https://n07.radiojar.com/2qm1fc5kb.m4a?1617129761=&rj-tok=AAABeIR7VqwAilDFeUM39SDjmw&rj-ttl=5' SIGNS = 'https://edge.singsingmusic.net/MC2.mp3' DELTA = 'https://cdn.instream.audio/:9069/stream?_=171cd6c2b6e' JAZZ = 'https://live.vegascity.fm/radio/8010/the_flamingos.mp3' ``` {% endhint %} 你可以调整流的音量。请注意，流中的音频不是位置音效，而是在整个场景中以均匀音量播放。 ### 显示 NFT 要在相框中显示 NFT，请使用 **NFT** 智能物品。你必须提供以下字段： * 网络 {% hint style="info" %} **📔 注意**：当前 **ethereum** 是唯一受支持的网络。 {% endhint %} * NFT 集合合约：该 NFT 集合的智能合约。 * 代币 ID：此特定 NFT 收藏品的代币 ID。 NFT 形状 你可以从 [OpenSea](https://opensea.io)获取这些信息，只需查看 NFT 图片下方的 **详情** 选项卡。 OpenSea 详情 {% hint style="info" %} **📔 注意**：你也可以从 opensea URL 获取这些信息。例如，如果 NFT 的 URL 如下： > `https://opensea.io/assets/ethereum/0x32b7495895264ac9d0b12d32afd435453458b1c6/1956` 你可以用以下内容填写这些字段： * 网络：ethereum * 合约：0x32b7495895264ac9d0b12d32afd435453458b1c6 * 代币：1956 {% endhint %} 你还可以配置背景颜色，这对于透明背景的 NFT 尤其有用。 你还可以选择一种 **框架样式**，以多种不同风格为 NFT 加框，包括经典和现代风格。 参见 [NFT](/creator/content-creator-zh/chang-jing-bian-ji-qi/gou-jian/nfts.md) 了解更多详情。 ### 生命条 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7527837b3d800afc079980b60be5474e6d055b56%2Fhealth-bar.png?alt=media\&token=91e0e012-7a67-4c08-803d-10691eb7d821) 该 **生命条** 智能物品是许多游戏机制的绝佳构建模块。它可以以多种方式使用： * 把它嵌套在 **玩家** 下，用于在头像上方显示玩家的生命值 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4ba51729ed3cbcd78807385e4a315de8ea460a96%2Fnested-under-player.png?alt=media\&token=116856e8-a498-409f-b939-d03d244f51f8) * 把它嵌套在 **摄像机** 下，用于在 UI 上固定显示 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3072a9cf441ecc75b66fba64c9ccbb367c4eb4f7%2Fnested-under-camera.png?alt=media\&token=d277b092-1d5b-4159-ac3f-5719f6fde662) * 把它嵌套在场景中几乎任何物品下，用来跟踪该物品的生命值 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5c9737b98956f6817efd09ad5de786331cbd9666%2Fnested-under-barrel.png?alt=media\&token=098b603c-107b-4b15-92a9-484897d4ee44) 其他物品可以与生命条交互，从而为其增加或减少生命值。 * 像 **尖刺** 或 **机器人敌人** 这样的物品可以降低生命值 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aed73698225063ac5cdd7257d9de8eb7c571e632%2Freduce-health.png?alt=media\&token=743a3bc9-08e3-4bdb-bd8e-15c9c5596bf8) * ，而像 **急救** 或 **治疗垫** 这样的物品可以恢复生命值。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2c80447061c76ae6b412ecbea4853f34d03469aa%2Frestore-health.png?alt=media\&token=50d3f237-6666-480a-a988-3e29fceda69e) 你必须配置生命条，定义当生命值等于 0 时会发生什么。你可以把玩家重生到某个 **重生垫** 智能物品的位置，重置他们的分数计数器，让任何敌人重生，显示 UI 文本，或者任何适合你游戏逻辑的内容。 当生命值低于某个值时，你也可以触发动作，例如在生命值低于 3 时播放特殊音乐或显示 UI 提示。 生命条可以配置为影响任何对象！例如，在 **木门** 智能物品下添加一个生命条。玩家可以使用 **剑** 智能物品降低该条的生命值，也可以通过 **桶** 的爆炸或 **机器人敌人**的攻击来降低。要实现这一点，请配置生命条，使其在数值为 0 时对其父物品执行一个动作。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88d81e8b8ea6b0985853612179ccbe55fff7e1a4%2Fwall-with-health.png?alt=media\&token=bd0afaa9-95c8-45f1-a1c4-f7f2dfa3e7ee) 像 **剑** 这样的武器可以被玩家拾取，然后在执行动作时，对玩家附近任何带有生命条的其他物品造成伤害。 ## 多人模式 几乎所有智能物品都具有多人行为，因此当物品改变状态时，场景中的所有玩家都会共享相同体验。如果玩家 A 打开了一扇门，玩家 B 也会看到那扇门打开。如果玩家 C 在其他玩家仍在场时进入场景，她也会看到那扇门已经是打开状态。 不过，如果场景附近没有玩家，那么场景会恢复到默认状态。所以如果所有玩家都离开了，然后玩家 A 又回来，她会发现门是关闭的（如果那是门的默认状态）。 请确保你设计场景时，要让一个玩家的行为不会破坏后来加入的其他玩家的场景。比如，如果这个场景是一个解谜游戏，你可以使用一个 *延迟* 动作在一个 *工具* 智能物品，让场景中的所有物品在谜题解开后几秒钟恢复到初始状态。 你也可以禁用某个物品的多人行为，参见 [智能物品 - 高级](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items-advanced.md). ## 故障排除 * *我场景中的一个物品应该可以点击，但却无法被点击*. 请确保它没有被其他东西遮挡。你不能穿过其他物品进行点击。有些物品有一个 *碰撞体网格* 它具有简化的几何形状，即使它可见的形状看起来并没有挡住，也可能正在阻挡你的物品。试着移动该物品看看会发生什么。 ## 另请参阅 * [智能物品 - 高级](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items-advanced.md) * [状态和条件](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/states-and-conditions.md) * [将任何物品设为智能](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/make-any-item-smart.md) * [与代码结合](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-yong-dai-ma-kuo-zhan/overview.md) --- # 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/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items.md?ask=&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.