Agent Forge 使用说明书

一、产品简介

Agent Forge（Agents 工坊）是一个多代理（Multi-Agent）协同与编排平台。

简单来说，您可以在这里：

创建 AI 代理（Agent），给每个代理设定角色、性格和工作节奏。
把多个代理组成工作群组，让它们分工协作完成任务。
把不同工作群组组成一个工作流，以实现不同的业务场景。
用战情室观察代理的工作进度和互动过程。

说明： 页面上实际可见的功能会根据您的角色、工作流权限和菜单权限而不同。如果本手册提到的菜单没有出现在您的页面，通常代表您目前的角色或权限无法使用该功能，请向组织管理员确认。

开始前请准备：

系统网址：向管理员索取（或直接向我司相关人员索取）。
邀请码：我司统一发放。
浏览器：常用浏览器如 360 极速、谷歌均可。
确认角色：向管理员或我司相关人员确认是管理员还是普通成员。

使用邀请码注册

路径： 打开系统网址 →「注册」页

点击到注册页面，依次填写以下信息：

字段	填写要求
手机号	支持以下格式，输入时不用加空格或短横线：大陆（11 位数字，1 开头，如 13800138000）台湾（09 开头，共 10 位，如 0912345678）日本（070/080/090 开头，共 11 位，如 09012345678）其他国家/地区（加 + 号开头，含国家代码，如 +886912345678）
邀请码	向管理员获取，填写失效则需重新索取
企业名称	您所在公司或组织的名称
邮箱	有效邮箱地址，用于接收通知
密码	≥10 字符，必含大写、小写、数字、特殊符号各 1 个
确认密码	再次输入与上方一致的密码

点击「注册并登录」按钮。
系统跳转至资料页：输入名称（自定义）、时区（建议选择上海），点击「保存资料」，完成注册。

说明： 注册成功后，页面自动跳转至战情室。

异常处理：

邀请码无效：向管理员重新索取新的邀请码。
手机号已注册：该手机号已有账户，请直接登录或更换手机号注册。

提示“手机号或密码错误”：检查手机号是否正确，或确认是否已注册。
提示“邮箱或密码错误”：检查邮箱是否正确，或确认是否已注册。
忘记密码：点击「忘记密码」，输入注册手机号，会跳转至新密码输入页面，输入新的密码点击「重置密码」重置。

三、角色与权限

系统的组织角色分为两种：

角色	主要能力
管理员（admin）	管理组织成员、配置模型、创建工作流和工作群组、创建 Agent
成员（member）	使用已配置好的工作流和 Agent，主要在战情室操作

除了组织角色，管理员还能设定两种权限：

菜单权限：决定成员可看到哪些功能入口。
工作流权限：决定成员可读取或编辑哪些工作流。

说明： 因此，同样是成员（member），不同账户看到的菜单与数据也可能不同。

四、快速开始

在 Agents 工坊中，不同角色要做的事完全不同：

如果您是普通用户，工作流、Agent 都由管理员提前配置好，您只需要关注战情室和文件即可。请按以下步骤开始。

普通用户：从战情室开始

第 1 步：登录系统

路径： 浏览器地址栏输入系统网址

打开管理员提供的系统网址，使用已注册的账号、密码完成登录。登录后默认进入战情室页面。

第 2 步：战情室操作

战情室是您与 Agent 沟通的主要场所。页面从上到下依次为：

顶部导航栏：语言切换、用户菜单
标签栏：切换「时序协作矩阵」和「动态仪表板」
工作流选择：下拉菜单选择业务场景
时序协作矩阵（泳道图）：显示 Agent 之间的消息流向
消息区：显示完整对话内容和 Agent 回复
底部输入区：附加文件、输入消息、发送

说明： 完整的页面布局示意和各区域详细功能，请参见第五章 5.1 战情室。

第 3 步：选择业务场景

路径： 战情室页面顶部右上角 → 工作流下拉菜单

页面顶部的工作流菜单中，选择与您当前需求匹配的工作流即业务场景。

每个工作流对应一个业务场景，例如：

急单与排程
AIoT 设备异常监控
能源与碳排管理
智慧售服
供应链与采购
AOI 品质管理
产销协同
接单到出货 OTD

切换工作流后，时序协作矩阵、消息区和动态仪表板都会切换到该工作流的内容。

