H3C百业灵犀AI助手 用户手册

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

资料版本：5W100-20241219

 

目  录

1 概述·· 1-1

1.1 产品简介·· 1-1

1.2 AI助手支持的功能·· 1-1

1.3 技术优势·· 1-2

1.4 AI助手使用方式·· 1-2

1.4.2 LinSeer Copilot页面·· 1-2

1.4.3 AI助手代码插件·· 1-3

1.5 AI助手业务配置流程·· 1-3

2 登录LinSeer Copilot页面·· 2-1

3 LinSeer Copilot前端会话页面使用指导·· 3-1

3.1 会话·· 3-1

3.1.1 功能简介·· 3-1

3.1.2 主要功能·· 3-1

3.2 助手·· 3-2

3.2.1 功能简介·· 3-2

3.2.2 主要功能·· 3-2

3.3 应用·· 3-3

3.3.1 功能简介·· 3-3

3.3.2 主要功能·· 3-3

3.4 搜索·· 3-8

3.4.1 功能简介·· 3-8

3.4.2 主要功能·· 3-8

3.5 个人中心·· 3-8

3.5.1 功能简介·· 3-8

3.5.2 主要功能·· 3-9

3.6 意见反馈·· 3-9

3.6.1 功能简介·· 3-9

3.6.2 主要功能·· 3-9

4 LinSeer Copilot后台管理页面使用指导·· 4-1

4.1 资源管理·· 4-1

4.1.1 指令管理·· 4-1

4.1.2 助手管理·· 4-3

4.1.3 资源权限管理·· 4-5

4.1.4 模型管理·· 4-5

4.1.5 知识库管理·· 4-6

4.1.6 智能体管理·· 4-7

4.1.7 页面配置·· 4-8

4.1.8 插件管理·· 4-9

4.1.9 数字人管理·· 4-10

4.1.10 应用管理·· 4-11

4.1.11 AI搜索管理·· 4-12

4.2 页面管理·· 4-13

4.2.1 菜单管理·· 4-13

4.2.2 参数设置·· 4-14

4.3 系统管理·· 4-16

4.3.1 用户管理·· 4-16

4.3.2 角色管理·· 4-19

4.3.3 定时任务·· 4-21

4.3.4 部门管理·· 4-23

4.3.5 license信息·· 4-25

4.3.6 操作日志·· 4-26

4.3.7 登录日志·· 4-27

4.3.8 应用配置·· 4-27

4.3.9 数据备份·· 4-29

4.3.10 问题反馈·· 4-30

5 AI助手代码插件使用指导·· 5-1

5.1 安装AI助手代码插件·· 5-1

5.2 自动续写代码·· 5-2

5.2.1 功能简介·· 5-2

5.2.2 主要功能·· 5-2

5.3 添加注释·· 5-3

5.3.1 功能简介·· 5-3

5.3.2 主要功能·· 5-3

5.4 解释代码·· 5-4

5.4.1 功能简介·· 5-4

5.4.2 主要功能·· 5-4

5.5 自定义提问·· 5-5

5.5.1 功能简介·· 5-5

5.5.2 主要功能·· 5-5

5.6 AI助手代码插件设置·· 5-6

 

1 概述

1.1  产品简介

H3C百业灵犀AI助手（LinSeer Copilot）利用百业灵犀大模型及大模型使能平台的能力，为用户提供原生的AI体验。它通过模拟人类智能行为，提供自然语言处理、机器学习和问题解决等能力，以帮助用户更加智能、高效、便捷地处理日常工作，解答用户的疑问。AI助手允许外挂本地知识库，以增强信息获取的准确性。此外，它也能根据用户的具体业务场景提供多样化的问答助手和智能应用，帮助客户在各类业务流程中都可以借助大模型能力来提高效率、降低成本。

图1-1 大模型、使能平台和AI助手关系图

 

1.2  AI助手支持的功能

LinSeer Copilot支持多种功能，包括但不限于以下几个方面：

·     知识问答：可以回答各种各样的问题，包括生活知识、历史事件、工作技能等。

·     语言翻译：可以实现跨语种的多语言翻译。

·     代码编程：可以进行代码理解、代码修改以及代码编写等工作。

·     数理推算：拥有基于思维链的推理能力，能够进行科学推理、常识推理等。

·     创意联想：可以进行进行多风格多任务的创意生成与联想，例如邮件，公文，策划方案等。

·     自动创作：可以根据用户需求自动创作PPT、图片和Word文档。

·     搜索总结：AI助手通过集成的搜索引擎，对用户的问题进行检索，对检索到的内容进行分析并生成总结报告。

1.3  技术优势

LinSeer Copilot具有如下技术优势：

·     打造用户访问AI服务的统一入口：LinSeer Copilot为用户提供了一个便捷的AI服务访问入口，支持WEB端和移动端访问，并能无缝嵌入到第三方应用中。用户可以在使能平台中进行复杂配置，而在AI助手中享受简洁直观的模型推理对话服务，从而提升用户体验。

·     能力集成，场景定制：LinSeer Copilot不仅集成了使能平台的模型功能，还融合了使能平台的提示词、知识库、智能体等扩展功能。它能够根据用户的具体需求定制专属场景，并预设了多样的行业通用场景助手，以满足不同行业客户的多元化需求。

1.4  AI助手使用方式

目前，用户可以通过两种工具使用AI助手的功能，如图1-2所示。

·     LinSeer Copilot页面：用户通过WEB端或移动端访问LinSeer Copilot页面后，可以使用AI助手的完整功能，并且对AI助手进行配置管理。

·     代码插件：AI助手产品专为代码编辑器或集成开发环境设计了一款插件，用户需要在第三方软件中安装并使用这款插件。

图1-2 AI助手使用方式

 

1.4.2  LinSeer Copilot页面

在LinSeer Copilot页面中，用户主要通过以下方式使用AI助手。

·     通过Prompt（提示）与AI助手进行交互。Prompt是用户给AI助手的一种输入，可以是文本形式的问题、请求、命令或其他类型的语句。用户输入的Prompt告诉AI助手需要执行什么样的任务或需要回答什么样的问题，例如“告诉我今天的天气”、“帮我整理一封专业的邮件回复”等。AI助手根据这些Prompt来解析用户的需求，并提供相应的信息、执行任务或与用户进行进一步的交互。

Prompt的设计对于AI助手的性能至关重要，因为好的Prompt设计可以帮助AI更精准地理解用户的意图，并提供更相关和高质量的响应。下面提供了一些设计Prompt的技巧：

¡     明确目的：在设计Prompt前，明确想从AI助手那里得到什么样的信息或希望它执行哪种类型的任务。

¡     明确角色：在Prompt中设定一个具体的角色，可以帮助AI助手更准确地理解用户的意图，并根据角色预期的行为作出响应。例如，可以设计这样的Prompt“作为一名旅游顾问，请帮忙推荐旅游的目的地及行程”。

¡     使用清晰的语言：采用直接和明确的语言，避免使用模糊或多义词语，避免不必要的复杂性。

¡     结构化Prompt：对于复杂的请求，使用结构化的Prompt可以帮助AI更好地解析用户的意图。例如，如果你设计一个旅行相关的旅游顾问，可以按照“目的地-日期-活动类型”等结构来组织。

·     使用AI助手提供的应用来自动生成Word、PPT、图片，翻译文本或解析文档内容进行问答。这些应用均依托于大模型能力，旨在拓宽AI助手的适用场景，为用户提供便捷实用的全方位服务。

·     通过AI搜索功能在互联网或知识库中搜索获得想要的信息。AI搜索是一种基于人工智能技术的搜索方式，相较于传统的搜索，它能够深度理解用户的搜索意图，提供更加智能的搜索结果和满足用户需求的搜索体验。

要想获得更好的搜索体验，在使用AI搜索功能时，您可以使用如下技巧：

¡     使用清晰的语言：采用直接和明确的语言，避免使用模糊或多义词语。

¡     切换表达方式：搜索结果不理想时，请尝试换一种表达方式重新搜索。

 

1.4.3  AI助手代码插件

在第三方代码编辑器或集成开发环境中安装AI助手代码插件后，用户即可以在软件中直接使用此插件智能生成代码、理解并注释代码，或以对话方式与AI助手进行智能问答。

1.5  AI助手业务配置流程

如图1-3所示，为了能够在AI助手的前端页面使用AI助手服务，在AI助手的后台管理页面需要完成如下业务配置：

(1)     获取License：在“系统管理-License管理-License信息”页面，设置License server的信息，以便从License server获取AI助手的授权许可。否则，无法使用AI助手。

(2)     同步资源：AI助手初始状态下不包含大模型、知识库等资源，需通过如下步骤从使能平台上同步大模型、知识库、插件、智能体等资源。

a.     在“页面管理-参数设置”页面，设置AI助手的参数，包括AI助手从使能平台请求资源的使能请求URI等。

 

