> 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="/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="/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="/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 组件合并为一个逻辑对象，而不是将它们保留为彼此独立、带编号的重复项。</td><td><a href="/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="/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="/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/spatial-awareness.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
