玄智智能体平台产品文档

一、产品介绍

玄智是一款功能丰富、易用性强的企业级智能体平台，核心定位为解决企业AI落地过程中面临的技术门槛高、部署成本高、迭代周期长三大核心痛点，助力企业实现AI能力的快速落地与降本增效。

为帮助企业及时跟进前沿大模型技术，玄智平台提供全链路AI落地支持：支持快速接入主流大模型，无需复杂技术开发即可完成模型适配；提供高效的专属知识库构建工具，实现企业私有数据的结构化处理与智能检索；创新设计渐进式升级路径，从基础的知识库问答（RAG）能力，到复杂业务流程自动化（Workflow），最终升级至具备自主决策与协同能力的智能体（Agent），全方位覆盖企业不同阶段的AI应用需求。

玄智已广泛赋能智能客服、智能财务、智能运维、智能人力等多个企业级应用场景，为不同行业客户提供定制化的AI解决方案。

二、快速入门

2.1 核心流程概览

玄智平台采用低代码操作模式，核心使用流程分为4步：环境配置 → 能力接入（大模型/知识库） → 业务场景配置 → 上线与迭代优化。

2.2 第一步：登录

使用企业账号密码登录平台，进入控制台首页，系统将自动引导完成初始化配置（包括企业数据隔离设置、角色权限分配）。

2.3 第二步：核心能力快速接入

大模型接入：进入「模型管理」模块，选择所需接入的主流大模型（如GPT、Llama、通义千问等），按指引填写API密钥或完成私有化部署对接，点击「测试连接」验证可用性；
知识库构建：进入「知识库管理」模块，点击「新建知识库」，上传企业文档（支持PDF、DOCX、TXT等格式）或导入结构化数据，系统自动完成文档拆分与向量索引构建，生成可检索的企业专属知识库。

2.4 第三步：简单业务场景配置

以基础知识库问答场景为例：

进入「智能体管理」模块，点击「新建智能体」，选择「知识库问答」场景模板；
关联已构建的知识库与接入的大模型，配置问答响应规则（如回答来源标注、未知问题处理策略）；
点击「预览测试」，输入测试问题验证问答效果，确认无误后点击「发布」即可上线使用。

三、更新日志

v1.0.0（初始版本）

核心功能：支持3种主流大模型（GPT-4、Llama 3、通义千问）的快速接入；
知识库能力：支持多格式文档上传与向量索引构建，实现基础RAG问答；
应用场景：上线智能客服基础模板，支持常见问题自动应答；
基础能力：完成企业级权限管理、数据加密存储、操作日志审计功能。

v1.1.0（迭代版本）

功能优化：新增2种大模型接入支持，优化知识库检索准确率（提升30%）；
新增能力：上线简单工作流（Workflow）配置工具，支持线性业务流程自动化；
场景扩展：新增智能财务发票识别基础模板；
体验优化：优化控制台操作界面，新增新手引导教程。

后续更新日志将通过官方平台公告同步，企业用户可在控制台「系统通知」中开启更新提醒。

四、系统架构

4.1 架构设计理念

玄智采用分层模块化架构设计，核心遵循「易用性、可扩展、安全合规」三大原则，实现大模型能力与企业业务场景的深度融合，同时保障系统的稳定性与可扩展性。架构整体分为五层，横向覆盖安全治理与运维监控能力，支撑企业级规模化部署。

4.2 核心架构分层

交互层：提供控制台Web界面、API网关、第三方系统集成接口（如企业微信、CRM系统），支持多端统一操作与跨系统协同；
核心服务层：平台核心能力集合，包括模型接入服务（多模型适配与调度）、知识库服务（文档处理、向量检索、知识管理）、工作流引擎（流程编排、任务调度）、智能体引擎（目标规划、自主决策、多智能体协同）；
数据层：采用混合存储架构，包括向量数据库（存储知识库向量数据）、业务数据库（存储企业配置、用户数据）、日志数据库（存储操作日志、运行日志），保障数据分类存储与高效访问；
基础设施层：支持公有云、私有云、混合云部署模式，提供计算资源调度、存储资源管理、容器化部署支持（Docker/K8s）；
安全治理层：覆盖全链路安全能力，包括数据加密（传输/存储）、权限管控（RBAC模型）、操作审计、合规校验（符合等保三级要求），保障企业数据安全与业务合规。

4.3 核心优势

模块化设计：各服务模块解耦，支持按需部署与横向扩展，适配不同规模企业需求；
多环境适配：支持多种部署模式，满足不同行业（如金融、政务）的数据隔离与合规要求；
高可用性：具备故障自动转移、负载均衡能力，保障系统7×24小时稳定运行。

五、安装部署

5.1 部署环境要求

5.1.1 硬件要求

基础部署（10人以内团队使用）：CPU ≥ 16核，内存 ≥ 32GB，存储 ≥ 500GB（SSD）；
规模化部署（企业级全场景使用）：CPU ≥ 64核，内存 ≥ 128GB，存储 ≥ 2TB（SSD），支持分布式存储扩展。