b.     在“系统管理-定时任务”页面，设置定时从使能平台同步资源，或手动执行一次资源同步。

完成资源同步后，在AI助手上可以查看并使用从使能平台同步过来的大模型、知识库、插件、智能体等资源。

(3)     权限管理：权限管理分为页面操作权限管理和资源使用权限管理。

¡     页面操作权限：用来限制用户可以访问及操作的AI助手页面。页面操作权限的设置方法为在“系统管理-用户管理、角色管理、部门管理”页面，配置用户、角色和部门。

¡     资源使用权限：用来限制用户可以使用的资源。资源使用权限的设置方法为在“系统管理-用户管理、角色管理”页面下创建用户和角色，指定用户所属的角色，并在“资源管理-资源权限管理”页面下设置角色的资源访问权限。

(4)     （可选）管理资源：AI助手的资源包括模型、知识库、插件、助手等。在AI助手后台管理页面完成资源的配置和管理后，用户就可以在AI助手前端页面上查看并使用对应的资源。不同资源的管理方式如下。

¡     指令：指令是用户在使用AI助手时的提问模板。借助指令，用户能够更准确地在特定领域提出问题，提高了AI助手的使用效果。在“资源管理-指令管理”页面上，可以创建和管理指令。

¡     助手：助手是针对特定场景或领域的智能问答服务。助手中预先设置了特定场景或领域的知识库、提示词等，以便为用户提供更好的AI问答服务。助手既可以在“资源管理-助手管理”页面上手工创建，也可以在“资源管理-智能体管理”页面上将从使能平台同步的智能体发布为助手。在“资源管理-数字人管理”页面上，可以设置数字人形象及语音，并将指定数字人与助手绑定。助手与数字人绑定后，使用该助手时，将在对话界面上展示数字人的形象，并利用数字人的语音功能进行语音回答。

¡     模型：在“资源管理-模型管理”页面，查看从使能平台同步过来的模型信息，并修改模型参数。

¡     知识库：在“资源管理-知识库管理”页面，查看从使能平台同步过来的知识库的信息。

¡     插件：在“资源管理-插件管理”页面，查看从使能平台同步过来的插件的信息、AI助手上自定义的插件信息，并设置是否允许使用该插件。

¡     应用：在“资源管理-应用管理”页面，管理AI助手的智能应用，包括智能文档、文档阅读、智能翻译、智能PPT、灵犀智画等。

¡     AI搜索：在“资源管理-AI搜索管理”页面，配置AI搜索功能的相关参数，包括检索模式、模型配置以及推荐问题。

(5)     （可选）发布助手：在“系统管理-应用配置”页面，可以将助手发布为独立的应用，用户可以通过助手的发布URL地址访问并使用该助手。

(6)     （可选）数据备份：配置AI助手的过程中，建议在“系统管理-数据备份”页面定期备份数据，以防止系统异常导致的数据丢失。

图1-3 推荐业务配置流程

 

2 登录LinSeer Copilot页面

LinSeer Copilot安装部署完成后，在浏览器地址栏中输入LinSeer Copilot的登录地址，进入LinSeer Copilot登录页面，如图2-1所示。其中，登录地址格式为：https://ip_address:30088，登录IP为“LinSeer Copilot的集群北向业务虚IP”，默认登录的用户名/密码为admin/Admin@h3c。

图2-1 百业灵犀AI助手登录页面

 

 

LinSeer Copilot包括前端会话页面和后台管理页面两部分：

·     前端页面：用户在此页面进行对话问答交互、AI搜索以及应用使用。

·     后台管理页面：管理员可以在此页面对前端AI助手可用资源进行管理，例如指令、助手、知识库、插件、智能体等资源，也可以在此页面对后台和AI助手的系统本身外观、参数进行配置。

用户名、密码输入完成后，点击<立即登录>按钮，进入LinSeer Copilot前端会话页面，如图2-2所示。点击该页面右上角的调色盘图标，可以更改LinSeer Copilot的显示风格；点击该页面右上角的用户图标，可以查看系统信息、反馈意见、进入后台管理页面（如图2-3所示）、查看当前用户信息、退出当前登录。

图2-2 百业灵犀AI助手前端会话页面

 

图2-3 百业灵犀AI助手后台管理页面

 

3 LinSeer Copilot前端会话页面使用指导

3.1  会话

3.1.1  功能简介

会话页面的功能主要是利用多种大模型进行智能问答。用户登录之后直接就可以进入会话页面。

3.1.2  主要功能

·     选择大模型、知识库、插件以及对话模式

¡     大模型：选择使用大模型能力部署的推理服务。

¡     知识库：选择挂载的知识库。知识库是一个集合了特定领域或主题的知识和信息的管理数据库，将知识库挂载到服务中，可以为服务提供知识库的实时的查询和检索功能，以便服务能够根据用户需求进行相关性匹配、数据检索和知识推理等操作。

¡     插件：插件是添加到大模型中，用来扩展大模型功能或简化与特定应用程序集成的组件或工具。

¡     对话模式：选择单轮会话时，推理服务将不结合上下文，直接根据用户的问题进行回答；选择多轮会话时，推理服务会将最近的数个问答对作为上下文来对问题进行回答。

请根据实际情况进行选择。

·     创建新会话

在历史会话（即已经进行过对话交互的会话）中，单击<新建会话窗口>按钮，可以创建新的会话。AI助手将从第一个输入的问题中截取内容，作为该会话的标题。

新创建的会话默认使用上一个会话的模型、知识库、插件和对话模式。如果用户不想使用这些配置，可以进行重新选择，但是新会话一旦产生对话交互，就不允许再修改大模型、知识库以及插件的选择。

在一个全新的会话中，不允许创建新的会话。

·     唤出提示词

在问题输入框中输入“/”，可以唤出用户收藏的提示词，以便用户快速选择提示词，提高效率、减少输入错误、提高指令的准确性。

·     修改会话

选中一条历史会话，单击“修改”按钮，可以修改会话的标题。

·     删除会话

选中一条历史会话，单击“删除”按钮，可以删除该会话。

·     导出会话

单击右侧悬浮的“导出会话”按钮，选择要导出的问题和答案，可以将当前会话中选中的问题和答案导出到excel文件中。

·     推荐指令

单击右侧悬浮的“推荐指令”按钮，进入提示词页面。在该页面，可以对提示词进行收藏、复制和使用。

¡     单击“复制”按钮，该条提示词会复制到剪切板上，用户可以将其粘贴到对话框或者其他位置。

¡     单击“收藏”按钮，该条提示词会被用户收藏，在问题输入框可以使用“/”唤出收藏的提示词。

¡     单击“使用”按钮，会跳转到之前的会话窗口，并且提示词会被复制到问题输入框中。

3.2  助手

3.2.1  功能简介

助手市场中展示了可供用户使用的助手模板，这些模板为用户提供了完善的Prompt模板或知识库信息，以帮助用户获得更加准确的回答。例如，“应急方案助手”中预设Prompt的角色为应急救援专家，目标任务为根据提供的情况说明及相关资料写一份事件的最佳应用处置、救援、资源调度等全维度的预案，需求为按照专业的应急规范和标准进行撰写。利用“应急方案助手”，用户仅需要在问题输入框中输入事件（如，暴雪天气，中小学生上下学），助手模板就会自动将其转化为有效的Prompt，从而获得针对该事件的应急处理方案。

图3-1 助手市场

 

 

3.2.2  主要功能

·     选择助手模板

用户根据实际情况选择所需的助手模板后，点击该助手模板，系统会进入基于该助手模板的会话。

·     查看已使用的助手模板

在“助手列表”页面可以查看用户使用过的助手模板。选中一条使用助手的会话记录，单击“删除”按钮，可以删除该会话。

3.3  应用

3.3.1  功能简介

AI助手不仅为用户提供文字AI问答功能，还利用AI大模型能力推出了一系列智能化办公应用，以拓宽AI助手的适用场景，为用户提供更加便捷实用的一体化AI工具。

目前，AI助手支持如下应用：

·     智能PPT：按照用户指定的主题和参考内容自动智能生成PPT。

·     智能文档：按照用户指定的用途自动生成Word文档，或为用户提供的文字内容进行加工美化。

·     智能翻译：提供多种语言的翻译功能。

·     文档阅读：使用大模型来解析用户上传的文档内容，解析完成后用户可以针对文档中的内容进行问答。

·     灵犀智画：使用大模型能力智能生成图片。

图3-2 百业灵犀AI助手应用选择页面

 

3.3.2  主要功能

·     智能PPT

在应用选择页面中，单击<智能PPT>按钮，进入PPT文档创作页面。AI助手的PPT创作过程如下：

a.     在主题内容输入框中，输入需要生成的PPT主题。

b.     （可选）上传用于生成PPT内容的参考文档。

c.     （可选）输入演讲角色和PPT报告的类型

d.     选择PPT的主题模板，缺省使用深色主题模板。

