Unity AI Gateway

Unity AI Gateway 是 Unity 官方引擎体系中，专门负责“连接游戏与外部 AI 模型/服务”的核心通信层(AI Integration Layer)。

它的目标非常明确：
让 Unity 项目稳定、安全、统一地接入各种云端大模型，而不需要开发者自己维护 API、鉴权、网络、负载、流式返回等复杂逻辑。

它是 Unity 在 AI 时代里最“基础设施级”的组件，地位类似：

AI 版的 UnityWebRequest（但更高级）
AI 版的 Addressable（但是用于模型服务）
AI 技术栈中的“网关”和“协议统一器”

1. 解决了什么痛点?

过去一年里, 各类 Unity 项目尝试接入不同厂商的 LLM, 如 OpenAI、Gemini、Claude、自建 Llama Server 等, 而每家接口、SDK、安全策略、流式格式都不同, 导致团队需要重复构建以下内容:

API Key 管理
Token 限流
TLS / 证书 / 网络错误处理
重试机制与负载控制
流式输出解析
JSON schema 输出
Function Calling / Tool Use
Provider 切换与配置管理

Unity AI Gateway 的目的, 就是彻底统一调用方式。

一句话总结: AI Gateway = 官方维护的、统一的大模型通信层, 让所有 LLM 调用方式一致。

2. 它到底是什么?

AI Gateway 包含三大核心组件:

① Provider 统一适配层

把所有模型服务抽象成一个统一接口。
无论使用 GPT / Gemini / Claude / Llama Server, 都用同一个 API 调用。

② 运行时网关(Runtime Gateway)

负责:

网络调度
超时、重试
流式解析
请求队列
并发稳定性

③ 安全层

负责:

API Key 安全存储
限流
TLS
企业安全策略

3. 能做什么?

① 文本生成(支持流式输出 Stream)

支持 ChatCompletions 风格的:

system / user / assistant 角色
JSON Schema 输出
流式 token 返回

② Function Calling / Tool Use

C# 方法可以注册成”工具”, 让 LLM 调用:

[LLMTool]
public int Add(int a, int b) => a + b;
 
LLM 会返回类似:
 
{ "tool": "Add", "arguments": { "a": 1, "b": 2 } }

③ 多模态支持

可发送:

文本
图像
音频

取决于 provider 支持。

④ 高层 AI 智能体循环(ReAct / Tool Loop)

支持:

LLM → 工具调用 → 观察结果 → 再推理

⑤ 编辑器集成工具

可用于:

生成文案
生成 shader 描述
生成关卡说明
生成任务文本

⑥ 模型管理

支持:

多 provider 配置
动态切换模型
本地模型 + 云模型混合

4. 与 Sentis 的关系

Unity AI 技术栈分为三部分:

Sentis

运行本地 ONNX 模型, 负责低延迟推理。

ML-Agents

用于强化学习训练 AI 模型。

AI Gateway

用于连接云端大模型, 负责高智能推理、对话、规划。

一句话总结: **Sentis = 本地”小脑”
ML-Agents = 训练体系 AI Gateway = 云端”大脑” **

5. 使用方式(整体流程)

Step 1: 安装

Package Manager 搜索:
com.unity.ai.gateway

Step 2: 配置 Provider

在 Project Settings → AI Gateway 中添加:

OpenAI
Google Gemini
自建模型服务

配置 API Key、模型列表、限流等。

Step 3: 发送请求

var req = new AIGatewayRequest()
	.WithTextPrompt("Tell me a story.");

var res = await gateway.SendAsync(req);
Debug.Log(res.Text);

Step 4: 流式输出

await foreach (var t in gateway.SendStreamAsync(req)) {
	ui.Append(t);
}

Step 5: 工具调用

[LLMTool] public void MoveTo(Vector3 pos) { ... }

6. 典型应用场景

生成任务、剧情、描述
AI NPC(对话、情绪模拟、记忆)
AI 规划器(任务拆解、行动计划)
编辑器自动化工具(生成代码/文案/资源描述)
多智能体系统

7. 为什么 Unity 要做 AI Gateway?

AI 是未来所有游戏的基础能力
LLM API 更新频繁, 开发者无法时时跟随
官方统一适配层能减少碎片化
企业级项目需要统一安全体系
AI Editor 工具需要稳定的底层 API

Unity 的战略非常清晰:
AI Gateway 是未来 Unity AI 的操作系统级接口。

美丽新世界

探索

20251117_Unity AI Gateway