AI 编码助手
查找通过 Convai 的支持 MCP 工具将 AI 编码代理连接到 Unity 的指南，包括设置、支持的代理和故障排除。
Convai AI 编码助手集成将 Convai 专属工具添加到 Unity 官方 MCP 服务器中，因此编码代理可以检查、配置和诊断你项目中的 Convai 组件，而不必由你手动逐个连接。如果你已经在使用受支持的编码代理，并希望该代理理解 Convai 的房间、角色、动作、唇形同步、转录和视觉功能，那么就使用它。连接后，你可以用自然语言向代理下达指令，并在 Unity 编辑器中查看生成的更改。
开始之前： 该集成需要 Unity 6 (6000.x) 或更高版本，以及兼容的 com.unity.ai.assistant 包。请参阅 设置你的第一个编码代理 ，以获取完整的先决条件检查和设置演练。
该集成添加了什么
Unity 的官方 MCP 服务器，由 com.unity.ai.assistant 包提供，为编码代理提供用于 GameObject、脚本、资源和场景操作的通用工具，但对 Convai 组件没有任何了解。Convai Unity SDK 额外提供了 20 个具备 SDK 感知能力的工具，带有 Convai.* 名称前缀——例如 Convai.ConfigureCharacter, Convai.ConfigureLipSync，以及 Convai.DiagnoseConversation ——这些工具只读取和修改 Convai 组件，例如 ConvaiManager、角色、动作、唇形同步、转录和叙事部分。Unity MCP 工具继续负责通用的 GameObject、脚本和场景操作。Convai 工具绝不会接收或返回 API 密钥，而会修改 Convai 工具使用 Unity 的撤销系统，而不是自动保存场景。
受支持的编码代理
该集成支持五种编码代理：Codex、Claude Code、Cursor、Gemini 和 VS Code Copilot。为某个代理安装支持时，会将一个受管理的 Convai 指令块写入该代理自己的指令文件中—— AGENTS.md 适用于 Codex， CLAUDE.md 适用于 Claude Code， .cursor/rules/convai-unity-sdk.mdc 适用于 Cursor， GEMINI.md 适用于 Gemini， .github/copilot-instructions.md 适用于 VS Code Copilot——并将代理指向打包的 convai-unity-sdk 技能。请参阅 受支持的编码代理 以了解精确的文件路径和各代理的安装行为。
将编码代理连接到你的项目
打开 Convai > AI 编码设置 在 Unity 编辑器菜单中开始。这会打开 Convai 编辑器窗口的 AI 编码 部分，其中的 设置健康状态 卡片会检查 Unity 6 (6000.x) 或更高版本、兼容的 com.unity.ai.assistant 包、打包的 Convai 技能以及 20 工具契约，并在任何检查失败时内联提供 修复 按钮。打开 项目设置 > AI > Unity MCP Server ——可以直接打开，或通过同一部分中的 打开 Unity MCP Server 设置 按钮——接受 Unity 针对 MCP Server 功能的条款，并确认哪些 MCP 客户端已连接到你的项目。然后点击 安装 旁的受支持编码代理，在 已管理的项目指令 卡片中写入其受管理的指令块。请参阅 设置你的第一个编码代理 以获取完整演练。
你可以让已连接的代理执行什么
连接编码代理后，你可以用自然语言向它下达指令，而不是手动连接组件。典型请求包括：
构建一个包含玩家和角色的对话场景
添加聊天 UI 以显示对话转录
在按住说话和免提对话输入之间切换
向场景中添加供角色引用的对象
启用视觉功能，让角色能够看到场景
代理会针对 Convai 组件使用 Convai 工具，并针对通用的 GameObject、脚本和场景操作使用 Unity 自身的 MCP 工具，然后报告它更改了哪些实例 ID。请参阅 MCP 工具参考 ，以查看代理可用的 Convai 工具完整列表。
AI 编码助手页面
最后更新于
这有帮助吗？