用户手册

面向最终使用者,说明 Web 界面的全部功能与操作方法。
项目说明
文档名称TrueAGT 用户手册
适用对象TrueAGT 服务的使用者
配套文档《产品介绍》《部署指南》《多节点协作配置指南》《自定义工具指南》

服务端的完整配置项与管理员操作见《部署指南》。界面文案与按钮位置可能随版本调整,以实际页面为准。


1. 登录与注册

在浏览器访问服务地址(默认形如 http://<服务器地址>:8765)后:

1.1 注册

注册需填写:

项目要求
昵称2–32 位,可由字母、数字、下划线与中文组成,允许重名,仅用于展示
密码长度与复杂度遵循部署者设定的策略(默认 8–64 位,且须同时包含字母与数字)
邮箱 / 手机号至少填写一项,作为登录标识与账号找回通道,且不可与其他账号重复
邀请码仅在服务采用邀请码注册模式时需要,一码限用一次

注册成功后页面会一次性显示恢复码(形如 XXXX-XXXX-XXXX-XXXX)。请立即复制到密码管理器或纸质介质妥善保存:它是忘记密码时自助找回的唯一凭证,系统不会再次展示。

服务若采用零知识存储方案,注册后还会显示数据恢复密钥,用于遗忘密码时恢复已加密的个人资料;同样只会显示一次。

第一个注册的账号自动获得管理员身份(该策略可由部署者调整)。

1.2 找回密码

登录页点击「忘记密码?」打开自助找回窗口,填写登录标识、恢复码与新密码即可重置,无需管理员或邮箱介入。如曾保存数据恢复密钥,同时填入可在重置后保留个人资料;留空则资料被清除,需重新填写。

1.3 授权与试用

若发布方启用了授权管控,页面顶部会显示剩余天数或已授权状态横幅。试用期为 90 天(3 个月)且功能完整可用,结束后无法发起新对话(历史会话仍可查看)。管理员在「设置 → 授权」可先通过「获取授权码」了解线上(官网申请)与线下(联系发布方)两种渠道,并提供机器码以便签发时绑定本机;拿到授权码后粘贴并点击「激活」即可导入。授权无宽限期:到期即停止服务,请在到期前完成续期与激活。

1.4 登录凭证与锁定

登录凭证保存在当前浏览器中,有效期内再次访问无需重新输入(默认有效期由服务端设定)。账号被管理员停用后登录立即失效。退出登录在「设置 → 账号」中操作。

为防范暴力破解,同一账号连续登录失败达到阈值,或同一来源地址失败次数达到阈值,即触发临时锁定(默认阈值为同一账号 5 次、同一来源地址 20 次,锁定时长 15 分钟)。锁定期内即使密码正确也会被拒绝;锁定状态持久化保存,重启服务不失效。


2. 界面总览

产品标识 + 新建会话 搜索会话 会话列表 归档 特色功能 主题 菜单 · 账号名 · 模型标签 · 用量 · 通知 · 帮助 · 设置 · 后台 对话区(消息 + 执行过程) 工作区 模型 … 执行前需审批 · 字数 发送

2.1 侧栏

元素说明
+ 新会话创建并切换到新的会话
搜索会话按标题或内容检索历史会话
会话列表点击切换;条目右侧菜单提供重命名、归档、克隆与删除
📦 归档切换至已归档会话视图
特色功能本地知识库、思维链回溯、审计与处置等独立页面的入口
🌓 主题切换浅色与深色主题,选择保存在浏览器中

侧栏宽度可拖拽调整,窄屏下自动收起并通过顶栏 ☰ 打开。

2.2 顶栏

2.3 输入区

自上而下依次为附件预览、文本输入框与功能按钮行:

按钮功能
工作区选择本次对话所属的工作区
模型选择本次对话使用的模型
🕶切换临时会话(不保存到历史)
📤导出为 Markdown / JSON / Word / Excel / PPT,复制全文,或生成只读分享链接
📚提示词预设,可一键插入或保存当前内容为预设
⚡快捷指令
📎附加文件或图片
📄上传 Office 模板供文档填充使用
🗑清空输入框
🎛调整本轮对话参数(温度、系统提示、是否允许联网搜索等)
执行前需审批勾选时逐次确认计划;取消勾选则本会话内的低风险步骤自动放行
➤发送;生成过程中变为停止按钮

3. 发起对话

3.1 发送消息

上述快捷键可在「设置 → 通用与偏好 → 快捷键」中调整。回答以 Markdown 渲染,支持标题、列表、表格、引用、行内代码与代码块,代码块右上角提供复制按钮。

3.2 停止生成

回答生成过程中,发送按钮变为停止按钮,点击即可中止当前生成,已输出的内容予以保留。

3.3 执行过程

需要工具参与的任务,回答下方实时展示执行卡片:

卡片含义
执行计划任务被拆解出的步骤
调用工具 \<工具名\>工具名称与参数,执行完成后回填结果
反思阶段性自我评估,可展开或收起

3.4 计划确认

输入内容超过 30 个字符时,系统先生成执行计划并给出「批准执行」与取消两个选项;批准后按计划执行,执行过程实时展示。计划生成阶段同样可以用停止按钮中断。

若希望本会话内的低风险步骤自动放行,可取消勾选输入区的「执行前需审批」。

3.5 附件

可在输入框下方通过「📎」附加图片或文件:

3.6 导出与分享

通过「📤」可将会话导出为 Markdown、JSON、Word、Excel 或 PPT 文件,可复制全文,也可生成只读分享链接。导出文件中包含生成合成内容的相应标识。

3.7 生成内容标识

页面中所有由人工智能生成的回复均带有显式提示(「内容由 AI 生成,请注意甄别」),且该提示随复制与导出的内容一同保留。重要决策请自行核实人工智能回复的准确性。


4. 会话管理

操作方法
新建侧栏「+ 新会话」
切换点击列表中的会话
搜索侧栏顶部搜索框
重命名会话条目右侧菜单中的「重命名」
归档会话条目菜单中的「归档」;归档后从默认列表隐藏,在「📦 归档」视图中查看,可取消归档
克隆会话条目菜单中的「克隆」
删除会话条目菜单中的「删除」,删除后不可恢复

新会话在完成首轮对话后,标题由当前模型自动归纳;归纳失败时回退为首条消息的截断;已被手动重命名的会话不会被覆盖。删除操作会二次确认。

4.1 临时会话

点击输入区「🕶」可开启临时会话:该段对话不会保存到历史记录,刷新或新建会话即清除。页面顶部会显示相应提示条。需要长期保存记录请先登录。


5. 长期记忆

TrueAGT 可跨会话保留信息。直接以自然语言提出即可:

记住:我们团队的项目代号是 Falcon

之后在任何会话中询问「项目代号是什么」,系统都会检索到该条记忆并据此回答。也可主动要求回顾:

回忆一下之前记过什么

长期记忆按账号隔离,不同账号之间互不可见;超过容量上限时较旧的记录会自动归档。记忆条数显示在顶栏用量统计中。


6. 设置面板

点击顶栏「⚙ 设置」打开,按 Esc 或点击遮罩关闭。选项卡按分组排列:

「账户与安全」分组

选项卡内容
账号当前账号信息;昵称修改;邮箱与手机号的绑定、改绑(含验证码校验);账号安全(重新生成恢复码、重新生成数据恢复密钥、修改密码);退出登录;注销账号
授权授权状态与管理员激活授权码
API 密钥签发与吊销用于程序化访问的密钥(明文仅在签发时显示一次)
用户与权限展示本人账号信息与权限;管理员另可在此配置单点登录
管理总览管理员可见;实例全貌与服务端密钥保险库(密钥值仅保存在服务端,不返回浏览器)
注销账号将永久删除账号及其全部数据,且不可恢复。

「通用与偏好」分组

选项卡内容
通用界面语言(切换后立即生效,仅作用于本机浏览器)
快捷键查看与自定义发送、换行、搜索、新建会话、收起侧栏、清空、导出、帮助等快捷键
默认配置新会话的默认参数:温度、Top P 与是否默认启用联网搜索

「数据与能力」分组

选项卡内容
数据存储当前存储位置(本地目录或云盘)、备份状态与静态加密状态(是否启用、密钥指纹);发起数据迁移
工作区查看与新建工作区,设定全局默认工作区
模型服务预设模型清单与自定义端点;填写端点地址、密钥与模型名;连接测试;保存后即时生效,无需重启
联网搜索搜索引擎选择与密钥配置
工具市场按需启用/停用工具与插件并配置外部端点;停用的工具不再加载
自定义工具创建与管理自定义工具及其参数声明
知识库本机文档的导入与检索管理
技能库可复用技能的浏览与管理

「协作与节点」分组

选项卡内容
多节点协作配置本实例作为中央协调器,或作为节点加入既有协调器(保存后需重启生效);详见《多节点协作配置指南》
多智能体协作配置参与协作的角色名册
数据库查看当前数据库类型;SQLite 与 PostgreSQL 之间的切换需由管理员执行并在重启后生效

「诊断」分组

选项卡内容
数据流向自检查看对外请求的自检结果,便于核实数据流向

「关于」分组

选项卡内容
关于与升级当前版本号;检查更新(清单由服务端配置的地址提供);有新版本时可由管理员执行升级,升级后服务自动重启、页面稍后刷新

7. 后台管理

管理员可见「🛠 管理后台」按钮,点击后在独立页面打开后台管理,包含:

后台管理页面需使用管理员身份登录后方可操作。


8. 安全与隐私

TrueAGT 在数据保护上采用本地优先与全程加密的策略:

能力由 TrueAGT 提供,但其启用范围、策略参数、词表内容与留存期限由部署方(即服务提供者)决定并负责。使用者应了解:为履行内容安全与处置义务,部署方在必要时可依法对你产生的内容进行审核与处置。


9. 安装形态与使用方式

TrueAGT 是安装在你自有环境(本机或自有服务器)中运行的智能体软件,不是 SaaS,也没有官方托管的在线服务:

说明:TrueAGT 暂未提供 Android / iOS 移动客户端,移动端不具备独立应用;如需在手机上访问,仅能以浏览器打开自托管的服务地址,且未做移动端适配。请在本机或自有服务器安装后使用。

10. 常见问题的处理

为什么回复到一半停止了? 可能是达到了最大迭代步数(复杂任务被强制收敛),也可能是点击了停止按钮,或模型端点中断。换一种更具体的表述通常可以改善。

工具执行失败会怎样? 失败信息会作为反馈交给模型,模型会选择其他方式重试或说明原因,不会中断会话。

换了浏览器,用量统计为什么变化了? 用量按登录账号在服务端统计。若服务未启用鉴权,所有请求归入默认本地账号;若显示异常,请确认是否为同一账号登录。

聊天记录会丢失吗? 会话与记忆自动持久化,服务可按配置周期备份并保留指定份数。误删或升级异常时,由服务管理员停止服务后用最近的备份恢复。

密钥文件丢失怎么办? 密钥是唯一的解密凭据,丢失后历史密文无法恢复。请把密钥文件与数据备份分开存放。

忘记密码且恢复码也丢失怎么办? 若仍处于登录状态,可在「设置 → 账号 → 账号安全」凭当前密码重新生成恢复码;若已无法登录,需联系服务管理员处理。

试用期或授权到期怎么办? 试用结束后无法发起新对话,历史会话仍可查看;管理员在「设置 → 授权」激活新的授权码即可恢复。


11. 反馈与举报

如发现服务产生的内容存在违法、侵权或其他问题,可通过页面中的举报入口提交举报,填写举报类型与理由。管理员会在后台查看、处置并反馈处理结果;你可在「我的举报记录」中查看进度。

服务的运营主体、联系方式与投诉处理时限请以该服务对外公示的信息为准。

本文档随 TrueAGT 安装包一同发布;如与软件实际行为不一致,以软件当前版本为准。