e.     单击<生成大纲>按钮，生成PPT大纲。

f.     在生成的PPT大纲中，可以单击大纲中的标题、添加按钮或删除按钮，对大纲的内容进行修改、添加和删除。如果用户对大纲生成效果不满意，可以单击<重新生成>按钮重新生成一份PPT大纲。

g.     单击<生成演示PPT>按钮，AI助手根据当前大纲生成完整PPT文档。

PPT文档生成后，显示在“我的作品”页签中，用户可以单击作品列表“操作”列的<下载>或<删除>按钮来将AI助手生成的PPT文档下载到本地或从系统删除。

单击页面右上方的返回按钮可以返回应用选择页面。

图3-3 百业灵犀AI助手智能PPT页面

 

 

·     智能文档

在应用选择页面中，单击<智能文档>按钮，进入word文档创作页面。word创作目前支持内容生成和内容加工。

¡     内容生成操作

点击右侧的“内容生成”页签，选择生成的文档类别和用途，并且输入文档主题相关内容，然后单击<生成正文>按钮，可以按需生成word文档内容。

在生成过程中，单击<停止生成>按钮可以中断word文档的生成过程。

word文档生成结束后，如果对生成效果不满意，可以通过单击<重新生成>按钮重新生成一份相同主题但内容重新组织的word文档。如果要继续生成其他文档，请单击<返回>按钮返回“内容生成”页签。

¡     内容加工

在已有内容的word文档中，选中任意文本段落，页面即会弹出功能框，可以通过如下功能对文本内容进行加工：

-     润色：对文本细节进行改进，以提高可读性、流畅度和表达效果。

-     扩写：在原有文本基础上进行详细的补充和扩展，以增加内容的丰富性和细节。

-     精简：对文本进行缩减和简化，使文本更加简洁明了。

-     续写：在原有文本的基础上，增加新的内容，来延续原文本的思路和主题。

执行内容加工后，加工后的文本内容会显示在右侧“内容加工”页签对应的功能栏下。单击<插入>按钮可以将加工后的文本内容插入到文档光标所在位置，单击<替换>按钮可以将加工后的文本内容替换掉文档中选中的内容。

在生成过程中，单击<停止生成>按钮可以中断文本内容的生成过程。

左侧word文档栏中罗列了当前已生成的word文档，单击其中的下载按钮可以将word文档下载到本地，单击删除按钮可以将word文档从系统中删除。

单击word文档右上角的<保存>按钮可以在系统中保存当前word文档，单击word文档右上角的<导出>按钮可以将当前word文档下载到本地。

单击页面右上方的返回按钮可以返回应用选择页面。

图3-4 百业灵犀AI助手智能word生成页面

 

·     智能翻译

在应用选择页面中，单击<智能翻译>按钮，进入文本翻译页面。智能翻译应用目前支持文本直接翻译和文档翻译。

¡     文本直接翻译

点击“文本翻译”页签，将需要翻译的文本粘贴进左侧文本框，在右侧选择需要翻译的语种，然后单击<翻译>按钮，完成文本翻译。

¡     文档翻译

点击“文档翻译”页签，单击<选择文档>按钮，将需要翻译的文档从本地上传至系统中，在上方选择需要翻译的语种，然后单击<开始翻译>按钮，智能翻译应用开始对文档进行翻译。翻译的结果显示在“历史翻译”页签中，用户可以将翻译后的文档下载到本地或从系统中删除。

在文档翻译中，还可以指定翻译的术语。例如将源术语设置为“个人计算机”，目标术语设置为“PC”，智能翻译应用对中文文档进行翻译时，就会将文档内的“个人计算机”翻译为“PC”。术语以术语表的形式组织，在翻译时，智能翻译应用会使用用户勾选的术语表进行翻译。用户可以对术语表中的术语进行编辑和删除，也可以导入外部术语表或将当前术语表导出到本地。

单击页面右上方的返回按钮可以返回应用选择页面。

图3-5 百业灵犀AI助手智能翻译页面

 

·     文档阅读

在应用选择页面中，单击<文档阅读>按钮，进入基于文档内容的问答页面。基于文档内容的问答功能使用过程如下：

a.     ‍点击“新建问答”页签，然后点击页签中部区域，将需要文档阅读应用解析的文档上传至系统。

b.     上传文档完成后，单击<开始问答>按钮，开始基于文档内容对大模型进行问答。

c.     跳转至“文档问答”页签，等待文档解析完成。

d.     在右侧的问题框中输入问题进行问答会话。

e.     在“文档问答”页签中，可以在左侧的历史记录中点击系统历史分析过的文档，针对选中的文档进行问答会话。

f.     在“历史文档”页签中可以查看和管理上传至系统的文档。单击历史文档列表中“操作”列的<阅读>按钮，可以跳转至“文档问答”页签，针对选中的文档进行问答会话。单击历史文档列表中“操作”列的<删除>按钮，可以在系统中删除指定的文档；在历史文档列表第一列中勾选若干个文档，然后单击列表上方的<批量删除>按钮，可以批量删除选中的文档。

g.     在“新建问答”页签中，单击<选择历史文档>按钮，在弹出的对话框中勾选若干个文档，然后单击<确定>按钮，可以针对选中的所有文档进行问答会话。

图3-6 百业灵犀AI助手文档阅读页面

 

·     灵犀智画

在应用选择页面中，单击<灵犀智画>按钮，进入图片生成页面。灵犀智画应用的使用过程如下：

a.     ‍在“描述你的图片场景”输入框中输入用户想要生成的图片的文字描述。

b.     （可选）在“不希望出现的内容”输入框中输入用户不希望在生成的图片中出现的内容。

c.     在“模型列表”下拉框中选择用于生成图片的大模型服务。

d.     （可选）在“图片数量”配置项处选择根据文字描述生成的图片数量。

e.     （可选）在“图片尺寸”配置项处调整生成的图片的比例和像素。

图3-7 百业灵犀AI助手灵犀智画页面

 

 

3.4  搜索

3.4.1  功能简介

用户可以在本页面中基于人工智能技术在互联网和知识库中搜索需要的内容。

图3-8 搜索页面

 

3.4.2  主要功能

(1)     点击页面左侧菜单栏中的“搜索”，进入AI搜索页面。

(2)     在输入框中输入需要搜索的问题，然后单击发送按钮，系统会对输入的问题进行搜索。

在输入框下方罗列了推荐问题，点击这些问题可以直接使用推荐的提问内容进行搜索。

(3)     AI搜索过程中可以单击<停止生成>按钮，停止问题的搜索。搜索完成后，系统会对检索到的内容进行分析，然后生成一份总结和整理后的答案。

(4)     AI搜索生成答案后，单击<追问>按钮，在弹出的输入框中输入问题，然后单击发送按钮，可以针对已获得的答案进行进一步提问。

(5)     在左侧的问答历史记录栏中可以查看历史搜索记录以及对历史问答进行追问。

3.5  个人中心

3.5.1  功能简介

用户登录后，可以通过个人中心查看和修改自己的用户信息。

图3-9 个人中心

 

3.5.2  主要功能

点击右上角用户图标，在下拉框中点击“个人中心”，进入个人中心页面，在此页面用户可以查看和修改自己的基础信息，以及修改密码。

3.6  意见反馈

3.6.1  功能简介

如果您在使用AI助手时遇到任何问题，或者有任何改进建议，欢迎通过我们的“意见反馈”功能告知我们。我们非常重视您的反馈，并将努力利用您的宝贵意见不断完善我们的服务。

 

3.6.2  主要功能

点击登录用户图标，选择“意见反馈”，进入意见反馈页面。在该页面，输入意见标题、意见类型、描述及问题截图后，单击<确定>按钮，即可将您的意见反馈给我们。

图3-10 意见反馈

 

4 LinSeer Copilot后台管理页面使用指导

4.1  资源管理

4.1.1  指令管理

1. 功能简介

指令相当于用户在使用AI助手时的提问模板。借助指令，用户能够更准确地在特定领域提出问题，提高了AI助手的使用效果。

指令管理页面用于管理AI助手的指令，在此页面上，用户可以对指令进行分类、新增、编辑、删除、上下架以及设置/取消热门操作。

图4-1 指令管理

 

2. 主要功能

·     新增指令分类

单击<新增分类>按钮，在弹出的对话框中输入分类名称，然后单击<确定>按钮，完成指令分类的新增。创建的指令分类以列表形式在页面左侧展示。

图4-2 新增指令

·     修改指令分类

在页面左侧的指令分类列表中，单击修改功能对应的按钮，可以修改指令分类的名称。

·     删除指令分类

在页面左侧的指令分类列表中，单击删除功能对应的按钮，可以删除指令分类。

·     新增指令

a.     ‍单击指令列表上方的<新增>按钮。

b.     在弹出的对话框中，填写指令的名称，选择指令的分类，然后填写指令内容（即AI助手提问模板）。

