产品文档

三易智通使用文档

完整的产品使用与最佳实践指南

快速开始

欢迎使用三易智通!三易智通是面向企业的 RAG + Agent 智能应用平台,融合检索增强生成、可视化工作流编排、工具调用和外部系统接入,为企业提供“理解、检索、生成、执行”的一站式智能化能力。

在开始之前,建议您准备:① 想让 AI 服务的业务场景;② 该场景下沉淀的文档资料(PDF/Word/Markdown/TXT 等);③ 选择接入的大模型(本地私有 / 国内云端 / 国际云端);④ 满足产品最低规格的运行环境(具体规格请联系交付工程师)。

产品架构

三易智通采用模块化架构,核心能力包括:**知识库管理** 负责文档接入、切片与向量化;**模型管理** 抽象 LLM / Embedding / Rerank 三类模型供应商;**应用管理** 承载对话应用、工作流应用与 Agent 应用;**工作流引擎** 提供低代码可视化编排;**工具与 MCP** 提供工具调用能力;**触发器** 支持定时任务与 Webhook 事件;**权限与审计** 实现细粒度权限与全链路审计。

产品只提供私有化部署(单机、容器化、集群按需)、准原生二进制交付(详情请咨询销售)与一体机(联想 ThinkStation PGX × 三易智通)等交付形态,不提供 SaaS 在线服务,数据全程留在企业内网。

系统要求

产品基于 Java 技术栈研发,**至少需要 Java 21 及以上 JDK** 作为运行环境。

充分利用 Java 21 的 **虚拟线程(Project Loom)** 技术,获得显著优于传统线程池的并发吞吐与资源利用率,在企业级高并发对话场景下延迟更稳、资源占用更低。

面向信创与轻量化交付场景,支持基于 **GraalVM Native Image** 的准原生二进制交付(详情请咨询销售)。

产品架构与部署方案 **符合信创要求**,可适配国产化操作系统与 CPU,满足等保与信创合规交付(国产化数据库适配按需评估)。

运行时还需准备:向量与全文检索所需的数据存储、缓存,以及对接的本地或云端大模型;具体规格请联系交付工程师按业务规模评估。

部署启动

方式一:单机直接启动 — 适合 POC 验证或中小规模生产。

方式二:容器化部署 — 通过镜像 + 环境变量配置数据源即可启动,适合标准化交付。

方式三(推荐):容器编排部署 — 按交付方案拉起应用、数据库与检索组件等依赖,适合生产环境标准化部署。

方式四:准原生二进制交付(详情请咨询销售) — 面向特定信创与轻量化部署场景。

首次部署可通过安装向导完成数据库、管理员账号与运行参数初始化;已完成安装后访问 `http://<host>:8080` 进入控制台。

创建您的第一个知识库

步骤一:登录管理后台,在「知识库」菜单点击「新建知识库」,填写名称、描述,并选择 Embedding 模型与切片策略。

步骤二:在新建的知识库中点击「导入文档」,批量上传业务文档并提交解析。

步骤三:系统自动完成解析 → 智能切片 → 向量化 → 入库,完成后即可进入「测试问答」面板验证召回与回答效果。

提示:首次使用建议先用 5–10 篇代表性文档跑通流程,再逐步扩充全量语料;切片策略对效果影响显著,可在「调试」面板观察具体切片结果。

知识库管理

知识库是三易智通的核心资产组织单元。一个知识库可包含多个文档,文档会被自动切片为多个语义片段,并写入高性能向量存储,供检索使用。

创建与组织

建议按业务域或团队职能划分知识库,例如「人力资源」「IT 运维」「合规制度」分别建库,可做到权限隔离与检索范围精确控制。

每个知识库可独立设置 Embedding 模型、切片策略、Reranker 与命中阈值,适配不同性质的内容(政策类、技术类、对话类等)。

文档导入

本地上传:支持 PDF、DOCX、Markdown、HTML、TXT、Excel、CSV 与图片等常见格式。

文档解析完成后可执行切片、向量化、全文索引与 OCR 识别,为问答和检索提供统一语料基础。

外部系统可通过平台 API 与工具能力对接知识库相关流程,用于和 OA、CMS、Wiki 等系统集成。

切片与向量化

