致慧泉用户手册

一、简介

1. 致慧泉是什么?

致慧泉是一款将前沿的人工智能技术无缝融入日常工作流程的企业 AI 门户。它使您能够通过创建 AI 助手(智能聊天机器人)、使用自然语言对话,集成外部系统 API 等方式,驾驭 AI 的力量,简化协作流程,提高生产力和效率。

2. 主要功能和优势

3. 目标受众

致慧泉为广泛的用户群体打造,包括不仅限于:

二、快速入门

1. 账号注册和登录

致远员工可直接使用企业账号登录致慧泉。外部用户需要致慧泉管理员提供的邀请码进行注册。

注册界面

访问 https://seeyon.chat 进入注册界面。私有部署用户请访问您的服务器地址。

注册界面截图
注册界面

请使用您的电子邮件地址注册。注册完成后您将收到一封包含验证码的邮件,请使用验证码激活您的账号。

登录界面

再次访问 https://seeyon.chat 进入登录界面。私有部署用户请访问您的服务器地址。

登录界面截图
登录界面

忘记密码

如果您忘记了密码,请访问登录页面并单击“忘记密码”。您将收到一封包含重置密码链接的电子邮件。

2. 用户界面

登录后,您将看到致慧泉仪表板。该界面易于使用且导航直观。

导航栏截图,包含首页、市场和工作坊选项卡
导航栏

3. 导航仪表板

您可以通过单击导航栏中的相应选项卡轻松地在选项卡之间切换。

三、AI 助手

1. 了解 AI 助手

AI 助手是人工智能驱动的对话代理,可以用自然语言格式与用户互动。它们可以被编程为提供信息、回答问题、自动化任务和参与对话。致慧泉利用 LLM 的力量来创建智能且通用的 AI 助手。

2. 创建 AI 助手

a. 定义 AI 助手详细信息

要创建新的 AI 助手,请导航到“构建”选项卡并单击“创建 AI 助手”按钮。您将看到一个表单来定义 AI 助手的详细信息:

聊天机器人创建表单截图
聊天机器人创建表单

b. 使用 AI 助手描述生成器

如果您需要帮助制作引人注目的 AI 助手描述,致慧泉提供了一个 AI 驱动的描述生成器。

AI 助手描述生成器截图
AI 助手描述生成器

c. 添加文件

您可以通过添加相关文件来增强 AI 助手的知识和功能。

聊天机器人创建表单截图
聊天机器人创建表单

底层技术:混合索引
致慧泉采用双重索引方法来优化文件搜索:

  1. 基于向量的索引: 每个文本块都被转换为数值向量表示,捕捉其语义。这使得基于相似性的搜索成为可能,即使用户的查询与文件中的确切关键字不匹配,AI 助手也能找到相关信息。
  2. 基于关键字的倒排索引: 还会创建一个传统的倒排索引,将单个关键字映射到它们出现的块。这允许进行快速的基于关键字的搜索,补充语义搜索功能。

d. 集成 API

致慧泉允许您将外部 API 集成到您的 AI 助手。这扩展了它们的功能,并使它们能够访问实时信息并与外部系统交互。

聊天机器人 API 截图
聊天机器人 API

通过提供 OpenAPI 规范(YAML 格式)来集成外部 API。这允许您的 AI 助手访问实时信息并在外部系统中执行操作。要添加 OpenAPI 规范:

  1. 单击“添加 OpenAPI 规范”按钮。
  2. 将 OpenAPI 规范的 YAML 内容粘贴到提供的文本区域中。
  3. 单击“保存”以存储规范。您可以为不同的 API 添加多个规范。

有关如何集成 API 的更多详细信息,请参阅高级功能之“API 集成”部分。

f. 启用工具

致慧泉允许您为 AI 助手启用特定工具,将其功能扩展到简单对话之外。LLM 可以根据对话上下文访问和利用这些工具。

g. 设置表单

表单使您能够从用户收集结构化数据,并在开始新聊天时利用它来个性化 AI 助手的响应。

聊天机器人表单截图
聊天机器人表单
聊天机器人表单生成截图
表单生成

关于表单的更多详细信息,请参阅高级功能之“表单创建和使用”部分。

h. 管理成员 已弃用

对于协作项目,您可以将成员添加到您的 AI 助手并为其分配特定角色。

i. 发布和取消发布

对 AI 助手感到满意后,您可以发布它以供其他用户使用。使用工具栏菜单中的“发布”按钮将您的 AI 助手提交给管理员审核。批准后,它将列在“市场”选项卡中。

您提交的 AI 助手在发布之前将由管理员审核。

3. 克隆 AI 助手

您可以克隆现有的 AI 助手,以根据其设置和配置创建新的 AI 助手。

4. 与 AI 助手互动

a. 开始对话