c.     选择指令的状态，指令处于“已上架”状态时，该指令才能被用户使用。

d.     单击<确定>按钮，完成指令新增。

·     编辑指令

单击指令列表“操作”列中的<编辑>按钮，修改指令的配置。

·     删除指令

可以通过以下两种方式删除指令：

¡     删除单个指令：单击指令列表“操作”列中的<删除>按钮，可以删除指定的指令。

¡     批量删除指令：在指令列表的第一列中勾选若干个指令，然后单击指令列表上方的<删除>按钮，可以批量删除勾选的指令。

·     批量上架/下架指令

在指令列表的第一列中勾选若干个指令，然后单击指令列表上方的<上架>或<下架>按钮，可以批量上架或下架勾选的指令。

·     设置热门指令

在指令列表的第一列中勾选若干个指令，然后单击指令列表上方的<设为热门>按钮，可以将勾选的指令设置为热门。在新建AI助手会话窗口时，热门指令显示在前端会话页面的“推荐指令”中，用户可以从中进行选择从而快速使用指令进行问答。

单击指令列表“操作”列的<取消热门>按钮，可以取消指令的热门设置。

·     查询指令

在页面上方的搜索栏中，输入和选择搜索条件，然后单击<搜索>按钮，页面将仅显示符合搜索条件的指令。如需清除所有查询条件，显示所有指令，请单击<重置>按钮。

4.1.2  助手管理

1. 功能简介

助手帮助用户在特定场景或领域中获得更好的提问效果。部署助手后，用户可以前端会话页面中使用指定的助手进行会话，系统会在助手指定的场景或领域中进行回答。并且，助手中还可以预置问题，用户可以通过预置的问题直接进行提问以快速获得问答结果。

助手管理页面用于管理助手，在此页面上，用户可以对助手进行分类、创建、修改、删除、以及设置为推荐。

图4-3 助手管理

 

2. 注意事项

·     助手只有处于“已上架”状态，并且在“资源管理权限”页面中被授权给用户使用时，用户才可以在AI助手的问答功能中使用该助手。

·     绑定了应用的助手无法被删除。

3. 主要功能

·     新增助手分类

单击<新增分类>按钮，在弹出的对话框中输入分类名称，然后单击<确定>按钮，完成助手分类的新增。创建的助手分类以列表形式在页面左侧展示。

·     修改助手分类

在页面左侧的助手分类列表中，单击修改功能对应的按钮，可以修改助手分类的名称。

·     删除助手分类

在页面左侧的助手分类列表中，单击删除功能对应的按钮，可以删除助手分类。

·     创建助手

a.     ‍单击助手列表上方的<创建助手>按钮。

b.     在弹出的对话框中，填写助手的名称，填写助手的功能描述，然后选择助手的分类。

c.     在“指令”文本框中，输入助手的前置提示词，相当于助手给大模型预设了一个具体语境，大模型将在此语境下进行回答。例如，设置指令为“在安全生产过程中”时，用户在使用助手提问的过程中，无需输入提问的具体情境，推理服务就会以“在安全生产过程中”作为场景进行问题回答。

d.     （可选）在“知识库”下拉框中选择知识库，推理服务即可以根据问题在知识库中进行检索，以帮助用户获得更准确的回答。

e.     在“模型选择”下拉框中，选择助手使用的大模型推理服务。

f.     在“推荐问题”文本框中，输入为助手预制的问题，用户可以直接使用这些问题进行提问。最多创建两个推荐问题。

g.     在“状态”下拉框中，选择助手的上架状态。

图4-4 创建助手

 

·     编辑助手

单击助手列表“操作”列中的<编辑>按钮，修改助手的配置。

·     删除助手

单击助手列表“操作”列中的<删除>按钮，可以删除指定的助手。

·     设为推荐

单击助手列表“操作”列中的<设为推荐>按钮，可以将指定的助手设为推荐。被设置为推荐后，该助手被展示在AI助手会话首页中。

·     上架/下架助手

在助手列表的第一列中勾选若干个助手，然后单击助手列表上方的<上架>或<下架>按钮，可以批量上架或下架勾选的助手。

·     查询助手

在页面上方的搜索栏中，输入和选择搜索条件，然后单击<搜索>按钮，页面将仅显示符合搜索条件的助手。如需清除所有查询条件，显示所有助手，请单击<重置>按钮。

4.1.3  资源权限管理

1. 功能简介

资源权限管理页面用于管理登录至AI助手的用户角色权限，包括查看权限和修改权限功能。

图4-5 资源权限管理

 

2. 主要功能

·     查看权限

单击角色列表“操作”列的<查看权限>按钮，可以查看指定角色拥有的助手使用权限以及大模型使用权限。

·     修改权限

单击角色列表“操作”列的<修改>按钮，在弹出的对话框中通过勾选，修改指定角色拥有的助手使用权限、大模型推理服务使用权限以及知识库使用权限。

·     查询角色

在页面上方的搜索栏中，输入搜索条件，然后单击<搜索>按钮，页面将仅显示符合搜索条件的角色。如需清除所有查询条件，显示所有角色，请单击<重置>按钮。

4.1.4  模型管理

1. 功能简介

模型管理页面主要用于对从百业灵犀大模型使能平台同步过来的模型进行管理，该页面支持根据名称检索模型、编辑模型信息等功能。

图4-6 模型管理

 

2. 主要功能

·     搜索模型

在模型搜索栏中输入模型名称，单击<搜索>按钮，可以查询到对应的模型信息。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

·     编辑模型

编辑模型的配置方法为：

a.     ‍单击模型对应操作列的<编辑>按钮，打开编辑模型对话框。

b.     设置Tmperature（采样温度）和Top-P（核心采样）。

-     Temperature：用于控制生成过程的随机性或确定性。较高的Temperature值将使输出更加随机，更加多样化；较低的Temperature值将使输出更加集中和确定。

-     Top_P：影响结果的确定性，Top_P的数值越小结果确定性越强；数值越大，结果越随机。

模型名称、推理服务名称以及模型版本不支持修改。

c.     单击<确定>按钮，完成模型编辑操作。

4.1.5  知识库管理

1. 功能简介

知识库管理页面主要对从百业灵犀大模型使能平台同步过来的知识库进行查看。该页面支持根据名称检索知识库，查看知识库详情（包含知识库名称、响应模式、场景绑定以及知识库提示词等）等功能。

图4-7 知识库管理

 

2. 主要功能

·     搜索知识库

在知识库搜索栏中输入知识库名称，单击<搜索>按钮，可以查询到对应的知识库信息。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

·     查看知识库详情

单击<详情>按钮，可以查看到对应知识库的名称、知识库描述、响应模式、场景绑定以及知识库提示词等。

4.1.6  智能体管理

1. 功能简介

智能体是利用大规模预训练模型构建的人工智能系统，它通过人工智能技术模拟人类行为，进行自然语言理解、决策支持和交互等任务。智能体能够在多种场景中应用，如客服、教育、咨询等，为用户提供问答、信息检索、数据分析等服务。

在智能体管理页面可以查看AI助手系统从百业灵犀使能大平台同步过来的智能体。这些智能体可以发布为一个用于prompt的助手，为用户提供服务。

图4-8 智能体管理页面

 

2. 注意事项

AI助手系统每隔五分钟从百业灵犀使能大平台同步一次数据，包括智能体、知识库、插件等。在“系统管理”的“定时任务”页面，单击智能体同步定时任务对应操作列的“执行一次”按钮，可以立即执行一次智能体同步任务。

3. 主要功能

·     查看智能体的信息

智能体管理页面通过列表的形式显示了AI助手系统从百业灵犀使能大平台同步过来的智能体的信息，包括智能体名称、智能体描述信息、智能体的引导语。

·     将智能体发布为助手

单击智能体对应操作列的“发布为助手”按钮，在弹出的对话框中：

a.     输入助手名称，助手功能的描述。

b.     选择发布的助手归属的助手类型。只能选择当前系统中已经创建的类型。

c.     （可选）输入推荐问题，用户可以在智能体发布为的助手中直接使用推荐问题进行提问。

·     查看智能体对应AI助手的信息

单击智能体对应操作列的“查看助手”按钮，可以查看智能体对应AI助手的信息，包括助手名称、功能描述（即智能体的引导语）、助手类型、推荐问题。

4.1.7  页面配置

1. 功能简介

页面配置主要用于对AI助手的外观进行管理和个性化设置，以及对会话的部分参数进行设置。

图4-9 页面配置

 

2. 主要功能

单击<编辑>按钮后，用户可以对系统配置、会话配置以及模型对话长度限制进行修改。

·     系统配置

在“系统配置”区域：

¡     “系统名称”表示AI助手首页左上角显示的名称；

¡     “欢迎语”表示会话未开始时会话窗口显示的引导语；

¡     首页右上角点击用户图标弹出的下拉框中，“关于”页面中显示了“版权信息”；

