用户与管理员手册

本手册介绍 Parsewise 管理面板和可嵌入聊天小部件的使用方法。权利人为个体经营者 Ruslan Khuvazhievich Krylov。界面提供俄语和英语；文中的版块、字段和按钮名称为中文译名。

存放知识库、助手设置、聊天和团队的工作空间，在本手册中称为项目。

用户手册为第 1–3、5 和 9 节；管理员手册为全部章节。

1. 面板结构

左侧为项目菜单。菜单内容取决于成员的角色。

菜单上方为项目切换器，底部为账户菜单。

2. 角色

访客是通过邮件或访客链接邀请的外部用户。访客只能看到自己创建的聊天。

3. 登录与账户

登录

“登录”页面包含“邮箱”和“密码”字段、“记住我”复选框以及“忘记密码？”链接。表单下方“或通过以下方式继续”区域中有 Yandex ID、VK ID 和“企业登录（SSO）”按钮。只有为用户所在组织配置了 SSO 时，企业登录才可用；否则软件会提示该域名未配置 SSO 登录。

注册

1. 在登录页面点击“注册”链接，打开“注册”页面。
2. 填写“邮箱”“名”“姓”“密码”和“确认密码”字段。密码至少 8 个字符，须包含大写和小写拉丁字母以及数字。
3. 如有需要，勾选“接收产品更新邮件”。
4. 勾选同意“我接受使用条款和隐私政策”。使用条款发布于 https://parsewise.ru/policy/offer，隐私政策发布于 https://parsewise.ru/policy/privacy。
5. 点击“注册”。
6. 输入邮件中的六位验证码并点击“确认”。若未收到邮件，点击“重新发送验证码”。

找回密码

1. 在登录页面点击“忘记密码？”。
2. 输入电子邮件地址并点击“发送链接”。
3. 打开邮件中的链接并设置新密码。

账户菜单

菜单包含“我的账户”“切换账户”“添加账户”“隐私政策”“提交反馈”和“退出”。同一浏览器中可以保存多个账户，切换时无需重新输入密码；多余的账户可在“管理账户”窗口中删除。

账户设置

4. 项目

创建项目

1. 在项目切换器中选择“新建项目…”。
2. 填写“项目名称”和“项目描述”。描述有助于助手更好地理解对话背景。
3. 点击“创建项目”。

主页

“主页”版块显示项目概览。页头有“设置”“邀请链接”和“邀请成员”按钮；后两个仅对所有者和管理员可用。

“分析”区块显示所选时间段的指标：“已创建聊天”“平均每个聊天的消息数”“平均会话时长”“平均评分”“推荐的商品”“推荐的人员档案”“文档展示次数”“推荐的技能”“连接器运行次数”。下方为“最近聊天”“最近线程”“最近商品”“最新人员档案”和“最新文件”列表。

通用设置

“设置 → 通用”版块对所有者和管理员可用。

版块页头的“删除项目”按钮会删除项目及其全部数据，仅项目所有者可用。确认时需输入项目名称。

自有域名

“设置 → 通用”版块中的“自有域名”区块对所有者和管理员可用，可让项目页面在组织自有域名上打开。

1. 点击“添加域名”，填写域名，必要时填写备注，然后点击“保存”。
2. 在域名所在行点击“检查”。会打开“接入域名”窗口，显示 DNS 记录；点击记录所在行即可复制其值。
3. 在域名注册商处添加记录：TXT——用于确认所有权；A——用于根域名，或 CNAME——用于子域名。
4. 在窗口中点击“检查”。若找到记录，软件会提示域名已确认、正在配置接入，随后接入和 SSL 证书会自动配置。若未找到记录，软件会提示 DNS 记录不存在或指向错误。

修改已保存域名的名称后，所有权确认和接入状态会被重置，需要重新检查。域名所在行的“删除”按钮在“删除域名”窗口确认后，将域名与项目解绑。已绑定到其他项目的域名无法添加。

5. 聊天

“助手 → 聊天”版块用于与助手对话和分析咨询。页头有“线程”“主题”和“问题”按钮，可将页面滚动到相应区块，另有“新聊天”按钮。访客只能看到“新聊天”按钮和自己的聊天。

聊天是与助手的全部往来消息；软件将聊天划分为线程——即围绕用户某一个问题的对话片段，在“问题”区块中称为分支。

对话

