跳转至

GrayGooAgent 外部代理桥接

范围

本页说明如何通过 GrayGooAgent 让外部代理驱动 Unreal Editor。

随包提供的技能文件位于打包好的 GrayGooAgent 插件中的：

  • Docs/graygoo-unreal-bridge/
  • Docs/graygoo-unreal-bridge/SKILL.md

如果你希望另一个代理系统通过本地 GrayGooAgent 桥接来驱动 Unreal Editor，推荐配套技能是：

  • graygoo-unreal-bridge

这是为外部代理提供的配套桥接工具。它负责串联启动、连接、任务提交和结果等待等流程，避免用户手动组织请求与轮询逻辑。

如果你的外部代理环境要求技能位于独立的技能目录中，请把插件包里的整个 graygoo-unreal-bridge 文件夹复制到那个环境里，并保持相同的相对 scripts/ 布局。

配套技能覆盖什么

graygoo-unreal-bridge 的目标是封装本地 HTTP 桥接，避免用户手写原始请求。

常见操作包括：

  • 检查桥接与编辑器状态
  • 启动编辑器并等待桥接就绪
  • 向当前会话或新会话发送一个任务
  • 等待返回的 session_id 和 turn_id
  • 安全地停止或重启编辑器侧流程

这样可以将桥接流程封装为标准化工具调用，而不是直接处理底层协议细节。

推荐使用场景

如果你想做下面这些事，这个配套技能就很合适：

  • 将 Codex 风格或其他外部代理连接到 Unreal Editor
  • 在后续编辑器任务中保留多轮上下文
  • 让外部代理检查或推进编辑器里可见的工作
  • 避免手工维护桥接生命周期和轮询逻辑

推荐工作流

在使用外部代理路径之前：

  • 先完成编辑器内快速开始流程的验证
  • 确认一个 provider 实例是健康的
  • 保持 Default Provider Instance 和 Default Lightweight Provider Instance 简单且稳定

然后：

  1. 启用 Enable External Agent Bridge
  2. 重启编辑器
  3. 确认启动指南报告桥接健康
  4. 使用 graygoo-unreal-bridge 技能检查状态或等待就绪
  5. 发送一个具体的任务
  6. 在同一个会话里发送下一次请求前，先等待终端结果

首次使用时，建议选择范围较小且结果容易验证的任务，例如：

  • 检查当前关卡
  • 列出活动地图中的主要 Actor
  • 检查一个 Blueprint 或资源
  • 截取一张截图用于视觉确认

首次验证通过的判据

满足以下条件时，可视为桥接链路已完成首次验证：

  • 桥接健康检查通过
  • 可以通过桥接访问编辑器
  • 第一个任务返回有效的 session_id
  • 返回的 turn_id 可以成功等待完成
  • 结果反映了真实的编辑器上下文

重要边界

  • 这个桥接工具是配套件，不是编辑器插件本体的替代品。
  • 仍建议优先完成编辑器内 quickstart 验证。
  • 不要向同一个 session_id 并发发送请求。
  • 桥接能做的事，还是以编辑器里现有能力为准。
  • 除非你显式启用，否则基于 Python 的变更执行仍然默认关闭。

如果出问题

先检查这些项：

  • 桥接已启用
  • 更改桥接设置后已经重启编辑器
  • 桥接端口未被占用
  • 默认桥接 agent 能正常拿到你已经配好的 provider
  • 当前会话没有处于忙碌状态

然后参考：