谷雨开源 SaaS 平台（G2rain）

# Agent 平台模块导览

G2rain 将 Agent 配置、运行执行、前端接入、模型访问和工具调用拆分为五个项目。团队可以按需要查看源码、接口、配置与运行文档，同时结合知识服务和企业权限模型评估业务接入。

# 五个项目分别做什么

项目 核心职责 官网文档
g2rain-agent-runtime 组织 Agent 与 Skill 配置、用户输入、模型和工具调用，维护任务图与执行状态 运行时服务
g2rain-agent-studio 管理 Agent 画像、Skill 手册与执行契约，以及 Agent-Skill、Skill-Tool 绑定 配置与资料服务
g2rain-agent-app 智能体与 Skill 配置、模型管理、MCP 服务与工具管理、会话观测和执行追踪页面 运营前端
g2rain-model-nexus 管理模型服务目录、接入资料与用量，以 OpenAI 风格接口适配模型供应商 模型访问网关
g2rain-mcp-registry 管理外部服务与工具资料，为 Runtime 提供 MCP 工具发现和调用代理 MCP 工具服务

Studio 是后端运行资料服务，可视化运营入口由 Agent App 承载。Agent App 支持 Vue3 微前端、qiankun、独立运行与 SSO，其部分 README 和架构文档仍沿用模板描述；上述页面范围按当前 src/views、路由注册和 API 调用核对。

# 在运营端可以查看和配置什么

  • 平台与租户智能体：画像、启停状态、Skill 手册和执行契约，以及 Skill 与工具的绑定。
  • 模型管理：模型目录、接入资料与用量记录。
  • MCP 接入：外部服务、平台原生工具、扩展工具与租户工具，包含 OpenAPI 导入和内置工具同步入口。
  • 运行观测：会话列表、会话详情、任务图、节点和工具调用详情。

页面可用范围受部署资源配置、岗位授权和后端接口约束。前端源码中存在入口不代表任意部署环境已启用相应功能。

# 一轮执行如何协作

  1. Runtime 接收上游应用的一轮对话请求，创建或续接会话。
  2. Runtime 从 Studio 取得 Agent 画像、Skill 及其能力包。
  3. 模型调用经 Model Nexus 路由至对应供应商；工具发现和调用经 MCP Registry 访问下游服务。
  4. Runtime 记录任务图、节点与工具调用状态，通过 SSE 推送 PROGRESS 和最终 RESULT 事件。

Runtime 文档同时描述检查点、恢复记录和工具幂等边界。具体可恢复范围需要按工具副作用和实际执行状态验证，不能假设任意中断都可直接重放。

# 模型与工具采用独立边界

Model Nexus 提供 POST /v1/chat/completions 与 POST /v1/embeddings，按模型资料选择 OpenAI、Anthropic 或 Google GenAI 客户端。可用模型取决于已登记配置和连通性。

MCP Registry 在 /mcp 处理 tools/list 与 tools/call，解析输入 schema、组装可信上下文并映射下游结果或错误。协议配置与部分代码注释存在差异，部署时需验证实际协议和会话行为。

Runtime 也使用 POST /v1/chat/completions 作为对话入口，但其事件契约与模型网关职责不同，接入时应分别阅读项目接口说明。

# 与知识和企业权限协作

知识服务负责知识生命周期、活动版本与检索证据。中央集成设计约定 Agent 通过业务检索契约消费证据，不直接读取知识数据库或向量索引，详见知识库与 Agent 协作。

Agent-Skill 与 Skill-Tool 绑定表达可用能力，不自动替代用户岗位授权或租户应用开通。实际调用仍需核对身份、租户上下文、接口权限和数据归属，详见企业权限模型。

# 从文档到运行环境

后端项目 README 的基础条件为 JDK 25、Maven、MySQL、Redis 和所需依赖服务，并通过 Nacos 或开发 profile 提供配置。前端要求 Node.js 22+。具体环境变量、接口和运行方式请进入对应项目文档查阅。

本页于 2026-10-21 根据更新后的本地代码与文档核对。当前未发现五个仓库的本地发布标签；Studio、MCP Registry 的 README 与 docs 还包含本地未提交内容，官网同步会保留工作区来源信息。官网收录不替代生产环境或跨服务验收，版本和测试记录以责任仓库为准。

# 体验与继续阅读

←