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

# 角色动作

角色动作使 NPC 角色能够通过场景中的实际行为来响应玩家请求——导航、对象交互、动画以及自定义游戏逻辑。本节涵盖从首次可用配置到完整脚本 API 的所有内容。

<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="/pages/53aa8db086c9806f093f80741862dfe3316e77d8">/pages/53aa8db086c9806f093f80741862dfe3316e77d8</a></td></tr><tr><td><strong>角色动作快速入门</strong><br>为你的 NPC 添加一个可用的“移动到”动作——无需脚本。</td><td><a href="/pages/7f0d213ddc809cfd39ab2bc41492ddf8e54b6c19">/pages/7f0d213ddc809cfd39ab2bc41492ddf8e54b6c19</a></td></tr><tr><td><strong>配置角色动作</strong><br>ConvaiActionConfigSource 完整参考——动作定义、目标以及连接时覆盖项。</td><td><a href="/pages/111bca064ba7041a987662d038af4d71d58a32cd">/pages/111bca064ba7041a987662d038af4d71d58a32cd</a></td></tr><tr><td><strong>动作执行器</strong><br>六个执行器组件的参考文档，包含 Inspector 字段表。</td><td><a href="/pages/f592d9dc3ad261e175159690b86cdd4b50bb4d81">/pages/f592d9dc3ad261e175159690b86cdd4b50bb4d81</a></td></tr><tr><td><strong>分发器与批处理策略</strong><br>配置 ConvaiActionDispatcher 如何处理并发批次和步骤失败。</td><td><a href="/pages/6e3c85bad169c9c2c755b38be39008ef3ce023cf">/pages/6e3c85bad169c9c2c755b38be39008ef3ce023cf</a></td></tr><tr><td><strong>编写自定义动作 executor</strong><br>实现 IConvaiActionExecutor，为任何动作创建项目特定行为。</td><td><a href="/pages/c5598abd0ddd72fa75a0989ad602a5b4d12e16d7">/pages/c5598abd0ddd72fa75a0989ad602a5b4d12e16d7</a></td></tr><tr><td><strong>注意力与指代锚定</strong><br>在运行时保持 Convai 的目标解析与玩家当前关注的对象一致。</td><td><a href="/pages/5b02ee57da9de48585f7ea92aa9e94714547d80a">/pages/5b02ee57da9de48585f7ea92aa9e94714547d80a</a></td></tr><tr><td><strong>角色动作脚本参考</strong><br>涵盖所有动作系统类型、事件、枚举和组件的完整公共 API。</td><td><a href="/pages/0341126fa4c492311dab4fb6aca6d0c64191016b">/pages/0341126fa4c492311dab4fb6aca6d0c64191016b</a></td></tr><tr><td><strong>角色动作示例</strong><br>四个循序渐进的场景，从无需代码的 Inspector 设置到脚本化批量注入。</td><td><a href="/pages/0e9ccbf7f8fa10ad65f6395315d82ba64412791c">/pages/0e9ccbf7f8fa10ad65f6395315d82ba64412791c</a></td></tr><tr><td><strong>排查角色动作问题</strong><br>使用 ConvaiActionDebugProbe 和“症状/原因/修复”参考来诊断动作流程问题。</td><td><a href="/pages/1398e3302b345ef93934a0e6c93b4d8e576ab00e">/pages/1398e3302b345ef93934a0e6c93b4d8e576ab00e</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:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/character-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.