1. 点击“新聊天”或从列表中打开聊天。
2. 在“输入消息...”字段中输入消息并点击“发送”。消息可附带文件：最多 10 个，每次最多 5 个，每个不超过 10 MB。
3. 助手以文本、商品和人员档案卡片、技能卡片作答；若项目设置中开启了“高亮文件”，还会附上知识库文件并高亮其所依据的片段。点击文件会打开“文件详情”窗口，其中有“下载”“打开”和“依据文档回答”按钮。最后一个按钮会在输入框中添加对该文档的引用：直接发送消息，助手将只依据该文档回答上一个问题；也可以在旁边补充新问题。打开文件所用的链接有效期不超过一小时。
4. 用“差”“一般”或“好”按钮评价回答。
5. 要评价整个聊天，点击“评价”并给出一至五星及评论。

团队成员可以接管对话：“停止助手”按钮会关闭该聊天中助手的回答，之后由团队人工继续对话。“启用助手”按钮恢复自动回答。若通用设置中开启了“用户请求人工时自动暂停”，当用户要求人工坐席时助手会自动停止。

分析

各区块在页面上自上而下排列。

问题列表每天重新生成一次。收集周期在“通用”版块的“问题”区块中设置。

6. 知识库

文件

1. 点击“上传文件”或将文件拖入版块窗口。
2. 若已有同名文件，软件会显示“发现重复文件”窗口：“上传”保存副本，“替换”替换现有文件。

面板接受不超过 50 MB 的文件：PDF、DOC、DOCX、XLS、XLSX、PPT、PPTX、TXT、CSV、JSON、XML、MD、RTF、ODT、ODS、ODP、HTML 文档，以及图片、视频、音频和压缩包。用于助手回答的文本从《功能特性》第 3.3 节列出的格式中提取；其他文件仅存储、不建立索引。

“按链接上传”按钮打开“按链接导入文档”窗口。来源可以是“云端文件夹（S3）”“网站上的文件夹”“链接列表”或“网站”。软件会下载内容，并每天以及点击“更新”按钮时进行更新；可用“停止”按钮中断下载。来源状态显示为“已完成”“已停止”“错误”或“尚未同步”。删除来源时，软件会询问保留还是删除已下载的文件。

商品

手动创建。 “创建商品”按钮打开表单：

从文件导入。 “从文件导入”按钮接受 CSV、XLSX、XLS、JSON、XML、YML 和 YAML 文件。若项目中已有商品，软件会提示重新上传或替换现有商品。

按链接订阅源。 “按链接上传”按钮打开“商品订阅源”窗口。可添加一个或多个 YML、XML、CSV、XLSX 或 JSON 格式的订阅源链接。订阅源每天以及点击按钮时同步；商品按货号匹配。

商品卡片。 “商品分析”区块显示所选时间段内的“推荐次数”“卡片打开次数”“CTA 点击次数”和“转化率”。“删除商品”按钮删除商品。

人员档案

“人员档案”版块是助手推荐的人员目录：专家、员工、顾问。

• “创建人员档案”——手动创建档案。
• “从文件导入”——上传 CSV、XLSX、XLS、JSON、XML、YML 和 YAML 文件；列与档案字段的对应关系自动识别。
• “按链接上传”——打开“人员档案订阅源”窗口；订阅源每天以及点击按钮时同步，档案按外部编码匹配——工号、员工标识或 CRM 中的编码。

7. 助手

人设

“人设”版块对所有者、管理员和编辑可用。“助手设置”区块包含“助手名称”字段——即小部件聊天中显示的名称——以及“回答规则（可选）”字段，可用自由文本设定回答的语气、风格和边界。“助手头像”可以上传，也可以从“照片”和“插画”分组的标准头像中选择。

技能

“技能”版块对所有者、管理员和编辑可用；删除技能、发布、提交审核和取消发布仅限所有者和管理员。技能是助手的一项能力，在回答流中拥有自己的界面：交互式卡片、表单、计算器、日程表。

1. 通过“应用市场”按钮从目录安装技能，或通过“上传 .skill”按钮上传文件。
2. 上传第三方文件时，在“信任此技能？”窗口中点击“信任并安装”确认。
3. 若已有同名技能，选择“更新”或“创建副本”。

“技能创建器”按钮打开开发自有技能的资料。可通过“选择模式”批量停用或删除技能。

技能卡片包含“通用”“卡片”“抽屉”“资源”“提交记录”“连接器”和“日志”区块。“提交记录”区块汇集技能表单的数据，可通过“下载 CSV”按钮导出；调用日志通过“下载 .log”按钮导出。技能操作：