¡     “系统logo”表示AI助手首页左上角的图标；

¡     “头像”表示会话中大模型回答问题时使用的头像；

¡     “登录页背景”表示用户在登录AI助手时，登录页面的背景图片。

用户可以按需修改这些配置。

·     会话配置

在“会话配置”区域，用户可以自行选择AI助手的会话页面是否显示模型、知识库以及会话模式的选择框。

·     模型对话长度限制

在“模型对话长度限制”区域，管理员可以为每个可用的推理服务修改用户单次提问可以输入的最大字符数。

4.1.8  插件管理

1. 功能简介

插件是添加到LLM（Large Language Model，大语言模型）中、用来扩展LLM功能或简化与特定应用程序集成的组件或工具。插件可以帮助用户快速构建LLM应用，或将LLM集成到自建程序中。插件与模型服务协同工作，可以为用户提供更多种类、更高质量的服务，例如：

·     检索实时信息，如本地天气，体育比分、股票价格等。

·     检索知识库信息，如公司文件、个人笔记等。

·     代表用户执行操作，如订机票、订餐等。

插件通过API（Application Programming Interface，应用程序接口）与LLM交互。LLM是插件API的智能调用者，它通过插件的API描述，来判断并主动调用插件API来执行操作。例如，如果LLM上添加了查询天气插件，那么当用户问“今天的天气怎么样？”时，LLM不会回答它并未掌握的实时信息，而是会通过API调用天气相关的插件，然后根据插件的数据生成面向用户的答案。

在插件管理页面可以查看AI助手系统从百业灵犀使能大平台同步过来的插件。这些插件可以辅助AI助手，为用户提供更加丰富的服务。

图4-10 插件管理页面

 

2. 注意事项

AI助手系统每隔五分钟从百业灵犀使能大平台同步一次数据，包括智能体、知识库、插件等。在“系统管理”的“定时任务”页面，单击同步插件定时任务对应操作列的“执行一次”按钮，可以立即执行一次插件同步任务。

3. 主要功能

·     查看插件的信息

插件管理页面通过列表的形式显示了AI助手系统从百业灵犀使能大平台同步过来的插件的信息，包括插件名称、插件的描述信息、插件的状态、插件来源、插件类型等。其中：

¡     插件的状态：插件在AI助手上的可用状态，取值包括已上架和已下架。已上架表示AI助手可以使用此插件；已下架表示AI助手不可以使用此插件。

¡     插件来源：插件的获取方式，取值包括使能同步和自定义。使能同步表示该插件由AI助手系统从百业灵犀使能大平台同步而来；自定义表示该插件为开发人员在程序中编写添加的插件。

·     修改插件信息

单击插件对应操作列的“编辑”按钮，可以修改插件的名称、插件的描述信息以及插件的状态。

4.1.9  数字人管理

1. 功能简介

数字人是AI助手中的虚拟人物形象，其主要功能是提高用户交互的生动性和个性化体验。AI助手与数字人绑定后，它能够在对话界面展示数字人的形象。同时，AI助手不仅可以通过文字形式回答用户的问题，还能利用数字人的语音功能进行语音回答。通过模拟真实人类的形象和语音，数字人能够与用户进行更加自然的对话交流，提供更具沉浸感的服务体验。

在数字人管理页面，用户可以选择数字人形象、数字人使用的语音音频，设置数字人对话界面的背景图片，并指定与数字人绑定的AI助手。

图4-11 数字人页面

 

2. 主要功能

·     新增数字人

单击<新增>按钮，设置数字人名称、数字人对接模式、数字人形象、人物声音等信息后，单击<确定>按钮，完成新增数字人操作。

·     修改数字人

单击数字人对应操作列的“修改”按钮，即可修改数字人名称、数字人对接模式、数字人形象、人物声音等信息。

·     删除数字人

单击数字人对应操作列的“删除”按钮，即可删除指定的数字人。

3. 参数说明

表4-1 新增数字人参数说明

参数	说明
数字人展示名称	数字人的名称。
对接模式	数字人的部署和访问方式，取值包括： ·     公有云：数字人服务部署在互联网上可公开访问的云平台中，这些平台由第三方云服务提供商操作和管理。 ·     私有云：数字人服务部署在一个受限的、私密的云环境中，适合对数据隐私和安全性要求更高的场合。
appKey	由数字人服务提供方分配的唯一标识符，用于识别访问数字人服务的应用程序。 AI助手在发送的请求中携带appKey，数字人服务通过appKey来认证AI助手的身份。 仅在对接模式为公有云时，需要配置本参数。
密钥(appSecret)	与appKey配对使用的密钥，用于加强API请求的安全性。它是一串需要保密的字符，用于确保请求的完整性和防止篡改。 仅在对接模式为公有云时，需要配置本参数。
账号	AI助手访问数字人服务时需要使用的账号，用于登录数字人管理系统或服务平台。 仅在对接模式为私有云时，需要配置本参数。
密码	AI助手访问数字人服务时需要使用的密码，用于验证AI助手的身份。 仅在对接模式为私有云时，需要配置本参数。
数字人形象	在公有云或私有云提供的数字人库中选择一个符合需求的虚拟形象。这些形象可能具有不同的性别、年龄、着装风格等。
人物声音	为数字人选择一个合适的语音。
绑定助手	指定与数字人绑定的AI助手。
数字人背景	数字人对话界面的背景图片。

 

4.1.10  应用管理

1. 功能简介

本页面用于管理AI助手的智能应用，包括激活应用、修改应用是否上架、修改应用使用的推理服务等功能。

图4-12 应用管理

 

2. 注意事项

只有状态为“上架”和“激活”的应用可以被用户使用。激活应用的前提是获取场景应用的License授权，应用可激活的数量与License授权数量对应。

灵犀智画应用通过“H3C 百业灵犀大模型AI助手灵犀智画授权函-1年”或“H3C 百业灵犀大模型AI助手灵犀智画授权函”进行license授权，其他应用通过“H3C 百业灵犀大模型AI助手场景应用授权函-1个-1年”或“H3C 百业灵犀大模型AI助手场景应用授权函-1个”进行License授权。例外的是，“H3C 百业灵犀大模型AI助手多模态推理一体机授权函”自带灵犀智画应用的授权。

3. 主要功能

·     激活应用

在应用列表左侧复选框勾选若干个应用后，单击列表上方的<激活>按钮，可以激活应用。

灵犀智画应用在获取License授权后会自动激活，无需手动激活。

·     编辑应用

单击应用列表“操作”列的<编辑>按钮，在弹出的对话框中可以修改应用的描述、应用是否上架以及应用使用的大模型推理服务。

4.1.11  AI搜索管理

1. 功能简介

本页面用于配置AI搜索功能的相关参数，包括检索模式、模型配置以及推荐问题。

图4-13 AI搜索管理页面

 

2. 注意事项

在选择融合检索模式时，如果配置的知识库阈值比联网检索阈值高，则AI搜索功能仅在知识库中检索答案。如果配置的知识库阈值不高于联网检索阈值，则AI搜索功能同时在所选的知识库以及互联网中检索答案，并通过大模型进行总结，以提高答案的丰富度。

3. 主要功能

·     检索模式

在AI搜索管理页面中，单击<编辑>按钮，可以修改AI搜索管理功能的配置。

AI搜索功能支持三种检索模式：

¡     融合检索：可以同时在所选的知识库以及互联网中检索答案，并通过大模型进行总结输出。适用于需要结合内部数据和最新外部信息的场景。

¡     知识库检索：仅在知识库中检索答案，并通过大模型进行总结输出。适用于问题涉密，或对信息来源有较高可靠性要求的场景。

¡     联网检索：在互联网中检索答案，并通过大模型进行总结输出。适用于涉及的信息需要频繁更新或超出知识库范围的场景。

选择不同的检索模式时，可以配置的参数不同。

完成配置后，单击<确定>按钮使配置生效，或单击<取消>按钮取消配置的修改。

·     模型配置

a.     在AI搜索管理页面中，单击<编辑>按钮，可以修改AI搜索管理功能的配置。

b.     在模型选择下拉框中，选择AI搜索功能使用的大模型推理服务。

c.     （可选）在多样性配置项中，可以通过滑轨或右侧的输入框修改此项配置的数值。此项配置用于控制内容生成过程的随机性或确定性；较高的值将使输出更加随机，更加多样化；较低的值将使输出更加集中和确定。

d.     （可选）在核心采样配置项中，可以通过滑轨或右侧的输入框修改此项配置的数值。此项配置用于影响结果的确定性，值越小结果确定性越强，值越大结果越随机。

e.     完成配置后，单击<确定>按钮使配置生效，或单击<取消>按钮取消配置的修改。

·     推荐问题

a.     ‍在AI搜索管理页面中，单击<编辑>按钮，可以修改AI搜索管理功能的配置。

b.     “推荐问题”是AI搜索功能预置在页面中的问题，用户可以直接使用这些问题进行提问。

