跳转至

GrayGooAgent 外部桥接技能

范围

本指南说明 GrayGooAgent 推荐的外部代理集成路径。

随包提供的技能文件位于打包好的 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 可以成功等待完成
  • 结果反映了真实的编辑器上下文

重要边界

  • 这个桥接技能是配套集成资产，不是编辑器插件本身的替代品。
  • 推荐路径仍然是先验证编辑器内的快速开始流程。
  • 不要向同一个 session_id 并发发送请求。
  • 外部桥接工作流仍然局限在编辑器侧能力范围内。
  • 除非你显式启用，否则基于 Python 的变更执行仍然默认关闭。

如果出问题

先检查这些项：

  • 桥接已启用
  • 更改桥接设置后已经重启编辑器
  • 桥接端口未被占用
  • 默认桥接 agent 可以解析已配置的 provider
  • 当前会话没有处于忙碌状态

然后参考：