连接器

“连接器”版块对所有者、管理员和编辑可用；删除连接器仅限所有者和管理员。连接器是不含界面的软件包，让助手能够使用外部系统的工具。

1. 通过“应用市场”按钮安装连接器，或通过“上传 .skill”按钮上传文件。
2. 上传第三方文件时，点击“信任并安装”确认。
3. 在卡片中打开“连接器”区块，点击“配置”设置授权密钥。
4. 用“测试”按钮检查服务器的工具。

小部件

“小部件”版块对所有者、管理员和编辑可用。“分析”区块显示“小部件展示次数”“小部件打开次数”“已创建聊天”和“转化率”。

开启“自动将员工加入团队”时，已登录的小部件用户会成为项目成员并占用套餐席位；关闭时按线程计费。

在网站上安装小部件。 版块页头的“安装”按钮会跳转到安装说明。“选择平台”列表提供 HTML/CSS、Tilda、1C-Bitrix、InSales、OpenCart、Shop-Script、CS-Cart、uniSiter、Smink、WordPress、Next.js、React 和 Angular；每个平台都有分步操作说明。对于 HTML 网站：

1. 点击代码框，复制安装代码。
2. 打开网站的 HTML 文件，例如 index.html 或主模板。
3. 将代码粘贴到闭合标签 </head> 之前。
4. 保存文件并打开网站：页面底部会出现小部件按钮。

8. 团队、API 令牌、计费

团队

“团队”版块对所有者和管理员可用。

1. 点击“邀请成员”，填写“邮箱地址”和“角色”——管理员、编辑、观察者或访客——然后点击“发送邀请”。
2. 如需邀请多人，点击“邀请链接”，通过“管理员链接”“编辑链接”“观察者链接”或“访客链接”按钮创建链接。有效链接可以复制或删除。

在成员窗口中，可在“更改角色”字段中修改角色并保存，用“移除成员”按钮移除成员，对于未确认的邀请可点击“撤销邀请”。所有者可以点击“设为所有者”，并通过输入单词 transfer 确认“转交所有权”；转交后，原所有者成为管理员。

API 令牌

“API 令牌”版块对所有者和管理员可用。

1. 点击“创建令牌”。
2. 填写“令牌名称”和“角色”：“观察者”——可访问聊天和搜索 API；“编辑”——另可创建、修改和删除商品。“管理员”角色标记为不可用。
3. 请立即复制令牌：它只显示一次。

令牌列表显示创建日期和“最后使用时间”。不需要的令牌可通过“选择模式”删除。

计费

“计费”版块对所有者和管理员可用，标题为“计费与使用情况”。

团队按席位计费：任何项目成员（包括访客）都占用一个席位。线程按已解决的问题计费：线程是包含助手回答的已完结对话分支。产品卡片显示使用量、费用、当前套餐、单价、已付费额度和超出套餐的用量。

付款步骤：

1. 点击“支付团队”或“支付线程”。
2. 填写每月席位数或线程数——不少于最低数量——并核对“应付金额”。
3. 阅读公开要约条款 https://parsewise.ru/policy/offer，然后点击“前往付款”。

超出已付费额度的用量在周期结束时按实际用量结算。添加到“团队”套餐年度席位池中的席位，按每月席位价格乘以年度期限剩余月数计费。“团队”订阅可通过“取消订阅”按钮取消。

对于已付费的产品，可通过“修改”链接设置支出保护：“席位上限”——超过后无法再邀请成员；“每月线程上限”——达到后，助手在本月剩余时间内不再开启新线程。若未设置上限，则适用默认值：200 个席位和每月 10,000 个线程。席位上限不得低于最低套餐，线程上限不得低于已付费额度；清空字段即取消上限。

9. 网站上的小部件

网站访客点击小部件按钮打开聊天，在“输入消息...”字段中撰写消息。助手以文本、商品和人员档案卡片、交互式技能卡片以及知识库文档链接作答。每个回答都可以评价。

搜索与操作窗口中提供最近的聊天、聊天搜索，以及“新聊天”“下载历史记录”和“帮助”操作。输入框下方显示隐私政策链接 https://parsewise.ru/policy/privacy。

若在“小部件”版块中选择了“仅已登录用户”模式，未在网站登录的访客会看到提示：聊天仅对已登录用户开放。