{"id":13754369,"url":"https://github.com/wuba/qa_match","last_synced_at":"2025-04-29T22:39:41.330Z","repository":{"id":46594940,"uuid":"245431046","full_name":"wuba/qa_match","owner":"wuba","description":"A simple effective ToolKit for short text matching","archived":false,"fork":false,"pushed_at":"2022-07-19T06:24:55.000Z","size":2237,"stargazers_count":328,"open_issues_count":4,"forks_count":86,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-29T22:39:23.330Z","etag":null,"topics":["58","ai","deep-learning","dssm","lstm","machine-learning","nlp","qabot","qatools","tensorflow"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wuba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-06T13:47:37.000Z","updated_at":"2025-03-31T05:36:18.000Z","dependencies_parsed_at":"2022-09-22T18:50:43.776Z","dependency_job_id":null,"html_url":"https://github.com/wuba/qa_match","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wuba%2Fqa_match","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wuba%2Fqa_match/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wuba%2Fqa_match/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wuba%2Fqa_match/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wuba","download_url":"https://codeload.github.com/wuba/qa_match/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251596590,"owners_count":21615011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["58","ai","deep-learning","dssm","lstm","machine-learning","nlp","qabot","qatools","tensorflow"],"created_at":"2024-08-03T09:01:57.137Z","updated_at":"2025-04-29T22:39:41.297Z","avatar_url":"https://github.com/wuba.png","language":"Python","funding_links":[],"categories":["实体识别NER、意图识别、槽位填充"],"sub_categories":["其他_文本生成、文本对话"],"readme":"# 项目介绍\nqa_match是一款基于深度学习的问答匹配工具，支持一层和两层结构知识库问答。qa_match通过意图匹配模型支持一层结构知识库问答，通过融合领域分类模型和意图匹配模型的结果支持两层结构知识库问答。qa_match同时支持无监督预训练功能，通过轻量级预训练语言模型（SPTM，Simple Pre-trained Model）可以提升基于知识库问答等下游任务的效果。\n\n## 知识库问答\n在实际场景中，知识库一般是通过人工总结、标注、机器挖掘等方式进行构建，知识库中包含大量的标准问题，每个标准问题有一个标准答案和一些扩展问法，我们称这些扩展问法为扩展问题。对于一层结构知识库，仅包含标准问题和扩展问题，我们把标准问题称为意图。对于两层结构知识库，每个标准问题及其扩展问题都有一个类别，我们称为领域，一个领域包含多个意图。\n\nqa_match支持知识库结构如下：\n\n![知识库结构](docs/kg_demo.png)\n\n对于输入的问题，qa_match能够结合知识库给出三种回答：\n1. 唯一回答（识别为用户具体的意图）\n2. 列表回答（识别为用户可能的多个意图）\n3. 拒识（没有识别出具体的用户意图）\n\n在两种知识库结构下，qa_match的使用方式存在差异，以下分别说明：\n\n### 基于两层结构知识库的自动问答\n\n![两层结果融合](docs/lstm_dssm_bagging.png)  \n\n对于两层结构知识库问答，qa_match会对用户问题先进行领域分类和意图识别，然后对两者的结果进行融合，获取用户的真实意图进行相应回答（唯一回答、列表回答、拒绝回答）。\n举个例子：如上述知识库问答中[知识库结构图](#知识库问答)所示，我们有一个两层结构知识库，它包括”信息“和”账号“两个领域”。其中“信息”领域下包含两个意图：“如何发布信息”、“如何删除信息”，“账号”领域下包含意图：“如何注销账号”。当用户输入问题为：“我怎么发布帖子？”时，qa_match会进行如下问答逻辑：\n\n1. 分别用LSTM领域分类模型和DSSM意图匹配模型对输入问题进行打分，如：领域分类模型最高打分为0.99且识别为“信息”领域，意图匹配模型最高打分为0.98且识别为“如何发布信息”意图。由于领域分类模型最高打分对应的label为信息类，所以进入判断为某一类分支。\n2. 进入判断为某一分类分支后，用领域分类模型的最高打分0.99与两层结构知识库问答图中阈值b1（如b1=0.9）进行对比，由于0.99\u003e=b1,判断为走“严格DSSM意图匹配”子分支。\n3. 进入“严格DSSM意图匹配”分支后，用意图匹配模型的最高打分0.98与阈值x1(例如x1=0.8),x2(如x2=0.95)做比较，发现0.98\u003ex2,由此用如何发布信息对应的答案进行唯一回答（其他分支回答类似）。\n\n### 基于一层结构知识库的自动问答\n\n实际场景中，我们也会遇到一层结构知识库问答问题，用DSSM意图匹配模型与SPTM轻量级预训练语言模型均可以解决此类问题，两者对比：\n\n| 模型                     | 使用方法                                       | 优点                                                         | 缺点                                                         |\n| ------------------------ | ---------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |\n| DSSM意图匹配模型         | DSSM匹配模型直接匹配                           | ①使用简便，模型占用空间小\u003cbr/\u003e②训练/预测速度快               | 无法利用上下文信息                                           |\n| SPTM轻量级预训练语言模型 | 预训练LSTM/Transformer语言模型\u003cbr/\u003e+微调LSTM/Transformer匹配模型 | ①能够充分利用无监督预训练数据提升效果\u003cbr/\u003e②语言模型可用于其他下游任务 | ①预训练需要大量无标签数据\u003cbr/\u003e②操作较复杂（需两个步骤得到匹配模型） |\n\n#### 基于DSSM模型的自动问答\n![一层结果融合](docs/dssm.png)\n\n对于一层结构知识库问答，只需用DSSM意图匹配模型对输入问题进行打分，根据意图匹配的最高分值与上图中的x1，x2进行比较决定回答类型（唯一回答、列表回答、拒识）。\n\n#### 基于SPTM模型的自动问答\n\n##### 轻量级预训练语言模型（SPTM，Simple Pre-trained Model）介绍\n\n考虑到实际使用中往往存在大量的无标签数据，在知识库数据有限时，可使用无监督预训练语言模型提升匹配模型的效果。参考[BERT](https://github.com/google-research/bert)预训练过程，2019年5月我们开发了SPTM模型，该模型相对于BERT主要改进了三方面：一是去掉了效果不明显的NSP（Next Sentence Prediction），二是为了提高线上推理性能将Transformer替换成了LSTM，三是为了保证模型效果降低参数量也提供了BLOCK间共享参数的Transformer，模型原理如下：\n\n###### 数据预处理\n\n预训练模型时，生成训练数据需要使用无标签单句作为数据集，并参考了BERT来构建样本：每个单句作为一个样本，句子中15%的字参与预测，参与预测的字中80%进行mask，10%随机替换成词典中一个其他的字，10%不替换。\n\n###### 预训练\n\n预训练阶段的模型结构如下图所示：\n\n\n\n![模型结构](docs/sptm.png)\n\n为提升模型的表达能力，保留更多的浅层信息，引入了残差Bi-LSTM网络（Residual LSTM）作为模型主体。该网络将每一层Bi-LSTM的输入和该层输出求和归一化后，结果作为下一层的输入。此外将最末层Bi-LSTM输出作为一个全连接层的输入，与全连接层输出求和归一化后，结果作为整个网络的输出。\n\n预训练任务耗时示例如下表所示： \n\n| **指标名称**     | **指标值**                       | **指标值**                                    | **指标值**                           |\n| ---------------- | -------------------------------- | ----------------------------------------------- | ----------------------------------------------- |\n|模型结构          | LSTM                             | 共享参数的Transformer                          | 共享参数的Transformer          |\n| 预训练数据集大小 | 10Million                        | 10Million                                      | 10Million                             |\n| 预训练资源       | 10台Nvidia K40   / 12G Memory       | 10台Nvidia K40   / 12G Memory                     | 10台Nvidia K40   / 12G Memory |\n| 预训练参数       | step = 100000 / batch size = 128 | step = 100000 / batch size = 128 / 1 layers / 12 heads | step = 100000 / batch size = 128 / 12 layers / 12 heads |\n| 预训练耗时       | 8.9 hours              | 13.5 hours                                             | 32.9 hours                                              |\n| 预训练模型大小   | 81M                            | 80.6M                                        | 121M                                    |\n\n##### SPTM自动问答流程\n\n![预训练语言模型](docs/pretrain.png)\n\n引入SPTM后，对于一层结构知识库问答，先使用基于语言模型微调的意图匹配模型对输入问题进行打分，再根据与DSSM意图匹配模型相同的策略决定回答类型（唯一回答、列表回答、拒识）。\n\n## 如何使用\n### 数据介绍\n需要使用到的数据文件（data_demo文件夹下）格式说明如下，这里为了不泄露数据，我们对标准问题和扩展问题原始文本做了编码，在实际应用场景中直接按照以下格式准备数据即可。  \n- std_data：类别和标准问题对应关系，包含类别ID、标准问题ID、标准问题文本三列\n- pre_train_data：无标签的预训练数据集，每行是一段文本\n- vocab：预训练数据字典，每行是一个词（字典应包含`\u003cPAD\u003e`、\u003cUNK\u003e`、`\u003cMASK\u003e`）\n- train_data：训练集，包含标准问题ID、扩展问题ID、扩展问题文本三列\n- valid_data：验证集，包含标准问题ID、扩展问题ID、扩展问题文本三列\n- test_data：测试集，包含标准问题ID、扩展问题ID、扩展问题文本三列\n\n数据以\\t分隔，问题编码以空格分隔，字之间以空格分隔。注意在本项目的数据示例中，对原始文本做了编码，将每个字替换为一个数字, 例如`205 19 90 417 41 44` 对应的实际文本是`如何删除信息`，**在实际使用时不需要做该编码操作**；若知识库结构为一级，需要把std_data文件中的类别id全部设置为`__label__0`。\n\n### 知识库半自动挖掘流程\n\n知识库半自动挖掘流程，是在qa match自动问答流程的基础上（参考qa match 基于一层知识库结构的自动问答）构建的一套知识库半自动挖掘方案，帮助提升知识库规模与知识库质量，一方面提高线上匹配的能力；一方面提高离线模型训练数据的质量，进而提高模型性能。知识库半自动挖掘流程可以用于冷启动挖掘和模型上线后迭代挖掘两个场景。详情参见[知识库挖掘说明文档](./dec_mining/README.md)\n\n### 怎么运行\n详情见[运行说明](docs/RUNDEMO.md)\n\n### tips\n1. 由于DSSM模型训练选取负样本时是将原样本对应标签随机打散，所以模型参数需要满足`batch_size \u003e= negitive_size`，否则模型无法有效训练。\n2. 模型融合参数选取方法：目前参数的选取是基于统计的，首先在测试集上计算同一参数（如两层结构知识库问答图中a1）不同值所对应的模型label（如拒识）的f1值，然后选取较大的f1值对应的数值做为该参数的取值。如：在选取两层结构知识库问答图中参数a1的最终取值时,首先会在测试集上得到不同a1候选值对应的模型label（如拒识，非拒识），然后根据样本的真实label计算f1值，最后选取合适的f1值（根据项目需求可偏重准确率/召回率）对应的候选值作为a1的最终取值。\n\n## 运行环境\n```\ntensorflow 版本\u003er1.8 \u003cr2.0, python3\n```\n\n## 版本\nv1.0:https://github.com/wuba/qa_match/tree/v1.0\n\nv1.1:https://github.com/wuba/qa_match/tree/v1.1\n\nv1.2:https://github.com/wuba/qa_match/tree/v1.2\n\nv1.3:https://github.com/wuba/qa_match/tree/v1.3\n\n## 未来规划\n未来我们会继续优化扩展qa_match的能力，计划开源如下：\n1. 目前tensorflow已发版到2.4版本，后续我们会根据需求发布tensorflow 2.X版本或pytorch版本的qa_match。\n\n## 如何贡献\u0026问题反馈\n我们诚挚地希望开发者向我们提出宝贵的意见和建议。您可以挑选以下方式向我们反馈建议和问题：\n1. 在 github上 提交 PR 或者 Issue\n2. 邮件发送至 ailab-opensource@58.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwuba%2Fqa_match","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwuba%2Fqa_match","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwuba%2Fqa_match/lists"}