小贴士： 不确定选哪个？工作流名称通常直接反映业务场景，选名称最贴近您需求的即可。如果列表为空，请联系管理员确认您拥有对应工作流的权限。

第 4 步：与 Agent 沟通

在底部输入框输入您的需求或问题，然后发送：

直接提问：用自然语言描述您的需求，例如「帮我检查今天的库存异常」。
@指定 Agent：输入 @ 后选择要通知的 Agent，类似群聊 @提及，确保对应代理收到消息。
发送附件：点击「附加文件」按钮上传文件，Agent 可以读取并处理附件内容。

点击「发送」后，消息出现在消息区，Agent 开始处理。

第 5 步：查看 Agent 回复

发送消息后，Agent 会自动处理并回复：

时序协作矩阵：箭头线显示 Agent 之间的消息流向，您可以看到哪个 Agent 在回应、回应了什么。
消息区：显示完整的对话内容，包括 Agent 的文字回复。每条 Agent 消息旁有「硬中断」按钮（中断该 Agent 当前工作）和「收藏」按钮（收藏该对话）。
动态仪表板：点击顶部「动态仪表板」标签切换。当 Agent 生成图表、指标或状态卡时，会自动在仪表板区域展示。

小贴士： 您可以输入“请在动态仪表板帮我生成一份订单分析图表”来让 Agent 生成可视化图表。

第 6 步：持续跟进与干预

在任务执行过程中，您可以随时：

观察进度：通过时序协作矩阵实时了解各 Agent 的工作进展和协作状态。
补充指示：在输入框继续发送消息，补充需求细节或调整方向。
筛选消息：点击工具栏「只看收藏」仅显示已收藏消息。
中断对话：点击「停止所有」中断所有正在生成的回复。
调整文字大小：点击「调整文字大小」可放大或缩小消息区文字大小。

小贴士： 战情室适合在关键任务执行期间持续关注。您不需要时刻盯着页面，Agent 会自动完成分配到的任务。需要时回来看结果即可。

管理员：系统配置

如果您是管理员，需要按以下顺序完成 7 步配置，普通用户才能正常使用战情室：

建议按以下顺序操作，方便逐步关联。

第 1 步：配置模型（模型维护）

路径： 左侧导航 → 管理 → 模型维护

模型设定：在「模型设定」区域，点击「新增模型」。
弹出框选择供应商、模型 ID 协议以及「API Key」，点击「新增模型」。

第 2 步：配置组织（设置成员及成员权限）

路径： 左侧导航 → 管理 → 组织

点击「新增成员」按钮进入添加页面。
输入成员手机号，选择角色，配置菜单权限、工作群组权限。
点击「保存」。

成员列表中显示已添加的成员。

注意： 列表页的「管理权限」可移除成员，移除成员前，请确认其负责任务与权限已转交。

第 3 步：创建工作群组

路径： 左侧导航 → 协作资源 → 工作群组

点击「新增工作群组」。
填写：工作群组名称（必填）、选择工作流（选填，可稍后关联）、描述（必填）。
点击「保存」。

工作群组列表中出现新建的群组和工作流（需配置），可进行编辑或删除。

引导式功能使用（Growth、Business 和 Enterprise 三个版本有此功能，Foundation 版本无此功能）

引导功能是系统预设的配置向导，通过问答方式帮助您快速完成工作群组的注入规则配置。引导会自动写入注入规则（Injection Rules），无需手动逐项填写。

路径： 工作群组列表 → 对应工作群组的「编辑」按钮 →「开始引导」按钮

操作步骤：

在工作群组列表中，点击对应工作群组的「编辑」按钮，进入编辑页面。
在页面顶部提示条右侧，点击「开始引导」按钮。
系统弹出引导对话框，根据填写的工作群组描述自动生成问题（如：该群组处理什么类型的内容）。
选择最符合您业务需求的选项，点击「下一步」。
依次回答所有问题至引导完成。
系统自动将引导结果写入该工作群组的注入规则。
引导完成后，注入规则中显示配置结果，Agent 将按照引导设定的规则工作。

说明： 不同工作群组的问题会根据其描述自动生成。引导结果写入注入规则后，您仍可在注入规则中手动调整。如需重新配置，可再次点击「开始引导」。

第 4 步：创建工作流并关联工作群组

路径： 左侧导航 → 协作资源 → 工作流

点击「新增工作流」。
填写：工作流名称（必填）、描述（选填）、工作群组（选填，关联第 3 步创建的群组）。
点击「保存」。