要与 AI 助手互动,请单击“首页”或“市场”选项卡中的其名称或头像。这将打开一个新的聊天窗口。您也可以在不选择特定 AI 助手的情况下启动新对话,这允许您使用斜杠命令在聊天窗口中选择 AI 助手。

首页选项卡还在页面底部提供了一个聊天框,允许您使用默认 LLM 开始新对话。

首页选项卡聊天框截图
首页选项卡聊天框

b. 发送消息和文件

c. 使用斜杠命令

斜杠命令是允许您快速访问 AI 助手功能或执行操作的快捷方式。

斜杠命令截图
斜杠命令

d. 重新生成响应

如果您对 AI 助手的响应不满意,可以通过单击“重新生成”按钮重新生成它。这将提示 AI 助手根据相同的输入生成新的响应。

e. 特殊元素渲染器

致慧泉内置数款特殊元素渲染器,允许 AI 助手直接在聊天界面中生成和显示交互式元素。这些元素可以使用 React、Vue 或 v5PortalWidget 框架创建。

当 AI 助手生成包含这些特殊元素的响应时,您将看到一个名为“工具调用完成”的可折叠部分。展开此部分将显示组件/小部件的实时预览或原始 JSON 代码,具体取决于切换开关。

聊天机器人响应截图,包含 React 组件预览
聊天机器人 React 预览
聊天机器人响应截图,包含 React 组件代码
聊天机器人 React 组件代码

有关如何创建和使用这些特殊元素渲染器的更多详细信息,请参阅致慧泉开发人员文档。

5. 查看 AI 助手详细信息

您可以通过单击“构建”或“市场”选项卡中的其名称来查看 AI 助手的详细信息。详细信息页面显示有关 AI 助手的信息,包括其描述、模型、提示和成员。

6. 在市场中查找 AI 助手

a. 浏览和过滤

“市场”选项卡显示已发布的 AI 助手列表。您可以浏览列表或使用过滤器缩小搜索范围。

b. 关注 AI 助手

您可以关注您认为有用或有趣的 AI 助手。关注的 AI 助手将突出显示在您的“首页”选项卡上,以便于访问。

四、会话记录

1. 管理对话

a. 创建新对话

您可以从“首页”或“市场”选项卡开始与任何 AI 助手进行新对话。只需单击 AI 助手的名称或头像,就会打开一个新的聊天窗口。您也可以在不选择特定 AI 助手的情况下启动新对话,这允许您使用斜杠命令在聊天窗口中选择 AI 助手。

首页选项卡还在页面底部提供了一个聊天框,允许您使用默认 LLM 开始新对话。

b. 重命名对话标题

您可以重命名对话以使其更容易在您的对话历史记录中识别。

聊天窗口菜单截图,包含重命名标题选项
聊天重命名标题

对话标题是根据 AI 助手的描述和对话中的最后一条消息生成的。

c. 删除对话

如果您不再需要对话,可以将其从对话历史记录中删除。

2. 对话历史记录和导航

致慧泉提供了方便的方法来管理和浏览您的对话历史记录。

3. 导出对话内容

您可以导出各种类型的对话内容,以进行共享、存档或进一步分析。

4. 创建对话分支

“分支”功能允许您从现有对话创建新的对话,从对话历史记录中的特定点开始。这对于探索替代路径或专注于对话的特定方面很有用。

对于分支对话,您通过工具栏按钮返回主对话。

五、高级功能

1. API 集成

致慧泉允许您将外部 API 集成到您的 AI 助手,扩展其功能并使其能够访问实时信息并与外部系统交互。

a. 启用 API 访问

b. 添加 OpenAPI 规范

c. 在 AI 助手提示中引用 API

为了让您的 AI 助手了解可用的 API,您可以在其提示中引用它们。

