AgentCraft

内部测试 · 生产级 AI 智能体系统

AgentCraft

面向 Unreal Engine 编辑器的 AI 智能体系统

系统以自然语言意图为驱动引擎,赋能智能体进行自主规划。智能体能够从超过 300 个原生工具中灵活判断选择, 并在编辑器会话中以事务方式执行任务,最后高效完成对账闭环。

了解系统架构 ↓

系统概述

作为一款采用纯 Slate 架构的 UE5 编辑器插件,AgentCraft 成功打破了大语言模型与游戏引擎之间的壁垒。 它不仅支持 Claude Code、Gemini CLI、DeepSeek、通义千问和 GLM 等多种主流智能体接入 Unreal Engine 工作流, 更通过一套统一的 kaiwu_* 原生工具集,让智能体能够精准、流畅地完成材质、蓝图及光照等复杂的创作任务。

AgentCraft —— 编辑器内的 AI 智能体:自然语言驱动,300+ 原生工具执行并读回验证

事务安全与可验证对账

工具调用超越了简单的状态返回。系统将所有写入操作严格包裹于事务之中,并在落地后自动从资产注册表回读组件、参数及路径,与预期结果进行逐项对账,以可验证的客观证据取代模糊的状态声明。

跨域协同联动

依托统一的技术底座驱动多元创作域,支持在单一自然语言意图下,协同执行材质、光照及蓝图等复杂任务,彻底消除传统工作流中彼此割裂的工具孤岛。

确定性配方复现

采用数据驱动的配方装配机制,确保创作流程的确定性复现,全面支持资产的规模化产出、快速迭代与精细化版本管理。

国产模型原生直连

实现 DeepSeek、通义千问(DashScope)、GLM(BigModel)与 Claude、OpenRouter 的平等原生接入。所有模型均作为一等公民无缝集成,无需配置额外的网络代理。

自有凭据安全直连

支持通过自有 API Key 直接连接,或经由 agentcraft-mcp 驱动 CLI 订阅。

纯 Slate 原生架构

基于纯 Slate 架构开发,彻底摆脱 UMG 与 CEF 依赖,确保在任意 UE5 构建环境下稳定运行(以 UE 5.7 为基线,完美兼容 UE 5.8)。

名称取自《天工开物》——成书于十七世纪的造物典籍,寓意将系统化的造物精神经由人工智能引入 Unreal Engine。

工作原理

自然语言意图 → 智能体规划 → 事务执行 → 写入 · 读回 · 对账;由统一底座驱动,跨创作域保持一致。

AgentCraft 编辑器内面板:会话、创作域 tab(材质 / 玩法 / 光照)与模型选择的真实界面
设置面板:DeepSeek / Qwen / GLM / OpenRouter / Claude 等多 provider,自有 API Key 直连
1

统一 Agent 接口抽象

通过 ICraftAgentProvider 接口,实现了 UI 层、工具层与底层 AI 传输层的彻底解耦。无论是 Stdio 家族(如 Claude Code、Gemini CLI、Codex)还是 HTTP 家族(如 DeepSeek、通义千问、GLM、OpenRouter),均遵循同一套标准化的异步契约,确保了底层通信的兼容性与扩展性。

2

意图转译与工具择取

模型将用户的自然语言意图精准转译为对结构化 kaiwu_* 工具的调用指令。面板依据当前创作域动态组织并收窄可用工具集,有效引导模型聚焦于特定领域,大幅降低幻觉风险。

3

在线事务安全执行

区别于传统的离线批处理模式,所有写入操作均被严格包裹于事务之中,并直接在运行中的 UE 编辑器会话内实时落地,确保操作与引擎状态的绝对同步。

4

闭环对账机制

执行完毕后,系统会自动从资产注册表中回读组件、参数及路径等真实结果,并与预期目标进行逐项对账。这种“写入→读回→对账”的闭环机制,摒弃了仅依赖状态返回的不可靠方式。

自研 MCP 服务与生态互补:提供标准的 MCP 服务并暴露工具注册表,支持无缝接入 MCP Inspector、Claude Desktop、VS Code 等主流客户端。自研机制与 Epic 官方 UE 5.8 内置的 MCP 形成互补,并在对账验证、跨域协同及配方复现的一致性上具备显著优势。

能力域

面板严格依据创作域进行组织,清晰划分“已验证域”与“预览域”。v1 版本已完整支持以下三大核心创作域:

v1 完整支持

材质 Materials

支持配方化材质图的自动化装配、Material Instance 生成、贴图智能指派及 PBR 参数精准调校,并具备对外部材质库的扫描与实时预览能力。

v1 完整支持

玩法 · 蓝图 Gameplay

基于预设脚手架实现蓝图自动生成,支持图节点编辑与智能连线、组件与变量管理,并提供自动编译与读回验证机制,确保逻辑正确性。

v1 完整支持

光照 Lighting

涵盖三点棚标准布光、灯光摆放与参数调校,以及视口取景等核心光照创作任务。

各已支持域均由自动化测试套件把关,发布前连续通过五轮完整回归。

写入后自动读回真实数值(灯光角度 / 强度 / 曝光)作为证据 —— 读回 · 对账
按创作域收窄工具集,模型每次只面对当前 tab 的工具 —— 工具择取
愿景 · 方向

全栈创作扩展规划

统一底座具备向更多创作域延伸的架构能力。以下相关工具链已具备底层调用能力:

PCG · 程序化散布 动画 · Sequencer / 过场 关卡 · 场景布局 物理 · 碰撞 / 约束 资产 · 导入 / 管理 音频系统

未来发展方向,不代表当前版本内容。

示例

代表性示例随插件零外部依赖附带;具体内容正在甄选整理,确定后于此公布。

敬请期待

示例内容确定后于此展示。

敬请期待

示例内容确定后于此展示。

敬请期待

示例内容确定后于此展示。

示例覆盖各 v1 支持域,随插件零外部依赖附带;成品渲染图与演示短片将随创作域成熟陆续补充。

里程碑

本系统为持续迭代中的生产级 AI 智能体引擎,服务于内部测试与能力验证。