功能特性说明

1. 基本信息

Parsewise 是用于构建语言模型助手的软件。每项业务任务在管理面板中对应一个独立项目，拥有各自的内容、访问权限和人设描述；人设决定助手的角色、语气和回答边界。同一套部署既可服务网站或个人账户中的客户，也可服务内网或客服中的员工。

软件通过兼容 OpenAI 的编程接口调用语言模型。权利人的云端实例使用 Yandex AI Studio 服务的模型；在客户环境内部署时，由客户选择并托管模型。向量化模型包含在交付物中，运行时不访问外部资源。

2. 适用范围

助手可以使用客户的品牌：名称、头像、颜色、主题和小部件按钮位置均在项目中设置。项目页面可以在客户自己的域名上打开：通过 DNS 记录确认域名所有权后，路由和 TLS 证书会自动配置。

3. 功能特性

3.1. 项目

项目是同一套部署中的独立空间，在管理面板中创建。无需为每项任务单独搭建基础设施：业务部门的员工自行创建项目、填充内容，即可得到可用的助手。

3.2. 内容填充

知识库文件订阅源分为四种：网站抓取（依据 sitemap.xml 或 robots.txt，若不存在则按广度优先抓取）、对象存储（存储桶列表）、Web 服务器目录自动索引、包含链接列表的清单。类型可自动识别，也可显式指定。订阅源每日及按需更新。

目录字段由语言模型自动映射：软件从任意结构的数据源中挑选有意义的属性，舍弃技术性字段。无需手动描述数据源结构。

3.3. 来源与格式

俄语和英语语音由 Yandex SpeechKit 服务识别。若未接入该服务，音频和视频将存储但不建立索引。

3.4. 生成回答

助手根据与请求的语义相似度在项目知识库和目录中查找信息，并以流式方式输出回答。回答可包含文本、商品卡片和人员档案卡片、技能卡片和面板，以及连接器工具的调用结果。随回答附上其所依据的知识库文件这一功能在项目设置中开启，默认关闭。

当用户要求人工坐席时，助手可以暂停，以便坐席接入对话；该暂停功能在项目设置中开启。项目成员也可以在单个对话中手动关闭助手。

3.5. 技能与连接器

技能是 .skill 格式的软件包，包含说明、触发短语和界面（回答流中的卡片、面板）。将文件拖入管理面板即可把软件包添加到项目；上传时会检查并清理界面模板。候选技能按请求与触发短语的语义相似度选取，而不是按关键词。

连接器是同一格式、但不含界面的软件包，通过 Model Context Protocol（MCP）服务器或调用外部系统的编程接口，让助手能够使用外部系统的工具。一个软件包可以同时包含技能界面和自有连接器，这样场景和接入只需一个文件即可迁移。连接器的授权密钥保存在服务器端的项目中，不会传给浏览器。

技能有两种调用方式：通过语言模型的函数调用机制，以及通过解析模型回答。第二种方式使不支持函数调用的模型也能调用技能；连接器工具通过函数调用机制调用。

3.6. 分析与计量

聊天（对话）是用户与助手之间的往来消息；软件将聊天划分为线程——即围绕用户某一个问题的对话片段，在管理面板“问题”模块的指标中称为分支。

3.7. 访问与保护

登录管理面板的方式：电子邮件地址加密码（需验证地址）、Yandex ID 或 VK ID，以及通过 OpenID Connect 协议的企业身份提供方（例如 Keycloak 或 ADFS）；系统按用户邮箱的域名将其引导至企业登录。成员通过链接或邮件邀请；角色在邀请时指定，之后可更改。

在小部件中，用户可以匿名提问，也可以通过签名令牌识别身份；令牌由客户网站服务器使用项目密钥签发，或由企业身份提供方签发。项目可以限定为仅允许已识别的用户，并限定允许放置小部件的域名列表。

编程接口通过令牌访问，令牌角色为“观察者”（对话和搜索）或“编辑”（另可管理商品）；令牌仅在创建时显示一次。禁止上传可执行文件和脚本。服务端容器以非特权用户运行。

知识库文件和对话附件以私有方式存放在对象存储中：无法通过固定地址打开。软件向项目成员和小部件用户提供有效期受限的文件签名链接——默认不超过一小时。

4. 软件组成

存储：业务实体使用 PostgreSQL 主数据库；独立的 PostgreSQL 向量数据库带 pgvector 扩展（1024 维，余弦距离）；Redis 用于缓存和队列；文件使用对象存储。

5. 运行条件

6. 权利人信息