> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness.md). # 空间感知让 Convai 角色以通俗语言感知周围对象、其他角色和玩家的位置，以及其重要性。空间感知会告诉每个 Convai 角色，周围的物体、其他角色和玩家分别在哪里——离多远、在什么方向、它是否真的能看见它们，以及附近事物彼此之间是什么关系。系统会在每次轮询时以通俗语言计算这些信息，并将其作为一组上下文事实提供给每个聊天机器人，供 AI 在阅读对话时一并参考。空间感知取代了旧版的按对象邻近机制，见于 `4.0.0-beta.22`。如果你已有页面、蓝图或笔记描述的是按对象邻近机制，请将本节视为当前模型。使用本节来了解该模型、开启此功能，并为你的项目进行调优。


空间感知如何工作了解距离区间、方向、朝向、视线、关系，以及这些事实如何变成角色接收到的句子。	空间感知的工作原理
空间感知快速入门开启空间感知，调整距离区间，并在调试覆盖层中确认角色接收到的内容。	空间感知快速开始
从玩家视角描述物体让角色从玩家自己的相机坐标系给出方向。	从玩家视角描述对象
合并同名物体将同名的 Convai Object Components 合并为一个逻辑对象，而不是将它们保留为彼此独立的、带编号的重复项。	合并同名对象
空间感知设置参考查阅所有空间感知和对象命名的项目设置、默认值以及可编辑条件。	空间感知设置参考
空间感知故障排查修复角色什么都不描述、距离或方向出错、让物体被墙壁遮挡，或者混淆重复名称的问题。	排查空间感知问题

--- # 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.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness.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.