切片策略包括 smart-split、fixed-size、heading-only、pattern、semantic-maxmin 与 ai-lumber 等,可按文档结构和模型能力选择。

上下文增强(Contextual Retrieval)可为切片补充文档级上下文,提升长文档召回效果。

Embedding 模型:中文场景推荐使用中文优化的开源 Embedding,通用场景可接入国内外主流云端 Embedding;每个知识库可独立指定模型。

模型管理

三易智通采用“模型中立”架构,将 LLM、Embedding、Rerank、ASR、TTS、图像生成等模型抽象为统一供应商接口,可在不修改应用的前提下自由切换底层模型。

大模型(LLM)接入

本地私有部署:支持主流开源大模型,通过本地推理运行时调度,模型与数据全程不出域。

国内云端 API:阿里通义千问、腾讯混元、字节豆包、百度千帆、智谱 GLM、月之暗面 Kimi、DeepSeek 等。

国际云端 API:OpenAI(GPT 系列)、Anthropic(Claude 系列)、Google(Gemini 系列)。

Provider 实例与模型定义分离管理,支持自由填写 API 模型名、配置调用参数、凭据脱敏存储与连通性测试。

Embedding 与 Rerank

Embedding 决定召回质量,中文优选中文优化的开源模型,通用场景可接入主流云端 Embedding。

Reranker 对召回结果二次精排,显著提升 Top-K 命中率,可灵活组合不同 Reranker。

可针对特定领域微调专属 Embedding 与 Reranker(定制版功能),进一步提升相似检索准确度。

多模态扩展

语音:ASR(语音识别)、TTS(语音合成)节点,支持接入云端或本地模型。

图像:图像生成节点可作为工作流节点接入,支持主流图像生成模型。

应用搭建

基于知识库与模型,可搭建对话智能体与工作流智能体,并通过 API、OpenAI 兼容端点、iframe 和 page script 嵌入到外部系统。

对话智能体

在「智能体」页面创建 SIMPLE 模式智能体,绑定一个或多个知识库、对话模型、系统提示词与工具,即可提供 RAG 问答能力。

支持多轮上下文、个性化记忆、引用溯源、回答审计、流式响应等企业级能力。

工作流应用

WORKFLOW 模式智能体基于可视化画布拖拽编排,适合需要多步骤、多分支、外部系统集成的复杂业务。

常见编排:用户提问 → 意图识别 → 知识检索 → 业务 API 查询 → LLM 整合生成 → 引用回写 → 推送结果。

智能体发布

每个智能体可配置名称、描述、欢迎语、系统提示词、知识库、工具、检索参数与访问权限。

智能体可颁发 API Key,供 OpenAI 兼容端点、iframe 嵌入页、page script 组件和外部业务系统调用。

API 与 SDK

智能体可通过 RESTful API 和 Agent API Key 集成至现有系统。

兼容 OpenAI Chat Completions 接口规范,可供已有 OpenAI SDK 或第三方客户端低成本接入。

提供 iframe 页面嵌入与 page script(widget.js) 两种前端集成方式,可在企业网站、内部门户或业务系统中上线对话窗口。

工作流编排

工作流引擎是三易智通的核心能力之一,采用低代码可视化设计,业务人员零代码搭建复杂智能应用。

节点类型

LLM 调用节点:配置模型、Prompt、温度、上下文窗口、停止词等。

知识检索节点:绑定一个或多个知识库,设置 Top-K、阈值、是否启用 Rerank。

条件判断节点:基于变量值、正则、表达式控制流程分支。

工具节点:调用已注册的 HTTP、SQL、MCP、内置、Shell、Groovy 或 Skill 工具。

子应用节点:调用已配置的应用能力处理子任务并返回结果。

回复节点:将流程结果组织为面向用户的最终响应。

对话上下文与记忆

多轮对话上下文:对话和工作流执行中可结合历史消息、用户输入与检索结果组织上下文。

个性化记忆可沉淀用户偏好与稳定事实,让助手在连续服务中更懂用户、更贴近业务语境。

Agent 记忆管理提供可视化查看、删除与清空能力,让个性化体验保持可控。

调试与发布

测试运行可查看节点执行过程、输出结果和耗时,便于定位流程配置问题。