{{#API}}
可用 API:
{{API}}
{{/API}}

这将在 AI 助手的提示中显示可用 API 列表,使其了解可以调用的潜在函数。

由于在提示中包含任何现有 API 信息是默认行为,因此如果不需要其他 API 信息,您可以省略 {{#API}}...{{/API}} 标签。

d. 触发 API 调用

API 调用是根据用户的输入和 AI 助手对可用 API 的理解触发的。AI 助手将使用 httpRequest 函数自动生成必要的代码来与 API 交互。

2. 提示模板自定义

致慧泉使用 Mustache(一种无逻辑模板引擎)来创建动态和个性化的 AI 助手提示。

a. 了解 Mustache 语法

b. 在提示中使用变量

致慧泉提供各种可以在提示中使用的变量:

变量 描述
chatContext 上下文详细信息,例如表单数据、文件和代码块。
formData 通过表单提交的数据。
form 序列化表单数据。
chatbot AI 助手属性,例如名称或状态。
user 用户信息,例如姓名或偏好。
memories 序列化内存数据。(已弃用)
empty 指示空对话的布尔标志。
today 中文格式的当前日期。
API 可用 API 的描述或列表。
currentUserRole 当前用户的角色。(已弃用)
followingToolResult 指示最后一条消息是否是工具结果的布尔标志。

c. 提示设计的最佳实践

有关如何设计提示模板的更多详细信息,请参阅提示模板自定义 文档。

3. 表单创建和使用

表单允许您从用户收集结构化数据,使您的 AI 助手交互更加高效和个性化。

a. 定义表单字段

b. 使用“自动生成”功能

如果您不熟悉 JSON 模式,可以使用“自动生成”功能。

c. 在 AI 助手响应中引用表单数据

使用 Mustache 语法在 AI 助手的提示中引用表单数据。例如,{{formData.name}} 将呈现用户提交的姓名。

六、后台管理

致慧泉提供了强大的管理工具来管理用户、组和访问系统范围的指标和分析。

注意:以下功能仅限管理员用户使用。

1. 用户管理

a. 查看用户统计信息

导航到“管理”选项卡并选择“用户”。

alt text

您可以查看所有注册用户的列表,以及他们的角色、活动状态和其他相关信息。

b. 搜索用户

使用搜索栏按姓名或电子邮件地址快速查找特定用户。

c. 编辑用户角色和活动状态

作为管理员,您可以修改用户角色并激活或停用帐户。

从用户姓名旁边的下拉菜单中选择所需的角色。

切换“是否活跃”开关以激活或停用帐户。

2. 群组管理

a. 创建和编辑群组

导航到“管理”选项卡并选择“群组”。

alt text

单击“创建群组”按钮以创建新的群组。

要编辑现有群组,请单击群组列表中的其名称。

您可以修改群组的名称、联系信息并指定管理员用户。

b. 管理群组邀请码

每个群组都有一个唯一的邀请码,可用于邀请新成员。

要重置邀请码,请单击“重置邀请码”按钮。

群组管理页面截图
群组管理页面

c. 向群组添加积分

群组有积分余额,用于确定其使用限制。

管理员可以通过单击“添加积分”按钮并指定金额来向群组添加积分。

3. 系统指标和分析

致慧泉提供全面的分析,以跟踪系统使用情况、AI 助手受欢迎程度和用户参与度。

a. 查看用户注册趋势

“按日期注册”图表显示每天注册的用户数量,按活跃用户和非活跃用户细分。

alt text

b. 分析用户消息频率

“用户消息按日期”图表显示用户随时间发送的消息总数。

alt text

c. 识别用量最多的用户

图表根据用户发送的消息数量对用户进行排名。

alt text

d. 跟踪 AI 助手的使用和受欢迎程度

“最受关注的 AI 助手”和“最受欢迎的 AI 助手”图表分别展示了用户最常关注和使用的 AI 助手。

alt text

七、设置和偏好

1. 语言选择

2. API 密钥管理

3. 反馈和支持

八、附录

1. 内置模型

致慧泉提供广泛的内置模型和代理,使您能够构建多样化且强大的聊天机器人。

a. 大型语言模型 (LLM)

系统内置的模型如下:

b. 多模态模型

这些模型超越了文本,允许聊天机器人处理和生成文本和图像。

c. 文本到图像

这些文生图模型专门用于从自然语言文本文本描述生成图像。

注意: 特定模型和代理的可用性可能会因您的用户角色和致慧泉的部署配置而异。

2. 术语表

术语 定义
AI(人工智能) 计算机或由计算机控制的机器人执行通常由人类完成的任务的能力,因为这些任务需要人类的智能和洞察力。
API(应用程序编程接口) 一组定义和协议,允许一个应用程序访问另一个应用程序的功能或数据。
AI 助手 人工智能驱动的对话代理,可以用自然语言格式与用户互动。
协作 与他人合作制作或创造某物的行为。
Fork 分支 从现有对话创建新的对话,从对话历史记录中的特定点开始。
JSON 模式 允许您注释和验证 JSON 文档的词汇表。
LLM(大型语言模型) 一种深度学习算法,可以根据从海量数据集中获得的知识识别、总结、翻译、预测和生成文本和其他内容。
Mustache 用于生成动态内容的无逻辑模板语法。
OpenAPI 规范 定义和记录 RESTful API 的标准。
提示词 提供给 LLM 以指导其行为并生成响应的输入。
角色 在 AI 助手或群组中分配给用户的权限和访问级别集。
斜杠命令 在聊天输入框中使用的快捷方式,用于触发特定操作或功能。
通过网络以连续流的形式传输或接收数据。
令牌 用于衡量 LLM 中提示和响应长度的文本单位。

3. 常见问题解答

4. 联系信息