c.     完成配置后，单击<确定>按钮使配置生效，或单击<取消>按钮取消配置的修改。

4.2  页面管理

4.2.1  菜单管理

1. 功能简介

菜单管理用来展示AI助手当前支持的页面菜单项及其信息，包括：

·     排序：菜单在页面上的排列顺序。数值越小，菜单的排列位置越靠前。

·     权限标识：允许操作该菜单的用户权限。

·     创建时间：菜单的创建时间。

图4-14 菜单管理

 

2. 主要功能

·     查看菜单信息

在菜单管理页面，可以查看菜单名称、菜单的排序编号、权限标识等信息。

·     修改菜单信息

单击菜单对应操作列的“修改”按钮，可以修改菜单的名称。

4.2.2  参数设置

1. 功能简介

参数设置用于配置系统运行所需要的一些系统参数，如使能请求URL。

图4-15 参数设置页面

 

2. 注意事项

参数设置页面可以显示系统预先设置的参数，不允许用户添加和删除参数。

每个参数都有其特定的用途和作用域。在未完全确定参数的功能及其对系统影响的情况下，请保持默认设置，不要随意更改参数名称和键值，以免引入错误。

3. 主要功能

·     修改系统参数

可以通过以下方式，修改参数的名称、参数的键值、登录验证方式和备注信息。

¡     点击参数对应操作列的“修改”按钮，进入修改参数页面。

¡     勾选参数前的复选框，单击<修改>按钮，进入修改参数页面。

图4-16 修改系统参数

 

·     清理缓存

单击<清理缓存>按钮，即可删除Redis中缓存的所有参数。

4. 参数说明

表4-2 修改参数设置的参数说明

参数	说明
参数名称	参数的名称，取值包括： ·     科大讯飞语音APPID：使用科大讯飞提供的语音输入服务时，AI助手需要获取的服务标识 ·     科大讯飞语音APIKEY：使用科大讯飞提供的语音输入服务时，AI助手需要获取的验证凭证之一 ·     科大讯飞语音APISECRET：使用科大讯飞提供的语音输入服务时，AI助手需要获取的验证凭证之一 ·     使能请求appKey：通过百业灵犀大模型使能平台提供的应用获取百业灵犀大模型推理服务时，需要AI助手获取的验证凭证之一 ·     使能请求appSecret：通过百业灵犀大模型使能平台提供的应用获取百业灵犀大模型推理服务时，需要AI助手获取的验证凭证之一 ·     使能请求grantType：从百业灵犀大模型使能平台获取的授权类型，此参数的键值固定取值为1 ·     使能请求uri：百业灵犀大模型使能平台提供的API接口的URL，此参数的键值格式支持如下两种形式 ¡     http://<使能平台北向IP地址>:<使能平台API服务的端口号>/api ¡     https://<使能平台北向IP地址>:<使能平台Web服务的端口号>/api ·     阿里云密钥AccessKey：使用阿里云的短信验证码登录功能时，AI助手需要获取的验证凭证之一 ·     阿里云密钥accessKeySecret：使用阿里云的短信验证码登录功能时，AI助手需要获取的验证凭证之一 ·     阿里云signName：使用阿里云发送短信进行登录时，短信签名的内容。短信签名表明短信的发送者，用于验证短信内容的合法性 ·     阿里云模板code：使用阿里云发送短信进行登录时，指定短信的内容模板 ·     百度翻译个人或公司账号开关：在灵犀智画应用中，使用百度翻译服务转译作图需求时，AI助手使用的翻译账号类型。键值为0表示公司账号，键值为1表示个人账号 ·     百度翻译公司账号APPKEY：在灵犀智画应用中，使用百度翻译服务转译作图需求时，AI助手在使用公司账号时需要获取的验证凭证之一 ·     百度翻译公司账号SECREKEY：在灵犀智画应用中，使用百度翻译服务转译作图需求时，AI助手在使用公司账号时需要获取的验证凭证之一 ·     百度翻译个人账号APPID：在灵犀智画应用中，使用百度翻译服务转译作图需求时，AI助手在使用个人账号时需要获取的服务标识 ·     百度翻译个人账号SECREKEY：在灵犀智画应用中，使用百度翻译服务转译作图需求时，AI助手在使用个人账号时需要获取的验证凭证 ·     数美APPID：使用数美科技的内容合规校验功能时，AI助手需要获取的服务标识 ·     数美EVENTID：使用数美科技的内容合规校验功能时，AI助手需要选择的事件标识 ·     数美SECREKEY：使用数美科技的内容合规校验功能时，AI助手需要获取的验证凭证 ·     数美URL：数美科技提供的服务API接口地址
参数键名	参数的键名，不允许修改
参数键名	参数的键值
登录验证	参数的登录验证类型，即用户登录之前是否可以访问参数。 ·     登录用户访问：只有登录用户可以访问的参数。 ·     非登录用户访问：允许未登录用户访问的参数。
备注	参数的备注信息

 

4.3  系统管理

4.3.1  用户管理

1. 功能简介

用户管理主要是针对系统用户进行管理。在用户管理页面，可以对用户进行新增、修改、删除等操作。

图4-17 用户管理页面

 

2. 主要功能－查询用户

·     普通搜索

在用户管理页面搜索栏中输入用户登录名称、手机号码，选择账号状态、创建时间，单击<搜索>按钮，可以查询到对应的用户信息。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

·     按部门搜索

单击用户管理页面的左侧部门名称，页面可显示该部门下所有用户信息。

·     隐蔽/显示搜索

单击用户管理页面的隐蔽/显示搜索按钮，可隐藏或显示搜索栏。

3. 主要功能－新增用户

新增用户的配置方法为：

(1)     ‍单击<新增>按钮，进入新增用户页面。

(2)     配置用户的用户名称、归属部门、登录名称等信息。

(3)     单击<确定>按钮，完成新增用户操作。

图4-18 新增用户

 

4. 主要功能－停用用户

可以通过如下方式停用用户：

·     单击用户对应帐号状态列的<停用>按钮，即可停用该用户。

·     勾选一个或多个用户后，单击用户列表上方的<停用>按钮，即可同时停用多个用户。

5. 主要功能－启用用户

用户被停用后，可以通过如下方式重新启用被停用的用户：

·     单击用户对应帐号状态列的<启用>按钮，即可启用该用户。

·     勾选一个或多个用户后，单击用户列表上方的<启用>按钮，即可同时启用多个用户。

6. 主要功能－修改用户

修改用户的配置方法为：

(1)     ‍在用户管理页面，单击用户对应操作列的<修改>按钮，进入修改用户页面。

(2)     修改用户名称、归属部门等信息，登录名称不可修改。

(3)     单击<确定>按钮，完成修改用户操作。

7. 主要功能－重置用户密码

如果用户忘记密码，可以通过本功能重置用户密码。

重置用户密码的配置方法为：

(1)     ‍在用户管理页面，单击用户对应操作列的<重置>按钮，弹出提示对话框。

(2)     输入用户的新密码。

(3)     单击<确定>按钮，完成重置用户密码操作。

8. 主要功能－删除用户

删除用户的配置方法为：

(1)     ‍单击用户对应操作列的<删除>按钮，或勾选指定用户后单击用户列表上方的<删除>按钮。

(2)     在弹出的对话框中输入字符串“DELETE”（不区分大小写）后，单击<确定>按钮，完成删除用户操作。

9. 主要功能－导入用户

导入用户的配置方法为：

(1)     ‍单击用户列表上方的<导入>按钮，进入用户导入页面。

(2)     单击<下载模板>按钮，将用户信息模板下载到本地。

(3)     按照模板要求，在Excel表格中输入用户信息。

(4)     将包含用户信息的Excel文件拖拽到用户导入页面，或单击<点击上传>按钮，上传用户信息文件。

(5)     单击<确定>按钮，完成导入用户操作。

10. 主要功能－显隐列

显隐列的配置方法为：

(1)     ‍单击用户管理页面显隐列按钮    ，弹出“显示/隐藏”对话框。

(2)     根据需求在“显示”列或“隐藏”列选择一个、多个或全部列，通过和按钮来分配需要显示或隐藏的列。

11. 主要功能－刷新页面

单击用户管理页面刷新按钮，将重新加载用户列表。

4.3.2  角色管理

1. 功能简介

角色管理根据业务需求指定某一角色可以操作的菜单项，来实现为不同的角色赋予不同的权限。这些角色再被分配给相应的用户，就可以实现精细化的访问控制。这种基于角色的权限管理方法不仅简化了权限分配过程，还增强了系统的安全性和可管理性。

2. 注意事项

·     不能增加一个已经存在的角色。

·     不允许修改和删除系统预置的角色，如超级管理员。

·     如果系统上存在属于某个角色的用户，则不允许删除该角色。

3. 主要功能

·     查询角色