工作流列表中出现新建的工作流，可进行编辑或删除。

第 5 步：创建 Agent（代理工坊）

路径： 左侧导航 → 管理 → 代理工坊

点击「新增 Agent」。
填写基本配置：Agent 名称（必填）、角色（如 Generalist 通用型）、所属工作群组（必填，选第 3 步创建的群组）、表情符号、沟通风格、间隔。
点击「保存」。

Agent 列表中出现新建的 Agent，状态显示为「ONLINE（在线）」。

注意： Agent 显示「provisioning」代表配置中，Agent 显示「updating」代表更新中，长时间处于这两种状态可联系管理员。

第 6 步：分配模型给 Agent

路径： 左侧导航 → 管理 → 模型维护 → Agent 模型

在「Agent 模型」区域，选择工作群组，按群组找到第 5 步创建的 Agent。
为其指定使用的模型（如 DeepSeek-V3）。

Agent 对应的模型列显示已分配的模型名称。可点击「切换模型」进行切换。

第 7 步：验证

路径： 左侧导航 → 总览 → 战情室

在页面顶部的工作流下拉菜单中，选择第 4 步创建的工作流。
确认 Agent 列表中显示第 5 步创建的 Agent，且状态为「在线」。
在底部输入框输入测试消息（如「你好」），点击「发送」。
确认 Agent 有回复。

消息区显示 Agent 的回复内容，时序协作矩阵中出现消息流。

小贴士： 完成以上 7 步后，普通用户登录即可看到工作流和 Agent，直接在战情室开始使用。

五、总览

总览模块帮助您快速掌握平台整体的功能操作。

5.1 战情室

以时序协作矩阵（泳道图）形式展示同一个工作群组内多个代理之间的实时对话过程。

页面从上到下依次为：

顶部导航栏：切换语言、用户菜单
标签栏：切换「时序协作矩阵」和「动态仪表板」
工作流选择：下拉菜单选择业务场景
时序协作矩阵（泳道图）：显示 Agent 之间的消息流向
消息区：显示完整对话内容和 Agent 回复
底部输入区：附加文件、输入消息、发送

区域说明：

区域	功能说明
时序协作矩阵	以泳道图形式展示 Agent 之间的消息流向，每条泳道代表一个 Agent，箭头线显示消息传递方向
动态仪表板	点击顶部「动态仪表板」标签切换。当 Agent 生成图表、指标或状态卡时，自动在此区域展示
消息区	显示完整的对话内容，包括 Agent 的文字回复和附件。每条 Agent 消息旁有「中断该 Agent 当前工作」按钮和「收藏该对话」按钮
底部输入区	包含「附加文件」按钮、消息输入框、「发送」按钮。输入 @ 可提及指定 Agent
业务场景选择	页面顶部的下拉菜单，切换不同工作流。切换后，矩阵、消息和仪表板都会切换到该工作流的内容
消息工具栏	包含：「广播」复选框、「停止所有」按钮、「调整文字大小」按钮、「只看收藏」按钮

5.2 文件

集中管理平台中上传的文件和附件。

路径： 左侧导航 → 总览 → 文件

上传文件：将文件拖拽到上传区域，或点击区域选择文件。

文件出现在文件列表中，显示文件名及文件类型。

查找文件：在搜索框输入文件名，或按「类型」「来源」筛选。

文件列表按筛选条件显示匹配结果。

文件列表：显示所有已上传的文件或战情室 Agent 生成的需要下载的文件。

说明： 战情室对话也能加入附件。如果上传失败，先确认文件大小与类型是否符合页面显示的限制。如果不符，可点击「上传设置」，调整文件大小和类型。

六、协作资源

协作资源模块包含工作流和工作群组。

说明： 工作流与工作群组是关联关系：一个工作流可关联多个工作群组，一个工作群组也可属于多个工作流。创建时先建哪一方都可以，本手册建议先建工作群组，方便创建工作流时直接关联。

6.1 工作流

工作流是任务的多步骤模板，定义了任务从开始到完成需要经过哪些环节，比如“接单→排产→生产→质检→出货，每步交给不同 Agent 处理”。

路径： 左侧导航 → 协作资源 → 工作流

创建工作流：

点击「新增工作流」。
填写以下信息：名称（必填）、描述（选填）、工作群组（选填，关联工作群组）。
点击「保存」完成创建。
工作流列表中会出现新建的工作流。