智能体可发布到控制台、iframe、page script、企业 IM 或通过 API 供其他系统调用。

工具、触发器与 MCP

工具(Tools)与触发器(Triggers)让智能应用从“问答”升级为“行动”:主动调用外部系统、按时间或事件自动执行。

工具调用

HTTP 接口工具:通过配置 URL、方法、请求头、参数结构将企业内部 API 注册为可调用工具。

SQL 工具:通过数据源管理连接 PostgreSQL、MySQL、SQLite 等数据库,供智能体按配置查询。

MCP 工具:支持 SSE 与 Streamable HTTP 两种传输,可连接外部 MCP Server 并调用其暴露的工具。

内置、Shell、Groovy 与 Skill 工具可覆盖轻量计算、脚本执行和定制化能力扩展。

触发器

Cron 定时任务:按计划触发指定智能体或工作流执行,例如生成日报、周报或巡检结果。

Webhook 事件回调:外部系统可通过回调触发自动化流程,例如 CRM 新增线索后触发分析。

业务事件(Event):平台内部事件可作为触发源,触发执行记录可追溯。

集成与嵌入

三易智通提供丰富的接入渠道,让智能能力无缝融入企业现有业务场景。

网页嵌入

支持 iframe 页面嵌入,可把指定 Agent 的对话页放入企业 App、门户或业务系统页面中。

支持 page script 方式接入 widget.js,在现有页面上挂载气泡入口或对话窗口,适合不改页面结构的轻量集成。

企业 IM 与对话渠道

支持企业微信、钉钉、飞书渠道配置,可将智能体发布为企业内部助手。

员工可在对应 IM 渠道中使用已发布的智能体能力。

API 与 OpenAI 兼容

智能体提供 RESTful API 与 Agent API Key 鉴权,便于业务系统按需调用。

兼容 OpenAI Chat Completions 接口规范,已有 OpenAI SDK、前端应用和第三方客户端可低成本接入。

权限与安全

我们将安全合规作为产品的第一原则,内置完整的权限、审计、加密能力。

权限管理

知识库 / 文档 / 段落 / 模型四级独立 ACL 权限模型,支持用户与用户组两类主体、三级角色(超管 / 管理员 / 普通用户),可按角色、岗位、部门分配资源;DENY 一票否决、父级否决子级、public-by-default。

内置配额管理(知识库数 / 文档数 / 总容量 / 单文档大小);企业 SSO 单点登录支持 OIDC、飞书 / 钉钉 / 企微 OAuth、LDAP/AD 与 SAML 2.0。

审计日志

所有问答、检索、模型调用、工作流执行、配置变更、文档操作均会留痕,管理员可在审计面板查看、检索、导出。

审计日志记录操作人、资源、状态、耗时、IP 与 User-Agent 等信息,便于检索和追溯。

加密与合规

传输层 TLS + API Key / SSO 凭据脱敏存储;敏感配置字段在后台以占位方式保护。

产品架构与部署方案符合等保与信创合规要求。

常见问题

以下是用户最常咨询的问题,如未覆盖您的疑问,欢迎拨打 400-800-3537 或联系销售团队。

答非所问怎么办?

请优先检查:① 知识库是否包含正确答案;② 切片是否合理(可改为按标题或自定义);③ 是否启用了 Reranker;④ Prompt 模板是否需要优化。建议开启「引用溯源」并在调试面板查看实际检索到的原文片段进行调优。

可以处理多大量级的文档?

产品架构支持千万级文档片段的检索;多级缓存加速高频查询;全文检索补充召回路径。

高并发架构下单节点可承载较大规模并发对话;白金版与定制版支持在客户私有环境内横向扩容到多节点集群。

是否支持表格、图片中的信息?

支持 Excel / CSV 表格解析,也支持图片与扫描件 OCR。复杂表格、跨页表格等场景建议在 POC 中用真实样本验证解析效果。

私有化部署对硬件有何要求?

基础规模(中型企业 / 部门级)单机即可承载;大规模或高并发场景推荐多节点集群。

如启用本地大模型,需额外 GPU 节点;若不便自建 GPU,推荐采用三易智通 AI 一体机(联想 ThinkStation PGX × 三易智通)开箱即用。

还需要更多帮助?

联系销售或拨打 400-800-3537 获取专业支持