在页面上方的文本框中输入角色名称、权限字符，选择创建时间，单击<搜索>按钮，符合条件的角色会显示在下方。角色名称支持模糊查询。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

如需要显示或隐藏搜索栏，请根据实际需求单击用户管理页面显示/隐藏搜索按钮。

·     新增角色

a.     单击<新增>按钮，弹出添加角色对话框。

b.     配置角色名称、权限字符、设置角色顺序。

c.     设置“展开/折叠”、“全选/全不选”、“父子联动”菜单权限。

-     “展开/折叠”菜单权限：默认折叠菜单项（仅显示父项菜单），勾选“展开/折叠”选项后，会显示所有菜单项。

-     “全选/全不选”菜单权限：默认不选择任何菜单项，勾选“全选/全不选”选项后，选择全部菜单项。

-     “父子联动”菜单权限：默认父项菜单项和子项菜单项不联动，勾选“父子联动”选项后，选择父项菜单项后，归属于该父项菜单项的所有子项菜单项也被选中。

d.     单击<确定>按钮，完成添加角色操作。

图4-19 新增角色

 

·     修改角色

a.     ‍单击角色对应操作列的<修改>按钮，或勾选角色后单击角色列表上方的<修改>按钮，弹出修改角色对话框。

b.     根据实际情况修改角色名称、权限字符、角色顺序、菜单权限等信息。

c.     单击<确定>按钮，完成修改角色操作。

·     删除角色

删除角色后，已配置该角色的用户将不再具有该角色下的权限。请谨慎删除角色。

可以通过以下方式删除角色：

¡     选择一个角色后，单击<删除>按钮，删除该角色。也可以同时选中多个角色后，单击<删除>按钮，批量删除角色。

¡     点击角色对应操作列的“删除”图标，在弹出的确认对话框中单击<确定>按钮，完成删除角色操作。

·     刷新页面

单击角色管理页面刷新按钮，将重新加载角色列表。

4.3.3  定时任务

1. 功能简介

定时任务页面用于管理系统中所有定时任务，例如知识库同步任务等。

图4-20 定时任务页面

 

2. 主要功能

·     查询定时任务

在页面上方的文本框中输入任务名称，选择任务组名、任务状态，单击<搜索>按钮，符合条件的任务会显示在下方。任务名称支持模糊查询。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

如需要显示或隐藏搜索栏，请根据实际需求单击用户管理页面显示/隐藏搜索按钮。

·     执行一次定时任务

单击定时任务对应操作列的“执行一次”按钮，即可立即执行一次指定的定时任务。

·     修改定时任务的状态

可以通过如下方式修改定时任务的状态：

¡     点击定时任务对应任务状态列的滑动开关，来启动或暂停定时任务。

¡     单击定时任务对应操作列的“修改”按钮，在修改任务页面修改定时任务的状态。任务状态修改为“正常”，则AI助手会按照执行表达式的要求定时执行该任务；任务状态修改为“暂停”，则AI助手会暂停执行该定时任务。

·     修改任务

单击定时任务对应操作列的“修改”按钮后，不仅可以修改定时任务的状态，还可以根据实际情况修改执行表达式，调整定时任务执行的时间。

执行表达式为Cron表达式。定时任务中的Cron表达式由六个空格分隔的字段组成，每个字段代表一个时间单位。

¡     第1个字段：秒字段，取值范围为0～59。

¡     第2个字段：分钟字段，取值范围为0～59。

¡     第3个字段：小时字段，取值范围为0～23。

¡     第4个字段：日期字段，取值范围为1～31。

¡     第5个字段：月份字段，取值范围为1～12或JAN～DEC。

¡     第6个字段：星期字段，取值范围为0～6或SUN～SAT，其中0表示星期日。

如果某个字段的取值为一个数值，则表示任务仅在该时间单位达到指定值时执行。例如，第一个字段（秒字段）取值为0，则表示每分钟的第0秒执行该任务。

每个字段可以使用特定的字符来增加灵活性：

¡     “*”（星号）：表示任何值。例如，在分钟字段使用星号意味着每一分钟都会触发事件。

¡     “?”（问号）：表示不指定值。只用于日和星期字段，用于解决这两个字段之间的潜在冲突。

¡     “-”（短横线）：表示范围。例如“10-12”在小时字段表示从10点到12点。

¡     “,”（逗号）：表示额外的值。例如在星期字段使用“MON,WED,FRI”表示周一、周三和周五。

¡     “/”（斜杠）：表示增量。例如在分钟字段使用“0/15”意味着从0分钟开始，每15分钟执行一次。

根据以上对Cron表达式的介绍，可以看出“0 0/5 * * * ?”表示从0分钟的0秒钟开始，每隔5分钟执行一次定时任务。

图4-21 修改任务

 

·     刷新页面

单击定时任务页面刷新按钮，将重新加载任务列表。

4.3.4  部门管理

1. 功能简介

部门管理页面用于展示和管理部门信息，该页面支持进行新增、修改、删除部门的操作。

图4-22 部门管理页面

 

2. 注意事项

默认部门为系统预置的部门，不允许删除。

3. 主要功能

·     查询部门

在页面上方的文本框中输入部门名称，单击<搜索>按钮，符合条件的任务会显示在下方。部门名称支持模糊查询。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

如需要显示或隐藏搜索栏，请根据实际需求单击用户管理页面显示/隐藏搜索按钮。

·     新增部门

a.     单击页面左上角的<新增>按钮或部门对应操作列的“新增”按钮，弹出添加部门对话框。

b.     配置上级部门名称、部门名称、显示排序、输入负责人、联系电话、邮箱等信息。

c.     单击<确定>按钮，完成添加部门操作。

图4-23 新增部门

 

·     修改部门信息

a.     ‍选择待修改的部门，单击页面上的<修改>按钮，弹出修改部门对话框。

b.     根据实际情况修改上级部门名称、部门名称、显示排序、负责人、联系电话、邮箱等信息。

c.     单击<确定>按钮，完成修改任务操作。

·     删除部门

请谨慎删除部门。单击部门对应操作列的<删除>按钮，在弹出的确认对话框中单击<确定>按钮，完成删除部门操作。

·     刷新页面

单击定时任务页面刷新按钮，将重新加载部门列表。

4. 参数说明

表4-3 新增部门参数说明

参数	说明
上级部门	新增部门所属的上级部门的名称
部门名称	新增部门的名称
显示排序	新增部门在部门显示列表中的排序编号，取值越大，排序越靠后
负责人	新增部门负责人的姓名
联系电话	新增部门的联系电话
邮箱	新增部门的邮箱地址

 

4.3.5  license信息

1. 功能简介

本页面用于：

·     配置与License Server建立连接的相关参数，以通过License Server获取远程授权。

·     查看已获取的License授权信息。

图4-24 License信息

 

2. 主要功能

·     连接License Server

输入License Server的IP地址、端口号，以及客户端名称和密码，然后单击<连接>按钮连接License Server。

·     断开连接

单击<断开连接>按钮，与License Server断开连接，断开后已申请的License Server授权全部释放。

·     查询License信息

a.     ‍在“License信息”区域的搜索栏中，输入查询条件。

b.     单击<搜索>按钮，查询出符合条件的License信息。

c.     单击<重置>按钮，重置搜索条件。

d.     （可选）单击<更新>按钮，同步License Server授权信息，并刷新列表。

3. 参数说明

表4-4 License Server参数说明

参数	说明
IP地址	License Server的IP地址
端口号	License Server的授权服务端口号
客户端名称	License Server配置的客户端名称
客户端密码	License Server配置的客户端对应的密码
连接状态	与License Server连接的状态，包括以下状态： ·     未连接 ·     已连接 ·     正在重连 ·     连接异常

 

4.3.6  操作日志

1. 功能简介

操作日志记录了操作员在AI助手上执行操作产生的日志信息。

操作日志页面提供了对操作日志的查询、删除、清空以及查看详细信息功能。

图4-25 操作日志

 

 

2. 主要功能

·     查询操作日志

在页面上方的搜索栏中，输入搜索条件，然后单击<搜索>按钮，页面将仅显示符合搜索条件的操作日志。如需清除所有查询条件，显示所有操作日志，请单击<重置>按钮。

·     查看操作日志详细信息

单击操作日志列表“操作”列的<详细>按钮，在弹出的对话框中可以查看指定操作日志的详细信息。

·     删除操作日志

在操作日志列表第一列中勾选若干个操作日志，然后单击<删除>按钮，可以删除勾选的操作日志。

·     清空操作日志

单击<清空>按钮，删除所有当前操作日志。

4.3.7  登录日志

1. 功能简介

登录日志记录了用户在登录或登出AI助手时产生的日志信息。

登录日志页面提供了对登录日志的查询、删除和清空功能。

图4-26 登录日志

2. 主要功能

·     查询登录日志

