产品介绍

轻量级智能体框架与私有化部署方案。
项目说明
产品名称TrueAGT
版本持续迭代发布(详见发布说明)
许可专有软件,保留所有权利
适用对象有自建智能体服务需求的企业技术团队、系统集成方与个人部署者

1. 产品定位

TrueAGT 是一套离开了公有云也能完整运行的智能体框架与私有化部署方案:全部功能由服务端进程承载,浏览器作为唯一客户端,模型可以由部署者自行指定(部署在本地或托管于云端),业务数据留存在部署者自己的服务器上。

产品实现仅依赖 Python 标准库,运行时不引入任何第三方包,因此不存在依赖冲突与第三方组件供应链风险;可自由部署并按需配置,软件为专有软件、著作权归作者所有。


2. 合规立场(部署前请务必阅读)

TrueAGT 是工具,不是服务。

当你部署 TrueAGT 并向他人(尤其是社会公众)提供服务时,你就是法律意义上的「生成式人工智能服务提供者」,需由你自行履行相应义务,包括但不限于:

具体义务取决于部署形态与所在法域。中国境内主要依据《生成式人工智能服务管理暂行办法》《互联网信息服务算法推荐管理规定》《人工智能生成合成内容标识办法》等规定。

TrueAGT 提供内容安全过滤、生成内容标识、防篡改审计链、处置留痕、投诉举报入口等能力,用于帮助你履行上述义务;但 TrueAGT 既不保证你已完成合规,也不承担属于你的合规责任。能力是否启用、策略如何配置、词表内容如何界定,均由部署方决定并负责。

若你不向境内公众提供服务(自用或组织内部使用),按《生成式人工智能服务管理暂行办法》第二条的规定,备案与安全评估义务不适用;但个人信息保护、数据安全等一般性法律义务仍然存在。

TrueAGT 不宣称自身已通过任何国家认证,也不宣称部署 TrueAGT 即等同于合规。


3. 架构概览

TrueAGT 采用「原生桌面客户端 + 服务端」(C/S)结构,同时提供浏览器访问作为补充;服务端为单个 Python 进程:

原生客户端 (桌面) TrueAGT 服务端 默认端口 8765 规划与反思 工具执行 短期与长期记忆 模型接口层 REST 接口 / SSE 流式事件 Bearer 令牌鉴权

4. 核心能力

4.1 模型接入

协议说明
OpenAI 兼容适用于所有遵循 OpenAI 接口规范的端点,包括 DeepSeek、Kimi、通义、智谱,以及 llama.cpp、vLLM 等自托管推理服务
Anthropic对接 Anthropic Messages 接口
Ollama对接本地 Ollama 服务

模型配置可在网页端完成,包含预设清单、连接测试与保存后即时生效,无需修改配置文件或重启服务。

4.2 智能体执行

4.3 记忆体系

4.4 会话与任务管理

上述启用状态、工具清单与协作角色名册均可在网页端「设置」中配置。

4.5 多节点协作

支持控制面与数据面分离的多节点部署形态:中央协调器负责节点注册、令牌签发、任务中转与用量上报,不生成人工智能内容;各节点承担实际的模型调用与内容生成,数据留在本地节点。节点以客户端身份主动连接协调器,无需公网地址或开放入站端口。

4.6 安全、审计与治理

能力说明
身份与鉴权Bearer 令牌鉴权;支持用户名、手机号、邮箱、系统用户 ID 多种登录标识;可选多因素校验与企业单点登录
账号安全登录失败自动锁定(按账号与来源地址分别计数)、口令强度策略、一次性恢复码自助找回口令
联系方式保护零知识存储方式:服务端仅保存联系方式的不可逆令牌,不持有明文
限流按令牌或来源地址的滑动窗口限流
传输安全支持在服务端直接终结 TLS,也可经由反向代理终结
静态加密会话、消息、事件、长期记忆在写入磁盘前加密;可选国密 SM4;密钥保存在本机,不随备份或迁移外传
内容安全过滤提供输入输出双向过滤机制,命中策略与词表由部署方自备并负责
生成内容标识AI 生成内容带显式提示;导出的文件中亦包含相应标识
审计与处置留痕防篡改哈希链记录关键操作与工具调用,支持完整性校验;提供内容处置记录与导出
投诉举报内置举报入口与处置流程,管理员可查看、处理并反馈
后台管理提供独立于对话界面的后台管理,涵盖账号与权限、通知通道配置等
授权管理内置 RSA-2048 离线授权码校验,支持 90 天试用、授权激活与人数上限(无宽限期,到期即停服)
运维告警内置看门狗周期性巡检磁盘、内存、错误日志、授权到期与登录失败情况,可推送至企业微信、钉钉、飞书或通用 Webhook
指标与日志Prometheus 指标端点、结构化日志并按大小轮转
上述能力为机制,而非结论。例如内容安全过滤需要部署方自备并维护词表,审计留痕的留存期限需要由部署方通过备份与日志策略落实。TrueAGT 不承诺部署者已满足任何监管要求。

5. 部署形态

形态说明
发布包运行通过官方发布包(Windows 安装包 / 容器镜像 / macOS·Linux 发布包)运行,配置由 JSON 文件承载
容器提供容器镜像描述文件,配置、数据与日志以挂载方式持久化
系统服务提供 Linux 系统服务单元样例,便于交由守护进程管理
Windows 安装包面向 Windows 桌面的免 Python 环境安装包

未接入模型服务时,可通过离线演示模式(启动参数 --demo)在不调用真实模型的前提下体验完整交互流程。


6. 适用场景

场景说明
内网/离线环境助手数据与模型调用均在部署者网络内完成,不依赖外部服务
部门知识助理以长期记忆沉淀团队约定与偏好,人员轮换不丢失上下文
内部流程自动化借助工具与定时调度完成报表核对、资料整理等例行任务
模型评测基座在同一批任务上对不同模型作对比评测
扩展与集成结构清晰的核心模块与统一的工具、存储接口,便于按需扩展

7. 技术规格

项目规格
运行环境Python 3.10 及以上,无第三方运行时依赖;或容器环境
服务形态单进程 HTTP 服务,默认端口 8765;支持内置 TLS
通信协议REST 接口 + SSE 流式推送 + Bearer 令牌鉴权
存储默认 SQLite 单文件;安装驱动后可切换 PostgreSQL;可选 WebDAV 云盘作为数据存放位置
静态加密ChaCha20 + HMAC-SHA256(默认),或国密 SM4 + HMAC-SM3(可选)
模型接入OpenAI 兼容接口 / Anthropic / Ollama / MCP 客户端桥接
批量与并发多账号多会话;单会话串行执行并可随时中止
备份可按周期打包备份并保留指定份数
扩展方式多副本共享存储运行,或控制面与数据面分离的多节点协作

8. 版本与许可

本软件为专有软件,著作权归作者所有。

需要说明:本条款授予的是软件使用权。产品名称与标识、技术支持与服务等级承诺、定制模块与托管服务不属于使用授权范围;以本项目名义分发修改版或宣称其为正版/官方版本需另行获得授权。

配套文档:《用户手册》《部署指南》《API 参考》《数据流向声明》《隐私政策》《服务条款》《联网搜索配置指南》《自定义工具指南》《多节点协作配置指南》《演示手册》。

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