5.1.2 软件要求

操作系统：CentOS 7.6+、Ubuntu 20.04+；
依赖软件：Docker 20.10+、Kubernetes 1.24+（容器化部署）；
数据库：PostgreSQL 14+、Redis 6.2+、Milvus 2.2+（向量数据库）。

5.2 部署方式选择

私有云/本地化部署：
- 操作：提供部署镜像包与部署手册，支持自动化部署或手动部署；
- 优势：数据本地存储，完全符合企业数据隔离要求，可自定义运维策略。

5.3 部署流程概要

环境准备：配置操作系统依赖、安装必要软件（Docker/K8s、数据库）；
获取部署包：公有云部署直接登录官方平台申请，私有云部署联系商务获取镜像包；
执行部署：按部署手册执行部署命令，完成系统初始化配置（数据库连接、端口配置）；
验证部署：访问控制台地址，使用初始账号登录，执行健康检查脚本验证各模块可用性；
后期配置：完成企业数据导入、权限分配，即可正式使用。

详细部署步骤请参考配套的《玄智平台部署手册》，私有云部署用户可联系技术支持获取一对一部署指导。

六、功能手册

6.1 模型管理模块

6.1.1 核心功能

支持主流大模型的快速接入、管理与调度，实现多模型协同使用。

6.1.2 操作指南

接入大模型：进入「模型管理」→「新增模型」，选择模型类型，填写模型名称、API密钥（公有模型）或部署地址（私有模型），设置模型调用并发限制；
模型测试：接入后点击「测试」，输入测试文本验证模型响应效果，查看响应时间、准确率等指标；
模型调度：支持按业务场景分配模型（如客服场景使用GPT-4，财务场景使用通义千问），可设置模型降级策略（主模型故障时自动切换备用模型）。

6.2 知识库管理模块

6.2.1 核心功能

实现企业私有知识的上传、处理、管理与检索，为问答与智能体能力提供知识支撑。

6.2.2 操作指南

新建知识库：进入「知识库管理」→「新建知识库」，填写知识库名称、所属场景，设置访问权限；
导入知识：支持单文件上传、批量上传、URL导入（网站内容抓取），系统自动完成文档拆分、清洗、向量编码；
知识管理：可对知识进行分类、标签标注、编辑、删除操作，支持知识版本回溯；
检索优化：通过调整向量检索参数（如相似度阈值）、添加同义词词典，优化检索准确率。

6.3 工作流（Workflow）模块

6.3.1 核心功能

通过可视化拖拽方式配置业务流程，实现复杂任务的自动化执行（如发票审核流程、客户跟进流程）。

6.3.2 操作指南

新建工作流：进入「工作流管理」→「新建工作流」，选择空白模板或行业模板（如财务发票审核）；
配置流程：通过拖拽组件（如触发条件、执行任务、分支判断、人工审批节点）搭建流程，设置各节点参数（如任务执行对象、超时策略）；
关联能力：为流程节点关联知识库、大模型或第三方系统接口（如对接财务系统查询发票信息）；
测试与发布：点击「模拟运行」验证流程执行逻辑，确认无误后点击「发布」，设置流程触发方式（定时触发、事件触发、手动触发）。

6.4 智能体（Agent）模块

6.4.1 核心功能

基于知识库与工作流能力，构建具备自主目标规划、任务分解、工具调用能力的智能体，适配复杂业务场景。

6.4.2 操作指南

创建智能体：进入「智能体管理」→「新建智能体」，填写智能体名称、角色定位（如「智能财务顾问」）、核心能力描述；
配置能力：关联专属知识库、绑定可用工作流模板，设置智能体可调用的工具（如数据库查询工具、第三方API）；
定义行为规则：设置智能体的决策逻辑、任务分解策略、未知问题处理方式（如是否触发人工介入）；
训练与优化：通过上传历史对话数据、手动标注交互样本，优化智能体的理解与决策能力，支持实时调优。

七、常见问题

7.1 部署相关

问题：私有云部署时提示数据库连接失败？解答：请检查数据库服务是否正常运行，确认数据库地址、端口、账号密码配置正确，同时确保部署服务器与数据库服务器网络互通（关闭防火墙拦截规则）。
问题：公有云部署后访问控制台提示权限不足？解答：请确认企业认证已完成，使用注册时的企业主账号登录，若为子账号请联系主账号分配「控制台访问权限」（路径：「权限管理」→「角色配置」）。

7.2 功能使用相关