在页面上方的搜索栏中，输入搜索条件，然后单击<搜索>按钮，页面将仅显示符合搜索条件的登录日志。如需清除所有查询条件，显示所有登录日志，请单击<重置>按钮。

·     删除登录日志

在登录日志列表第一列中勾选若干个登录日志，然后单击<删除>按钮，可以删除勾选的登录日志。

·     清空登录日志

单击<清空>按钮，删除所有当前登录日志。

4.3.8  应用配置

1. 功能简介

AI助手通过应用的方式，向第三方系统提供调用AI助手资源的接口。应用包含了鉴权机制，当第三方系统使用特定的key来调用AI助手的资源时，只能获得key对应的应用允许的资源——使用大模型推理服务的指定助手。

图4-27 应用配置

 

2. 注意事项

·     应用的“调用key”和“调用秘钥”由系统自动生成，用户不能配置。“用户标识”用于结合“调用key”和“调用秘钥”，通过加密算法生成提供给第三方系统的key，新增应用以后就无法修改。

·     只有状态为“失效”的应用可以被删除。

3. 主要功能

·     查询应用

在页面上方搜索栏中输入或选择搜索条件，然后单击<搜索>按钮，页面会仅显示满足搜索条件的应用。如需清除所有查询条件，显示所有应用，请单击<重置>按钮。

·     新增应用

新增应用的流程如下：

a.     ‍单击<新增>按钮。

b.     在弹出的对话框中输入应用名称和用户标识。其中用户标识推荐配置为第三方系统的名称。

c.     （可选）通过勾选复选框，配置允许应用授予的助手资源。

d.     在“状态”选择栏中，选择应用的有效期。选择“有效”时，应用缺省拥有一个月有效期，如果需要调整应用的有效期，可以在“过期日期”选项框中进行修改。

e.     （可选）根据需求输入应用的描述，此描述仅具有本地意义，增加应用的标识度。

图4-28 新增应用

 

·     修改应用

单击应用列表“操作”列的<修改>按钮，在弹出的对话框中可以修改应用的配置。

·     查看应用绑定的助手

单击应用列表“操作”列的<助手>按钮，在弹出的对话框中可以看到应用绑定的助手，即通过应用可以获取的助手资源。

在“应用绑定助手”对话框中，单击<复制>按钮可以获得一个URL，用户可以直接通过该URL访问助手会话页面。

·     删除应用

单击应用列表“操作”列的<删除>按钮可以删除指定的应用。

4.3.9  数据备份

1. 功能简介

数据备份是提高AI助手数据可靠性的关键措施。通过定期备份数据库信息，您可以在发生系统故障、数据损坏或其他不可预见的事件时，快速将AI助手恢复到正常运行状态。

在数据备份页面，用户不仅可以执行数据备份和数据恢复操作，还可以通过数据备份和数据恢复列表来查看操作记录。

图4-29 数据备份

 

2. 注意事项

数据恢复过程中，如果用户对系统执行了操作，则该操作无法被记录。因此，为了避免数据丢失，在数据恢复过程中，请不要执行任何操作。

3. 主要功能

·     备份数据库

单击<立即备份>按钮，可以将当前数据库中的数据备份到服务器。

·     下载备份数据

在数据备份和数据恢复列表中，点击数据备份对应操作列的“下载”按钮，可以将指定的备份数据从服务器下载到本地。

·     备份恢复

·     单击<备份恢复>按钮，上传之前下载到本地的备份数据，可以将AI助手恢复到备份时的状态。

·     删除数据备份和数据恢复

在数据备份和数据恢复列表中，点击数据备份对应操作列的“删除”按钮，可以删除指定数据备份的操作记录，并删除该操作保存在服务器上的备份数据。

在数据备份和数据恢复列表中，点击数据恢复对应操作列的“删除”按钮，可以删除指定的数据恢复操作记录。

4.3.10  问题反馈

1. 功能简介

问题反馈页面主要用于对用户使用过程中所反馈的问题进行管理，该页面可以显示用户反馈问题列表，支持查看、删除、批量导出问题等功能。

图4-30 问题反馈

 

2. 主要功能

·     查询问题

在页面上方的文本框中输入问题标题，选择问题类型，单击<搜索>按钮，符合条件的问题会显示在下方。问题名称支持模糊查询。

如需清除所有查询条件，请单击<重置>按钮将查询条件置空。

·     批量导出问题

单击<批量导出>按钮，可以导出用户反馈问题列表。

·     删除问题

单击问题对应操作列的<删除>按钮，在弹出的确认对话框中单击<确定>按钮，完成删除问题操作。

·     查看截图

单击问题对应操作列的<查看截图>按钮，可查看用户上传的图片。未单击该按钮时，问题状态显示未“未读”；单击该按钮后，问题状态显示为“已读”。

5 AI助手代码插件使用指导

5.1  安装AI助手代码插件

目前，AI助手代码插件仅支持在VScode和IntelliJ IDEA中安装，详细安装过程请参见《H3C百业灵犀AI助手安装 部署指导》。

AI助手代码插件对VScode和IntelliJ IDEA的软件版本有要求，仅支持VScode 1.70.2及以上版本、IntelliJ IDEA 2021及以上版本安装。

插件安装完成后，可以通过点击插件图标打开AI助手代码插件窗格，用户与AI助手代码插件交互的过程均显示在插件窗格中。

图5-1 AI助手代码插件窗格-VScode

 

图5-2 AI助手代码插件窗格-IntelliJ IDEA

 

5.2  自动续写代码

5.2.1  功能简介

代码插件能够使用大模型能力帮助用户自动续写已有代码。

5.2.2  主要功能

在VScode或IntelliJ IDEA的编辑器窗格中，将光标移动至任意一行已有代码的末尾：

·     键盘输入<Enter>，代码插件将插入单行自动生成的续写代码。

·     键盘输入<Ctrl+Enter>，代码插件将插入一整段自动生成的续写代码。

代码插件插入代码后，需要按下键盘<Tab>按键才能接受并保留自动生成的代码到编辑器窗格中。

图5-3 AI助手代码插件自动续写代码

 

5.3  添加注释

5.3.1  功能简介

代码插件可以帮助用户理解代码含义并为代码生成相应的注释。

5.3.2  主要功能

在VScode或IntelliJ IDEA的编辑器窗格中，选中一段代码，然后单击鼠标右键，在菜单栏中选择“H3C AI助手-添加注释”，AI助手代码插件窗格中即会显示添加注释后的代码。可以复制添加了注释的这段代码，也可以将其直接插入到编辑器窗格中。

图5-4 AI助手代码插件添加注释

 

5.4  解释代码

5.4.1  功能简介

代码插件可以帮助用户详细解析代码的内容和功能，然后通过文字形式在插件窗格中告知用户。

5.4.2  主要功能

在VScode或IntelliJ IDEA的编辑器窗格中，选中一段代码，然后单击鼠标右键，在菜单栏中选择“H3C AI助手-解释代码”，AI助手代码插件窗格中会显示代码的解析内容。解析内容可以通过文字右上角的图标进行复制。

图5-5 AI助手代码插件解释代码

 

5.5  自定义提问

5.5.1  功能简介

在插件窗格中，用户也可以通过Prompt与AI助手进行智能问答。问答形式包含如下两类：

·     无上下文直接问答。

·     基于选定的代码内容进行问答。此种方式可用于代码排障、解析、优化等各类场景，较“添加注释”和“解释代码”功能使用更加灵活。

5.5.2  主要功能

·     无上下文直接问答

在VScode或IntelliJ IDEA的插件窗格的问答框中直接输入Prompt，然后单击<发送>按钮，即可与AI助手进行对话交互。

·     基于选定的代码内容进行问答

a.     在VScode或IntelliJ IDEA的编辑器窗格中，选中一段代码，然后单击鼠标右键，在菜单栏中选择“H3C AI助手-自定义提问”

b.     在插件窗格的问答框中基于代码内容输入Prompt，然后单击<发送>按钮，基于选定的代码内容与AI助手进行对话交互。

5.6  AI助手代码插件设置

·     在IntelliJ IDEA的编辑器窗格中，单击鼠标右键，在菜单栏中选择“H3C AI助手-设置”，可以修改插件使用的大模型。

图5-6 AI助手代码插件设置

 

·     在VScode或IntelliJ IDEA的插件窗格中，单击顶部的按钮，可以新增一个会话。在会话下拉框中单击删除按钮可以删除指定的会话。

·     在VScode或IntelliJ IDEA的插件窗格中，单击顶部的按钮，可以设置用户在与AI助手进行问答时的会话模式：

¡     单轮会话：AI助手不结合上下文，直接根据用户的问题进行回答。

¡     多轮会话：AI助手会将最近的数个问答对作为上下文来对问题进行回答。

·     在VScode或IntelliJ IDEA的插件窗格中，单击顶部的按钮，可以查看以.json文件形式记录的全部对话记录。

·     在VScode的插件窗格中，单击顶部的按钮，可以刷新对话UI界面。