Scene Auto Tagger

使用 Scene Auto Tagger 为场景对象添加名称和描述，查看建议，并应用它们供你的 Convai 角色使用。

Scene Auto Tagger 会为 Unreal Engine 场景中的对象创建名称和描述。你可以先审阅建议，再将它们作为场景元数据应用——Convai 角色用这些信息来识别周围的对象。可以从博物馆里的几个展品、商店里的道具，或你自己场景中的对象开始。

观看博物馆演示，了解设置、审阅和应用流程：

Scene Auto Tagger 演示

前提条件

• 在 Windows 上的 Unreal Editor 中打开的一个 Unreal Engine 项目，并且已安装 Convai Unreal Engine 插件.
• 已通过 Convai 窗口登录到 Unreal Engine，并且你的 Convai 账户中已有一个角色。
• 一个已打开的关卡，其中包含你要标记的对象。

探索你的对象

1

打开 Scene Auto Tagger

选择 Scene Auto Tagger 在 Unreal Editor 工具栏中，或打开 工具 并选择 Scene Auto Tagger 在 Convai 部分中。

首次使用时，请阅读 允许 AI 场景分析吗？ 并选择 接受 以继续。该工具会将捕获的图像和你可选的指导发送给 Convai 进行分析。

2

选择一个角色并添加指导

使用 搜索你的角色 来查找并选择一个角色。Scene Auto Tagger 会使用该角色的 AI 配置和知识库来帮助识别对象并编写其描述。请选择一个与场景相关的角色，例如，用博物馆导游来处理展品画廊。生成的标签会保存到场景对象上，并可供你关卡中的 Convai 角色使用。

若要添加参考材料，请选择 在 Convai 中打开，更新该角色的 知识库，然后返回 Unreal Engine。展品说明或参考文档可以为分析提供更多上下文。

选择其 AI 配置和知识将指导分析的角色。

在 场景描述（可选）中，描述场景，例如 一个有雕像和绘画的博物馆展厅。 或者在关卡视口中框选环境，然后选择 从当前视图草拟。继续之前请先审阅生成的文本。

使用 描述重点（可选） 来引导描述。例如，输入 重点关注每个展品的材质、形状和可见细节。

3

选择要扫描的内容

展开 分析选项 并选择一个 范围:

• 所选 Actor 会扫描你在关卡编辑器中选中的符合条件的对象。这是一个适合少量对象的良好起点。
• 当前关卡 会在当前关卡中发现重要对象。

选择 准确 以便对艺术品、文本或特定主题进行更高细节的分析。这会花费更长时间。

清除 重新分析已有标签的对象 如果你想跳过已经具有 Convai Object Component 的对象。

在开始探索前，选择要扫描的对象和分析质量。

4

开始分析

选择 探索所选 Actor 或 探索当前关卡，具体取决于你的范围。等待分析完成。审阅列表会填充对象建议。

在你应用这些建议之前，你的关卡保持不变。

审阅并优化建议

选择一行以查看对象的捕获图像、 名称，以及 描述。可直接编辑文本以符合你的场景。使用简短自然的名称，例如 青铜马，以及能帮助你的角色谈论该对象的描述。

选择一个对象以检查用于生成其建议的图像。

更正细节

选择对象，然后在 优化建议中输入更正内容。例如，如果工具将展品识别为大象但漏掉了它的名称，请输入 这是科纳克大象。 选择 附注分析 ，以使用该更正和保存的图像生成修订后的名称和描述。将结果纳入前先进行审阅。

添加缺失的细节，然后选择附注分析。

更改捕获角度

如果图像没有拍到正面或某个重要细节，请选择 编辑视图 在图像下方。拖动可环绕，按住 Shift 拖动或右键拖动可平移，使用鼠标滚轮可缩放。这些控件会移动捕获相机，而不会移动你关卡中的对象。

选择 使用并分析 以根据调整后的视图生成新的建议，然后查看更新后的名称和描述。

将你希望工具看到的细节框入画面，然后使用新视图进行分析。

排除一个对象

将不需要的建议排除在你的包含集合之外。要整理列表，请勾选它们所在的行并选择 更多 > 从此次审阅中移除已勾选项。这会移除审阅条目，而不会删除你关卡中的对象。

应用并验证你的标签

1

包含你想要的对象

勾选你要保留的建议旁边的复选框，然后选择 包含已勾选项。选择一行进行查看并不会将其纳入应用。

包含你想要的建议，然后将它们应用到你的关卡中。

2

应用已包含的建议

选择 应用，后面跟着准备应用的已包含建议数量。该工具会添加或更新一个 Convai Object Component 到这些关卡对象上。

3

验证对象并保存

在关卡编辑器中选择一个已标记的对象。在 详情中，选择由 Scene Auto Tagger 添加的 Convai Object Component。它在组件列表中可能显示为 ConvaiAutoTagObject_0。在 Object Entry 下，确认 Name 和 Description 与你应用的建议一致。

确认关卡中该对象生成的名称和描述。

保存你的关卡以保留更改。应用标签和保存是两个独立的操作。

排查一次标记运行问题

某个对象需要注意

症状： 某个对象出现在 需要注意 下，并且没有可靠的建议。

原因： 分析未能从捕获的图像中得出可靠结果。

修复方法： 选择对象并检查其图像。使用 编辑视图 和 使用并分析 尝试另一个视角。如果你不想标记该对象，就不要将其包含。

验证： 在包含该对象之前，检查新的名称和描述。

应用不可用

症状： 该 应用 按钮已禁用。

原因： 分析或视图编辑仍在进行中，或者未包含任何已完成的建议。

修复方法： 等待分析完成，并结束或取消 编辑视图 （如果已打开）。至少勾选一个已完成的建议，然后选择 包含已勾选项.

验证： 该 应用 按钮会显示可应用建议的数量。

如果标签已应用但你的角色仍无法识别这些对象，请参阅 排查场景元数据问题.

后续步骤

在对话中测试你已标记的对象，或添加更多场景信息：

场景元数据快速开始场景元数据组件参考