> 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/character-actions.md).

# 角色动作

查找 Convai Unreal Engine 角色动作系统的指南、参考和示例——从快速开始到 Blueprint API 参考。

当玩家与 Convai 角色交谈时，插件可以让角色做出实际行动——走向物体、跟随玩家或执行自定义行为。使用本节设置和配置角色动作、编写蓝图处理程序，以及使用参数和注意力指向解析功能。

<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/character-actions/how-character-actions-work.md">角色动作的工作原理</a></td></tr><tr><td><strong>角色动作快速入门</strong><br>启用动作、添加默认处理程序、设置 Pawn 移动和 NavMesh、注册场景物体，并测试移动。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/character-actions-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/character-actions/configuring-actions.md">配置动作</a></td></tr><tr><td><strong>编写清晰的动作名称和描述</strong><br>为动作命名并编写描述，以便 Convai 选择正确的动作；同时确保参数描述清晰明确。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/writing-clear-action-names-and-descriptions.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/character-actions/built-in-action-handlers.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/character-actions/building-custom-action-handlers.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/character-actions/parameterized-actions.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/character-actions/attention-and-reference-grounding.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/character-actions/actions-blueprint-reference.md">动作 Blueprint 参考</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/character-actions/character-actions-examples.md">角色动作示例</a></td></tr><tr><td><strong>排查角色动作问题</strong><br>解决动作未触发、NavMesh 和移动问题，以及参数解析错误。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/troubleshoot-character-actions.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/character-actions.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.