问题：知识库问答准确率低怎么办？解答：① 检查知识库文档质量，确保文档内容清晰、无冗余信息；② 对文档进行细分分类，添加精准标签；③ 调整检索相似度阈值（推荐设置0.7-0.8）；④ 补充同义词词典，优化检索匹配度。
问题：工作流执行过程中卡住如何处理？解答：进入「工作流管理」→「运行监控」，查看卡住节点的日志信息，常见原因包括：第三方接口调用失败（检查接口地址与权限）、任务参数配置错误（修正参数）、并发限制触发（调整节点并发数），修正后可点击「继续执行」恢复流程。
问题：无法成功接入某主流大模型？解答：① 确认模型API密钥有效且未过期；② 检查部署服务器网络是否可访问模型官方接口（可通过ping命令测试）；③ 确认平台版本支持该模型（参考更新日志，若不支持可升级平台版本）；④ 联系模型提供商确认接口未被限流。

7.3 性能与安全相关

问题：平台使用过程中响应缓慢？解答：① 基础部署场景可检查硬件资源使用情况（CPU/内存占用是否过高），适当升级硬件；② 规模化部署场景可开启分布式扩展，增加节点数量；③ 清理无用的知识库文档与历史日志，释放存储资源。
问题：如何保障企业数据在平台中的安全性？解答：玄智通过多重安全机制保障数据安全：① 数据传输与存储全程加密（采用AES-256加密算法）；② 采用RBAC权限模型，细粒度控制数据访问权限；③ 所有操作留存审计日志，支持追溯；④ 私有云部署模式下数据完全本地化存储，不对外传输。

八、实践教程

教程1：构建智能客服问答系统

1.1 场景目标

搭建具备7×24小时自动应答能力的智能客服系统，覆盖产品咨询、售后问题解答、人工转接引导等核心场景，降低人工客服压力。

1.2 前置条件

已完成玄智平台注册与企业认证；
准备企业产品手册、FAQ文档、售后政策文档等知识库素材；
已接入至少1种大模型（推荐GPT-4或通义千问）。

1.3 操作步骤

构建客服知识库：
- 进入「知识库管理」→「新建知识库」，命名为「客服专属知识库」，设置权限为「客服团队可见」；
- 批量上传产品手册、FAQ文档等素材，系统自动完成拆分与向量索引构建；
- 对知识库内容进行分类标注（如「产品功能」「售后流程」「价格政策」），添加常用问题作为同义词（如「退款流程」与「退款怎么操作」）。
配置问答规则：
- 进入「应用管理」→「新建应用」，选择「智能客服」模板；
- 关联「客服专属知识库」与已接入的大模型，设置回答格式（需包含问题分类、答案来源、人工转接入口）；
- 配置未知问题处理策略：当知识库无匹配答案时，自动回复「抱歉，我暂时无法解答该问题，是否为您转接人工客服？」，并提供人工转接按钮。
集成到企业服务渠道：
- 在应用配置页获取客服系统API接口与嵌入代码；
- 将智能客服嵌入企业官网、微信公众号、APP等服务渠道（参考平台提供的集成文档）；
- 配置消息推送规则，将智能客服无法解决的问题实时推送至人工客服系统。
测试与优化：
- 模拟用户常见问题进行测试（如「产品保修期多久？」「如何申请退款？」），验证回答准确率；
- 收集测试过程中的错误回答与未匹配问题，补充到知识库并优化检索参数；
- 上线后通过「应用监控」模块查看问答准确率、用户满意度等指标，持续优化知识库与问答规则。

教程2：搭建智能财务发票审核工作流

2.1 场景目标

实现企业发票审核流程自动化，包括发票信息识别、合规性校验、金额核对、审批流转，提升审核效率，减少人工错误。

2.2 前置条件

已完成玄智平台部署与初始化；
企业财务系统已开放API接口（支持查询供应商信息、合同金额）；
准备发票审核规则文档（如发票类型要求、税率标准、金额阈值）。

2.3 操作步骤

配置发票识别能力：
- 进入「插件管理」→「添加插件」，选择「发票识别」插件并启用；
- 上传发票样本（增值税专用发票、普通发票），训练识别模型，确保发票代码、金额、税率等关键信息识别准确率≥95%。
搭建审核工作流：
- 进入「工作流管理」→「新建工作流」，命名为「智能发票审核流程」，选择空白模板；
- 拖拽组件搭建流程节点：
① 触发节点：设置为「发票上传触发」（支持企业OA系统上传或手动上传）；

② 识别节点：关联「发票识别」插件，提取发票关键信息；

③ 合规校验节点：配置校验规则（发票类型是否符合要求、税率是否正确、销售方是否为合格供应商），对接财务系统API查询供应商信息；

④ 金额核对节点：调用财务系统API，核对发票金额与合同金额是否一致，设置金额误差阈值（如≤5%）；

⑤ 分支节点：合规且金额一致则自动通过审核；不合规则推送至财务专员人工审核；金额误差超阈值则退回申请人修正；

⑥ 结束节点：审核结果推送至申请人与财务系统，生成审核记录。
测试与上线：
- 上传不同类型的发票样本（合规、不合规、金额误差），测试工作流执行逻辑是否正确；
- 设置工作流权限，仅财务团队可查看与修改审核规则；
- 上线后通过「工作流监控」模块查看审核效率（如平均审核时长、自动审核通过率），持续优化校验规则与API对接稳定性。