> 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`中被替换。如果现有页面、蓝图或笔记中仍介绍按物体计算接近度，请以本节为准，了解当前模型。

通过本节了解该模型、启用此功能，并针对你的项目进行调整。

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>空间感知的工作原理</strong><br>了解距离范围、方向、朝向、视线、相对关系，以及事实如何转化为角色接收的句子。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/how-spatial-awareness-works.md">空间感知的工作原理</a></td></tr><tr><td><strong>空间感知快速入门</strong><br>启用空间感知、调整距离范围，并在调试叠加层中确认角色收到的信息。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/spatial-awareness-quick-start.md">空间感知快速开始</a></td></tr><tr><td><strong>从玩家视角描述物体</strong><br>让角色根据玩家自己的摄像机视角提供方向指引。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/describe-from-player-perspective.md">从玩家视角描述对象</a></td></tr><tr><td><strong>合并同名物体</strong><br>将同名的 Convai Object Component 合并为一个逻辑物体，而不是保留为多个带编号的重复物体。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/merge-same-named-objects.md">合并同名对象</a></td></tr><tr><td><strong>空间感知设置参考</strong><br>查看所有空间感知和物体命名项目设置、默认值及其编辑条件。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/spatial-awareness-reference.md">空间感知设置参考</a></td></tr><tr><td><strong>空间感知故障排除</strong><br>修复角色不描述任何内容、距离或方向判断错误、将墙后的物体隐藏，或混淆重复名称等问题。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness/troubleshoot-spatial-awareness.md">排查空间感知问题</a></td></tr></tbody></table>


---

# 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=<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.