6.2 工作群组

工作群组可将不同的代理组织在一起进行协作。

路径： 左侧导航 → 协作资源 → 工作群组

创建工作群组：

点击「新增工作群组」。
填写以下信息：工作群组名称（必填）、选择工作流（选填）、描述（必填）。
点击「保存」。
工作群组列表中出现新建的群组。

引导式功能使用（Growth、Business 和 Enterprise 三个版本有此功能，Foundation 版本无此功能）

路径： 工作群组列表 → 对应工作群组的「编辑」按钮 →「开始引导」按钮

操作步骤：

在工作群组列表中，点击对应工作群组的「编辑」按钮，进入编辑页面。
在页面顶部提示条右侧，点击「开始引导」按钮。
系统弹出引导对话框，根据填写的工作群组描述自动生成问题（如：该群组处理什么类型的内容）。
选择最符合您业务需求的选项，点击「下一步」。
依次回答所有问题至引导完成。
系统自动将引导结果写入该工作群组的注入规则。
引导完成后，注入规则中显示配置结果，Agent 将按照引导设定的规则工作。

七、管理

管理模块负责平台的基础配置，包括组织、代理和模型。

7.1 组织

路径： 左侧导航 → 管理 → 组织

管理当前组织的成员、权限和基本信息。

成员数、工作群组数、待处理数。
成员列表：显示组织内所有成员。

7.2 代理工坊

路径： 左侧导航 → 管理 → 代理工坊

代理工坊是创建和管理 AI 代理的核心页面。

创建代理：

点击「新增 Agent」。
填写基本配置：Agent 名称（必填）、角色（如 Generalist 通用型）、所属工作群组（必填）、表情符号、沟通风格、间隔。
点击「保存」。
Agent 列表中出现新建的 Agent。

7.3 模型维护

路径： 左侧导航 → 管理 → 模型维护

配置大语言模型供应商相关内容。仅支持管理员维护操作，成员仅有查看权限。

模型设定：在「模型设定」区域，点击「新增模型」。
弹出框选择供应商、模型 ID 协议以及「API Key」，点击「新增模型」。
在「Agent 模型」区域，为代理指定使用的模型，Agent 对应的模型列显示已分配的模型名称。

八、账户与偏好

用户菜单

点击右上角的用户图示，可以前往首页、设置、官方文档或退出登录。

账户设定

注意： 删除账户可能影响只有您一位成员的个人组织。操作前请仔细阅读确认消息。

忘记密码

在登录页点击「忘记密码」，依页面提示设定新密码。如果页面没有提供重置功能，请联络管理员协助。

语言与主题

语言：可从页面上的语言菜单切换简体中文、繁体中文、英文或日文。
主题：左侧菜单下方可切换明亮与深色外观。

九、常见问题

看不到某个菜单

确认目前组织是否正确（从顶部组织菜单查看）。
确认您的角色（管理员 / 成员）。
请管理员检查您的菜单权限及工作流权限。

看不到工作流或 Agent

确认已切换到正确组织。
确认您拥有对应工作流的读取权限。
Agent 只会出现在所属组织与工作流的范围内。

Agent 没有回复

确认 Agent 显示为可用状态（ONLINE）。
确认任务或消息发送到正确的工作流 / 工作群组。
确认 Agent 所属工作流和目前操作的工作流一致。
稍后待即时连线恢复后再检查。
若持续发生，将 Agent 名称、工作流名称与发生时间提供给管理员。

战情室没有自动更新

确认目前选择的工作群组。
等待系统重新连线。
重新加载页面。
若重新加载后才出现消息，请将发生时间与环境网址提供给管理员。

上传失败

查看页面显示的文件大小与类型限制。
重新选择文件后再试一次。
若仍失败，将文件名、大小与页面错误消息提供给管理员。

战情室代理显示「离线」

请依下面步骤依次排除：

在消息区发送消息唤醒，例如“@all 测试连通性，请回复 ok”。
确认供应商 API Key 有效且余额充足。
如仍无法上线，尝试在模型维护页面点击「重启 Gateway」。

需要进一步协助

联络管理员时，请提供以下信息，以便快速定位问题：

发生时间与时区
所在页面
组织、工作流、工作群组或 Agent 名称
页面显示的错误提示
可安全分享的操作步骤

反馈： 如果本说明未覆盖您的问题，请在平台内联系管理员或提交反馈。