PRODUCT USER MANUAL
AIvis用户操作手册
适用于管理员、普通用户与运维支持人员的标准操作说明
1. 产品概述
1.1 产品定位
具备连接大模型、企业知识、业务系统与智能体行动能力,帮助企业将分散在文档、数据库、应用和工作流中的知识转化为可检索、可问答、可执行的智能能力。
1.2 主要功能
AIvis 围绕企业智能化工作场景,提供从智能交互、知识管理、Agent 构建到系统治理的一体化能力,主要功能包括:
-
智能会话
功能特点:统一承载实时对话、企业知识检索、互联网搜索、多模型回答、多模态输入、会话分支、历史会话管理、文件预览与语音输入输出。
功能价值:让员工在同一入口完成提问、检索、分析和内容生成,减少在多个工具之间切换,提高日常知识获取和问题处理效率。
-
企业级 Agent
功能特点:支持按业务场景创建智能体,并配置专属知识库、模型、Skills、MCP 工具和业务 Actions,同时支持团队共享、权限控制、任务委派和长任务执行。
功能价值:把可重复的业务判断、资料分析和流程处理沉淀为可复用的智能助手,使不同团队能够按统一标准交付稳定结果。
-
项目工作空间
功能特点:按业务项目集中管理会话、文件和长期指令,新会话可持续复用项目背景、文件上下文和历史研究过程。
功能价值:保持项目资料和讨论上下文连续,降低重复上传、重复说明和跨会话信息丢失带来的沟通成本。
-
企业级知识库与搜索
功能特点:支持企业文档、网页、数据库、SaaS 系统和 API 数据接入,提供文档解析、切片、向量化、索引构建、权限同步、关键词搜索、语义搜索、混合搜索和引用溯源。
功能价值:将分散知识转化为可检索、可追溯、可权限控制的企业知识资产,帮助用户更快找到可信答案并核验来源。
-
Skills 与 Skills 市场
功能特点:将常用提示词、工作流程、分析框架、内容模板和工具使用方法沉淀为可复用 Skill,并可安装到 Agent、分享给团队或发布为组织级标准能力。
功能价值:把优秀经验从个人用法转化为团队能力,减少重复配置和提示词差异,提高复杂任务执行的一致性。
-
MCP 与 Actions
功能特点:通过 MCP Server 和 OpenAPI Actions 接入企业工具、数据服务和业务系统,使 Agent 可在授权范围内调用外部工具、读取数据、执行业务操作,并对高风险操作进行确认或审批。
功能价值:让智能体从“回答问题”扩展到“执行任务”,在受控权限和审计机制下连接真实业务流程。
-
企业连接器
功能特点:支持连接协作办公、网盘、Wiki、邮件、研发管理、CRM、客服、对象存储、数据库等企业系统,并持续同步、检索和调用企业信息。
功能价值:减少数据孤岛,让知识库随业务系统更新而持续刷新,为搜索、问答和 Agent 执行提供稳定数据来源。
-
LLM 与模型管理
功能特点:支持接入云端模型、本地模型和 OpenAI-compatible 兼容服务,管理员可统一管理模型供应商、密钥、默认模型、推理参数、Embedding、Reranker、Token 消耗和模型成本。
功能价值:在性能、成本、数据安全和合规要求之间灵活选择模型方案,并让组织统一治理模型使用。
-
多模态内容与文件处理
功能特点:支持读取、总结、生成和转换 Word、PDF、PPT、Excel、CSV、图片、视频、网页和代码等内容,并可生成文档、表格、演示稿、图片、视频、分析报告和可下载文件。
功能价值:覆盖更多业务材料类型,帮助用户把原始文件快速转化为结构化结论、可交付内容和可复用成果。
-
自动化与长任务
功能特点:支持将 Agent 配置为一次性任务或周期性任务,提供定时运行、结果投递、任务状态查看、长期记忆、任务列表、子任务拆分、中断恢复和错误处理能力。
功能价值:把周期性分析、监控和报告类工作自动化,释放人工跟进成本,并提高长流程任务的可追踪性。
-
隐私保护与安全治理
功能特点:支持敏感信息检测、脱敏、Token 化、请求阻断、本地模型处理、二次确认、企业隐私词典、身份认证、RBAC 权限控制、凭证加密、审计记录和高风险操作审批。
功能价值:在提升智能化效率的同时降低数据泄露、越权访问和误操作风险,满足企业安全和合规治理要求。
-
管理后台与运营分析
功能特点:管理员可统一管理用户、组织、Agent、Skills、知识库、模型、连接器、自动化任务和系统配置,并查看平台采用率、用户活跃度、模型调用量、Token 消耗、成本分析、请求日志和系统健康状态。
功能价值:帮助管理者掌握平台使用效果、资源消耗和运行健康度,为推广、优化和成本控制提供依据。
-
多端接入
功能特点:支持 Web 智能会话端、Web 管理后台、浏览器扩展、嵌入式 Chat Widget、CLI、桌面端,以及 Slack、Discord、企业微信、飞书、钉钉等 Bot 入口。
功能价值:让用户在已有工作入口中调用智能能力,降低使用门槛,并支持不同岗位、不同场景的接入方式。
1.3 术语表
术语 |
说明 |
管理员 |
拥有系统配置、用户管理、数据源管理等权限的角色。 |
普通用户 |
可在授权范围内搜索、问答、查看或创建内容的角色。 |
2. 使用前准备
2.1 环境要求
项目 |
最低要求 |
建议配置/说明 |
浏览器 |
Chrome / Edge 当前稳定版 |
建议使用桌面端浏览器访问后台管理功能。 |
网络 |
可访问产品服务域名 |
如需访问企业内网数据源,请确认 VPN 或网络策略。 |
账号 |
已完成注册或由管理员创建 |
首次登录后建议修改密码。 |
权限 |
具备对应菜单或功能权限 |
无权限时请联系管理员分配角色。 |
2.2 角色与权限
角色 |
典型权限 |
适用人员 |
系统管理员 |
用户管理、角色管理、系统配置、连接器管理、日志/状态查看 |
IT 管理员、平台负责人 |
业务管理员 |
业务范围内的数据源配置、文档管理、成员管理、使用统计查看 |
业务线负责人、知识库管理员 |
普通用户 |
搜索、问答、查看授权内容、上传个人文件 |
一线业务用户、知识工作者 |
只读用户 |
查看和检索授权内容,不允许修改配置 |
审计、外部协作或临时访问人员 |
3. 快速上手
3.1 首次登录与界面确认
在浏览器中打开产品访问地址,进入登录页。
填入账号密码,点击登录(如果没有账号可点击创建账号,输入账号和密码,完成注册)。
首次进入后检查左侧导航、个人头像、当前工作区和默认会话入口是否正常显示。
如系统要求补充个人信息、选择语言或完成账号验证,请按页面提示完成。
验证项 |
预期结果 |
异常处理 |
账号状态 |
可进入 /app 首页并看到个人菜单 |
联系管理员确认账号、角色、SSO 或邮件验证状态。 |
权限范围 |
仅显示当前角色允许访问的用户功能或管理入口 |
若缺少入口,先确认账号所属角色和用户组。 |
基础配置 |
可新建会话并正常加载输入框 |
记录页面路径和错误提示后反馈给一线支持。 |
3.2 个人信息配置
首次登录按提示填写您的用户名,点保存。提交成功后即完成基础配置。
3.3 推荐使用路径
使用目标 |
推荐入口 |
核心动作 |
完成标志 |
临时提问或资料总结 |
新建会话 |
输入问题、上传文件、选择模型或工具 |
得到答案、引用或生成文件。 |
检索企业文档 |
首页模式切换 / Search |
输入关键词或自然语言问题并查看来源 |
可打开相关文档并核对引用。 |
重复性业务处理 |
探索智能体 |
选择或创建 Agent,绑定知识、Skills 和工具 |
Agent 按固定指令稳定输出。 |
周期性跟进任务 |
定时任务 |
配置 Agent、计划、交付方式和预授权应用 |
任务按计划运行并生成历史记录。 |
4. 普通用户操作:智能会话与企业搜索
4.1 新建会话
点击左侧 新建会话,进入统一会话页面。
选择合适的模型,在输入框中输入问题、指令或待处理内容;
上传参考文件上下文时上传文件,按需选择 Chat 或 Search 模式、目标 Agent、模型、MCP 工具、Skills 或联网搜索能力。
发送后等待系统生成回答,查看答案、引用、工具调用结果和可下载附件。
对重要结论进行人工复核,并将会话移动到项目或导出为 Plaintext/Markdown 留档。
4.2 搜索模式
入口:新建会话中切换到搜索。
适用场景:快速查找企业文档、定位来源、对比多个资料片段。
操作要点:输入检索词或自然语言问题,结合数据源、时间范围、文档集等过滤条件缩小范围。
4.3 文件、多模态与生成结果
支持在会话中上传 Word、PDF、PPT、Excel、CSV、图片、视频、网页和代码等材料,系统会按配置完成解析、摘要、转换或生成。
涉及图片生成、视频生成、代码解释器或文件生成时,应核对输出文件内容、格式和敏感信息。
4.4 最近使用
左侧 最近使用 展示历史会话,支持按来源或 Agent 过滤。
会话右上角支持分享、全宽显示、移动到项目、导出和删除。
搜索会话可检索历史会话标题和内容,便于找回过往研究过程。
4.5 工具能力面板功能清单
点击输入框下方的工具能力按钮后,可按任务需要开启或选择以下能力。
功能 |
作用 |
使用建议 |
隐私防护 |
提交前对敏感信息进行保护,降低资料外泄风险。 |
处理客户、合同、财务或个人信息时优先开启。 |
内部搜索 |
调用企业知识库和内部文档检索,为回答提供组织内资料依据。 |
查制度、项目资料、历史报告或内部流程时使用。 |
网页搜索 |
补充互联网公开信息,适合获取外部背景、新闻或公开资料。 |
需要最新公开信息或外部对比时开启。 |
代码解释器 |
运行代码、处理数据或生成分析结果。 |
处理表格、计算、脚本和结构化数据分析时使用。 |
图片生成 |
根据提示词生成图片内容。 |
制作配图、草图、海报或视觉方案时使用。 |
视频生成 |
根据提示词生成视频内容。 |
制作演示片段、动态说明或营销视频时使用。 |
隐私防护处理说明
隐私防护开启后,上传文件会进行隐私扫描,扫描得到的相关敏感信息会加密后提交到大模型,避免造成数据泄露。加密字段明细会呈现到对话窗口,为防止二次泄密,隐私扫描结果仅当前窗口可见,刷新页面/查看会话等都不再展示。
5. 普通用户操作:项目、Agent、Skills 与任务
5.1 项目工作空间
入口:左侧 Projects 区域,可新建项目、进入项目详情或将会话拖入项目。
用途:按业务主题集中管理会话、文件和长期上下文,减少重复说明。
操作要点:创建项目后上传相关材料,把同一事项的会话移动到项目中;新会话可复用项目背景。
项目指令用于定义该项目中聊天会话的行为或语气,新会话会复用这些项目级要求。
项目文件会作为项目专属资料,提交后系统会自动完成内容索引和敏感词解析。
5.2 智能体浏览、创建与编辑
点击探索智能体,查看已固定、团队共享或可用 Agent。
点击 新建 Agent 创建智能体,填写名称、说明、固定指令、可见范围和能力配置。
按业务需要绑定知识库、文档集、Skills、MCP Actions 或 OpenAPI Actions。
保存后在普通会话中选择该 Agent 进行测试,确认回答风格、权限范围和工具调用符合预期。
管理员也可在 更多智能体 统一查看和治理组织级 Agent。
为 Agent 配置 MCP 能力
打开技能页面后切换到 MCP,按名称或分类查找 MCP 模板。
点击 + MCP 可将所选 MCP 能力添加到指定 Agent 中,保存后在 Agent 会话中验证工具调用是否符合预期。
5.3 Skills 市场
入口:打开技能页面;
用途:沉淀固定流程、提示词、模板、分析方法或工具使用规范。
操作要点:按分类或关键词检索 Skill,安装后在 Agent 或会话能力选择中启用;点击技能卡片可以查看技能详情。
5.4 定时任务
入口:打开定时任务页面,可新建、查看、暂停、恢复、编辑和删除任务。
新建/修改任务:任务名称,选择执行 Agent,填写执行指令,设置一次性或周期性计划,配置结果投递方式。
运行查看:任务详情页展示状态、最近运行、运行历史、错误信息和输出结果。
注意:涉及外部应用的任务应先完成授权或预授权,避免运行时卡在凭证确认。
6. 管理员维护:知识库、文档与数据源管理
6.1 管理入口与角色要求
入口:管理员后台 /admin,主要面向系统管理员、业务管理员。
6.2 连接器新增与授权
打开管理面板,点击添加连接器。
选择需要的连接器类型,根据页面提示选择填写认证方式。
保存后执行测试连接或首次同步。
点击查看连接器检查同步状态、错误和文档数量。
6.3 连接器同步状态
入口:打开索引状态, 查看已配置连接器及其索引状态。
常见操作:查看运行状态、触发同步、暂停/恢复、进入连接器详情。
验证标准:连接器状态健康,最新同步时间符合预期,失败文档有可追踪错误信息。
6.4 文档集
入口:打开文档集,将文档按业务范围组织成集合
常见操作:新建文档集、选择连接器或文档范围、绑定到 Agent 或搜索流程。
6.5 索引设置
入口:打开索引设置
常用功能:配置索引模型, 检索优化方案, 图像模型索引配置。
修改影响:可能触发重建索引或影响搜索结果,应在低峰期执行并记录变更。
7. 智能体、运行时、MCP 与外部集成
7.1 MCP
打开MCP,新增或编辑 MCP Server。
填写服务地址、认证方式、可见范围和工具暴露策略。
保存后在测试页面或 Agent 配置中验证可用工具列表。
7.2 OpenAPI 操作
入口:openAPI 操作
用途:通过 OpenAPI 规范接入企业 API,使 Agent 能按授权调用业务系统。
操作要点:导入规范、配置认证、选择可开放端点、测试参数和错误返回。
7.3 服务账号
入口:服务账号。
用途:为外部系统或自动化脚本创建受控访问凭证。
操作要点:创建时选择最小权限范围,记录用途和负责人;凭证泄露或离职交接时立即轮换。
7.4 Bot 与协作平台集成
集成类型 |
用途 |
注意事项 |
企业微信 Bot |
在企业微信中访问 Agent 或问答能力 |
确认回调地址、密钥和可见范围。 |
飞书 Bot |
在飞书工作区中接入智能问答 |
确认应用权限、事件订阅和成员范围。 |
钉钉 Bot |
在钉钉群或工作台中使用 |
确认机器人安全设置和消息回调。 |
Mattermost Bot |
在 Mattermost 中调用平台能力 |
确认服务地址、Token 和频道权限。 |
Slack/Discord |
按部署版本接入 Slack 或 Discord |
以页面实际开关和许可证能力为准。 |
7.5 钩子
入口:打开钩子,可配置事件触发扩展,通常用于企业级自动化或审计流转。
验证标准:应用显示已连接,任务运行记录中可看到成功调用或明确错误。
8. 模型、多模态与全局配置
8.1 模型密钥
入口:打开模型密钥页面,用于维护模型供应商密钥或兼容服务凭证。
8.2 语言模型
入口:打开语言模型页面,用于配置可选模型、默认模型、推理参数和模型可见范围。
验证标准:普通用户或 Agent 能选择授权模型并完成一次测试问答。
8.3 图片模型
入口:打开图片模型页面,用于配置图片生成模型、图片编辑模型。
8.4 视频模型
入口:打开视频生成页面,用于配置文本生成视频模型、图片生成视频模型、视频编辑模型。
8.5 聊天偏好设置
入口:打开聊天偏好设置页面,用于配置默认会话体验、可用能力和组织级提示偏好。
8.6 隐私防护
入口:打开隐私防护页面,用于查看隐私防护项目和配置防护字典。
9. 管理员维护:组织、权限、安全与审计
9.1 运维管理面板
入口:账号菜单/数据看板。该入口仅系统管理员可见,用于集中查看平台运行、采用率和 AI 成果指标。
时间范围:支持选择 7 天、30 天、90 天或自定义时间范围,并按当前时区生成统计结果。
刷新与关注项:可手动刷新数据;页面会根据数据覆盖、反馈样本、失败任务、Token/费用统计完整度等情况展示关注提示。
| 面板区域 | 展示内容 | 运维用途 |
|---|---|---|
| AI 成效总览 | 组织 AI 覆盖率、活跃员工、已核验 AI 成效 | 判断平台覆盖率和近期采用情况,识别是否需要运营推广或权限调整。 |
| 已核验 AI 成效 | AI 问答完成量、Agent 完成任务、自动化成功执行 | 评估智能会话、智能体和自动化任务是否稳定产出业务结果。 |
| AI 活动趋势 | 活动、Token、模型调用等分时趋势 | 观察使用高峰、异常波动和模型调用变化,辅助容量与成本治理。 |
| 反馈质量 | 正向反馈、负向反馈、已评分回复和反馈覆盖率 | 定位回答质量问题,并结合反馈样本持续优化提示、知识和 Agent。 |
| 热门能力与 Agent | 最受欢迎的 AI 能力、热门 Agent、使用人数和完成量 | 识别重点业务场景、低使用能力和下一步治理优先级。 |
9.2 用户
入口: 打开用户页面,查看用户列表、邀请请求或账号状态。
新增或调整用户时,确认邮箱、角色、启用状态和所属用户组。
禁用账号前确认业务交接,必要时同步处理其凭证、任务和共享资源。
| 管理项 | 查看或配置内容 | 管理价值 |
|---|---|---|
| 用户和请求 | 活跃用户、待接受邀请、用户列表和搜索筛选 | 集中掌握账号规模、邀请处理进度和当前账号状态。 |
| 限制开放注册 | 控制新用户是否必须通过邀请加入工作区 | 收紧账号入口,避免未知用户自行注册进入组织空间。 |
| 账号信息 | 邮箱、角色、启用状态、所属用户组和更新时间 | 便于管理员核对权限边界、业务归属和最近变更。 |
| 新增用户 | 账号邮箱、初始密码和创建操作 | 快速为新成员开通访问,并保留后续角色与用户组调整入口。 |
9.3 群组
入口:打开群组页面,用于维护用户组、数据访问范围和团队级权限。
主要功能:用户分组管理, 配置用户组共享连接器、文档集、智能体;设置组内大模型访问金额预算。
| 功能项 | 配置内容 | 管理价值 |
|---|---|---|
| 用户分组管理 | 用户组名称、组内成员和账号类型 | 按组织结构或业务场景统一维护成员访问边界。 |
| 共享资源 | 连接器与文档集、智能体 | 让同一用户组成员复用授权数据源、文档集合和业务智能体。 |
| 金额预算 | 金额预算(元)、时间窗口和新增限额 | 限制组内大模型访问金额预算,便于团队级成本治理。 |
9.4 SCIM
SCIM:/admin/scim,用于企业身份源自动同步用户和组。
| 配置项 | 操作内容 | 管理价值 |
|---|---|---|
| 配置入口 | 打开 SCIM 页面,查看同步状态和令牌配置 | 统一管理企业身份源与平台之间的用户和用户组同步入口。 |
| 新增配置 | 重新生成 Token 或创建 SCIM 令牌 | 为身份源提供受控凭证,便于开始同步用户和组。 |
| 令牌保存 | 下载或复制 SCIM 令牌,并妥善保存 | 令牌不会重复展示,应按企业凭证规范保管和轮换。 |
9.5 单点登录
入口:打开单点登录页面,用于配置 SAML、OIDC 等单点登录方式。
| 配置项 | 操作内容 | 管理价值 |
|---|---|---|
| 供应商类型 | 选择 OIDC 或 SAML | 匹配企业身份提供商协议,统一员工登录入口。 |
| 名称与显示名称 | 填写登录 URL 中使用的唯一名称和登录按钮展示名称 | 确保登录入口可识别;名称创建后不可修改,应提前确认命名规范。 |
| 认证参数 | 填写客户端 ID、客户端密钥等身份提供商参数 | 建立平台与身份源之间的可信登录关系。 |
| 创建与验证 | 保存后使用测试账号完成一次登录验证 | 确认用户可通过单点登录进入平台,并按预期获得权限。 |
10. 常见问题与故障处理
10.1 常见问题
问题 |
可能原因 |
处理方式 |
无法登录 |
账号未创建、密码错误、SSO 配置异常或账号被禁用 |
确认账号状态;重置密码;联系管理员检查登录策略。 |
搜索不到内容 |
无权限、数据未同步、筛选条件过窄或索引未完成 |
清除筛选条件;检查连接器同步状态、文档集和权限范围。 |
Agent 不调用工具 |
未绑定工具、显式选择未生效、工具不可用或需要审批 |
检查 Agent 配置、MCP/OpenAPI 状态和 Tool Call 审计。 |
定时任务未运行 |
任务暂停、计划配置错误、凭证过期或 Agent 不可用 |
检查任务详情、运行历史、预授权应用和错误提示。 |
生成文件打不开 |
生成过程失败、格式不支持或内容被安全策略阻断 |
重新生成并记录任务 ID;必要时联系技术支持。 |
选不到想要的模型 |
模型列表未勾选进可用模型 |
联系系统管理员检查模型配置,在对应模型选择页面将需要的模型加入可选列表 |
隐私防护无法开启 |
隐私相关服务未启动或未开启全局隐私防护功能 |
联系管理员检查隐私相关服务是否正常就绪,检查隐私防护开关是否正常配置 |
10.2 问题上报信息
账号、角色、用户组、工作区和操作时间。
问题页面、入口路径、操作步骤和截图。
错误提示、请求编号、任务 ID、运行 ID、连接器 ID 或会话 ID。
预期结果与实际结果,以及是否影响多个用户。
涉及模型、工具、连接器或 Bot 时,附上对应配置名称和最近一次运行时间。
11. 附录
11.1 截图规范
截图中应展示完整页面标题、关键输入项、目标按钮和结果区域。
涉及敏感信息、客户信息、密钥、Token、邮箱或内部地址时,发布前必须打码或替换为测试数据。
每张截图下方建议写明“图 X:功能名称 - 操作结果”。
11.2 功能模块清单
模块 |
主要入口 |
适用角色 |
功能点 |
智能会话 |
/app |
普通用户、管理员 |
新建会话、选择模式、上传文件、选择 Agent、联网搜索、工具调用、分享、导出、删除。 |
搜索 |
/app Search 模式 |
普通用户、管理员 |
企业文档检索、结果过滤、引用查看、来源打开。 |
项目 |
左侧 Projects |
普通用户、管理员 |
项目创建、会话归档、项目文件与上下文复用。 |
Agents |
/app/agents、/admin/agents |
普通用户、管理员 |
Agent 浏览、创建、编辑、固定、共享、知识和工具绑定。 |
Skills |
/app/skills、/craft/v1/skills |
普通用户、管理员 |
Skill 浏览、安装、详情查看、个人 Skill 编辑。 |
Scheduled Tasks |
/app/scheduled-tasks |
普通用户、管理员 |
任务创建、计划配置、运行历史、暂停恢复、结果投递。 |
Craft |
/craft/v1、/admin/craft |
授权用户、管理员 |
构建任务、Skills、应用连接;管理访问、应用和指令。 |
连接器 |
/admin/add-connector、/admin/indexing/status |
管理员、业务管理员 |
新增数据源、授权、同步、暂停恢复、错误查看、Stage Metrics。 |
文档治理 |
/admin/documents/sets、/explorer、/feedback |
管理员、业务管理员 |
文档集、文档浏览、反馈处理和质量排查。 |
Actions |
/admin/actions/mcp、/admin/actions/open-api |
管理员 |
MCP Server、OpenAPI Actions、工具暴露、认证和审批控制。 |
模型配置 |
/admin/configuration/model-credentials、/language-models |
管理员 |
模型凭证、模型列表、默认模型、参数和可见范围。 |
多模态配置 |
/admin/configuration/web-search、/image-generation、/video-generation、/voice、/code-interpreter |
管理员 |
联网搜索、图片、视频、语音、代码解释器能力开关与验证。 |
组织权限 |
/admin/users、/admin/groups、/admin/scim、/admin/sso-providers |
管理员 |
用户、用户组、身份同步、单点登录和访问范围管理。 |
安全审计 |
/admin/security、/admin/configuration/privacy-protection、/admin/tracing、/admin/performance/* |
管理员 |
安全加固、隐私保护、链路追踪、用量统计、查询历史和费用限制。 |
协作平台 |
/admin/chat-platform-bots/* |
管理员 |
企业微信、飞书、钉钉、Mattermost、Slack、Discord Bot 接入。 |
运维管理面板 |
/admin/dashboard、/admin/debug、/admin/systeminfo |
系统管理员 |
Dashboard 指标、活动趋势、反馈质量、热门 Agent/能力、活跃用户、LLM 使用量、日志下载和版本信息查看。 |