首页 > 其他分享 >QAnything接口文档

QAnything接口文档

时间:2024-07-01 23:20:43浏览次数:16  
标签:files 示例 知识库 接口 QAnything 文档 file time id

QAnything接口主要包括7个接口:新建知识库、查看知识库、删除知识库;上传文件、获取文件列表、删除文件;问答。

一.新建知识库(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/new_knowledge_base

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
user_id "zzp" String 用户id (如需使用前端填zzp不要更换)
kb_name "kb_test" String 知识库名称 (可以随意指定)

3.请求示例

{
    "user_id": "zzp",  //用户id
    "kb_name": "kb_test"  //知识库名称
}

4.响应示例

{
        "code": 200, //状态码
        "msg": "success", //提示信息
        "data": {
                "kb_id": "KB4c50de98d6b548af9aa0bc5e10b2e3a7", //知识库id
                "kb_name": "kb_test" //知识库名称
        }
}

二.上传文件(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/upload_files

说明:Content-Type: multipart/form-data

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
files 文件二进制 [文件类型] 需要上传的文件,可多选(当use_lcoal_file为true时,选择无效)
user_id "zzp" String 用户id
kb_id "KBb1dd58e8485443ce81166d24f6febda7" String 知识库id
mode "strong" String 上传模式,soft:文件名重复的文件不再上传,strong:文件名重复的文件强制上传
use_local_file FALSE Boolean 是否使用本地目录上传文件:「source/data」,可选:【true,false】

3.请求示例

同步请求示例:

import os
import requests

url = "http://{your_host}:8777/api/local_doc_qa/upload_files"
folder_path = "./docx_data"
data = {
    "user_id": "zzp",
    "kb_id": "KB6dae785cdd5d47a997e890521acbe1c9"
}

files = []
for root, dirs, file_names in os.walk(folder_path):
    for file_name in file_names:
        if file_name.endswith(".md"):  # 只上传md文件
            file_path = os.path.join(root, file_name)
            files.append(("files", open(file_path, "rb")))

response = requests.post(url, files=files, data=data)
print(response.text)

异步请求示例:

import argparse
import os
import sys
import json
import aiohttp
import asyncio
import time
import random
import string
import hashlib
import statistics

files = []
for root, dirs, file_names in os.walk("./docx_data"):
    for file_name in file_names:
        if file_name.endswith(".docx"):  # 只上传docx文件
            file_path = os.path.join(root, file_name)
            # if len(file_path) < 50:
            # print(file_path)
            files.append(file_path)
print(len(files))
response_times = []

async def send_request(round_, files):
    print(len(files))
    url = 'http://{your_host}:8777/api/local_doc_qa/upload_files'
    data = aiohttp.FormData()
    data.add_field('user_id', 'zzp')
    data.add_field('kb_id', 'KBf1dafefdb08742f89530acb7e9ed66dd')
    data.add_field('mode', 'soft')
    
    total_size = 0
    for file_path in files:
        # print(file_path)
        file_size = os.path.getsize(file_path)
        total_size += file_size
        data.add_field('files', open(file_path, 'rb'))
    print('size:', total_size / (1024 * 1024))
    try:
        start_time = time.time()
        async with aiohttp.ClientSession() as session:
            async with session.post(url, data=data) as response:
                end_time = time.time()
                response_times.append(end_time - start_time)
                print(f"round_:{round_}, 响应状态码: {response.status}, 响应时间: {end_time - start_time}秒")
              #print(await response.json())
    except Exception as e:
        print(f"请求发送失败: {e}")

async def main():
    start_time = time.time()
    num = int(sys.argv[1])  // 一次上传数量,http协议限制一次请求data不能大于100M,请自行控制数量
    round_ = 0
    r_files = files[:num]
    tasks = []
    task = asyncio.create_task(send_request(round_, r_files))
    tasks.append(task)
    await asyncio.gather(*tasks)

    print(f"请求完成")
    end_time = time.time()
    total_requests = len(response_times)
    total_time = end_time - start_time
    qps = total_requests / total_time
    print(f"total_time:{total_time}")

if __name__ == '__main__':
    asyncio.run(main())

4.响应示例

{
        "code": 200,  //状态码
        "msg": "success,后台正在飞速上传文件,请耐心等待",  //提示信息
        "data": [
                {
                        "file_id": "1b6c0781fb9245b2973504cb031cc2f3",  //文件id
                        "file_name": "网易有道智云平台产品介绍2023.6.ppt",  //文件名
                        "status": "gray"  //文件状态(red:入库失败-切分失败,green,成功入库,yellow:入库失败-milvus失败,gray:正在入库)
                },
                {
                        "file_id": "aeaec708c7a34952b7de484fb3374f5d",
                        "file_name": "有道知识库问答产品介绍.pptx",
                        "status": "gray"
                },
                {
                        "file_id": "8ee98a88457c414a986a09c536fedde9",
                        "file_name": "韦小宝身份证.jpg",
                        "status": "gray"
                },
                {
                        "file_id": "67af479f907b497cadb30c6e4b2d3fbc",
                        "file_name": "成长中心-辅导老师日常问题文档.pdf",
                        "status": "gray"
                }
        ]  //文件列表
}

三.查看知识库(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/list_knowledge_base

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
user_id "zzp" String 用户id

3.请求示例

{
        "user_id": "zzp" //用户id
}

4.响应示例

{
        "code": 200,  //状态码
        "msg": "success",  //提示信息
        "data": [
                {
                        "kb_id": "KB973d4aea07f14c60ae1974404a636ad4",  //知识库id
                        "kb_name": "kb_test"  //知识库名称
                }
        ]   //知识库列表
}

四.获取文件列表(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/list_files

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
user_id "zzp" String 用户id
kb_id "KBb1dd58e8485443ce81166d24f6febda7" String 知识库id

3.请求示例

{
        "user_id": "zzp", //用户id  注意需要满足 只含有字母 数字 和下划线且字母开头 的要求
        "kb_id": "KBb1dd58e8485443ce81166d24f6febda7" //知识库id
}

4.响应示例

{
        "code": 200, //状态码
        "msg": "success", //提示信息
        "data": {
                "total": {  // 知识库所有文件状态
                "green": 100,
                "red": 1,
                "gray": 1,
                "yellow": 1,
                },        
                "details": {  // 每个文件的具体状态
                    {
                        "file_id": "21a9f13832594b0f936b62a54254543b", //文件id
                        "file_name": "有道知识库问答产品介绍.pptx", //文件名
                        "status": "green" //文件状态(red:入库失败-切分失败,green,成功入库,yellow:入库失败-milvus失败,gray:正在入库)
                    },
                    {
                        "file_id": "333e69374a8d4b9bac54f274291f313e", //文件id
                        "file_name": "网易有道智云平台产品介绍2023.6.ppt", //文件名
                        "status": "green" //文件状态(red:入库失败-切分失败,green,成功入库,yellow:入库失败-milvus失败,gray:正在入库)
                    },
                    {
                         "file_id": "709d6c3e071947038645f1f26ad99c6f", //文件id
                         "file_name": "韦小宝身份证.jpg", //文件名
                         "status": "green" //文件状态(red:入库失败-切分失败,green,成功入库,yellow:入库失败-milvus失败,gray:正在入库)
                    },
                    {
                        "file_id": "85297c0b56104028913e89b6834c1a39", //文件id
                        "file_name": "成长中心-辅导老师日常问题文档.pdf", //文件名
                        "status": "green" //文件状态(red:入库失败-切分失败,green,成功入库,yellow:入库失败-milvus失败,gray:正在入库)
                    },
                }
        }
}                

五.问答(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/local_doc_chat

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
user_id "zzp" String 用户id
kb_ids ["KBb1dd58e8485443ce81166d24f6febda7"] Array 知识库id的列表,支持多个知识库联合问答
question "保险单号是多少?" String 知识库id的列表,支持多个知识库联合问答
history [["question1","answer1"],["question2","answer2"]] Array 历史对话

3.请求示例

{
        "user_id": "zzp", //用户id
        "kb_ids": ["KBb1dd58e8485443ce81166d24f6febda7"], //知识库id,支持多个知识库联合问答
        "question": "保险单号是多少?", //用户问题
        "history": [] //历史对话:List[str]
}

4.响应示例

{
        "code": 200, //状态码
        "msg": "success", //提示信息
        "question": "保险单号是多少?", //用户问题
        "response": "保险单号是601J389343982022000536",  //模型回答
        "related_questions": [],  //相关问题
        "history": [
                [
                        "保险单号是多少?",
                        "保险单号是601J389343982022000536。"
                ]
        ], //历史对话:List[List[str]]
        "source_documents": [
                {
                        "file_id": "f9b794233c304dd5b5a010f2ead67f51", //文本内容对应的文件id
                        "file_name": "一嗨案件支付三者车损、人伤保险赔款及权益转让授权书.docx", //文本内容对应的文件名
                        "content": "未支付第三者车损、人伤赔款及同意直赔第三者确认书 华泰财产保险有限公司  北京   分公司: 本人租用一嗨在贵司承保车辆(车牌号:京KML920)商业险保单号: 601J389343982022000536、交强险保单号:  601J310028493882022000570, 对 2023 年 03 月 25日所发生的保险事故(事故号:  9010020230325004124)中所涉及的交强险和商业险的保险赔款总金额 (依:三者京AFT5538定损金额), 同意支付给本次事故中第三者方。 在此本人确认:本人从未支付给第三者方任何赔偿,且承诺不就本次事故再向贵司及一嗨进行索赔。 同时本人保证如上述内容不属实、违反承诺,造成保险人损失的,由本人承担赔偿责任。 确认人(驾驶员)签字:              第三者方签字: 联系电话:                        联系电话: 确认日期:    年    月    日", //文本内容
                        "retrieval_query": "保险单号是多少?", //文本内容对应的问题
                        "score": "3.5585756", //相关性得分,分数越高越相关
                        "embed_version": "local_v0.0.1_20230525_6d4019f1559aef84abc2ab8257e1ad4c" //embedding模型版本号
                }
        ], //知识库相关文本内容
        "rematched_source_documents": [] //重新匹配的文本内容
}

六.删除文件(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/delete_files

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
user_id "zzp" String 用户id
kb_id "KB1271e71c36ec4028a6542586946a3906" String 知识库id
file_ids ["73ff7cf76ff34c8aa3a5a0b4ba3cf534"] Array 要删除文件的id,支持批量删除

3.请求示例

{
        "user_id": "zzp", //用户id
        "kb_id": "KB1271e71c36ec4028a6542586946a3906", //知识库id
        "file_ids": [
                "73ff7cf76ff34c8aa3a5a0b4ba3cf534"
        ] //文件id列表
}

4.响应示例

{
        "code": 200, //状态码
        "msg": "documents ['73ff7cf76ff34c8aa3a5a0b4ba3cf534'] delete success" //提示信息
}

七.删除知识库(POST)

1.URL

http://{your_host}:8777/api/local_doc_qa/delete_knowledge_base

2.请求参数(Body)

参数名 示例参数值 是否必填 参数类型 描述说明
user_id "zzp" String 用户id
kb_ids ["KB1cd81f2bc515437294bda1934a20b235"] Array 要删除的知识库id,支持批量删除

3.请求示例

{
        "user_id": "zzp", //用户id
        "kb_ids": [
                "KB1cd81f2bc515437294bda1934a20b235"
        ] //知识库id列表
}

4.响应示例

{
        "code": 200, //状态码
        "msg": "Knowledge Base [('KB1cd81f2bc515437294bda1934a20b235',)] delete success" //提示信息
}

参考文献

[1] https://github.com/netease-youdao/QAnything/blob/develop_for_v1.2.2/docs/API.md

标签:files,示例,知识库,接口,QAnything,文档,file,time,id
From: https://www.cnblogs.com/shengshengwang/p/18279026

相关文章

  • 解析QAnything启动命令过程
    一.启动命令过程日志启动命令bash./run.sh-clocal-i0-bhf-mQwen-1_8B-Chat-tqwen-7b-chat。输入日志如下所示:root@MM-202203161213:/mnt/l/20230918_RAG方向/QAnything#bash./run.sh-clocal-i0-bhf-mQwen-1_8B-Chat-tqwen-7b-chatFromhttps://github.c......
  • 解析QAnything启动命令过程
    一.启动命令过程日志启动命令bash./run.sh-clocal-i0-bhf-mQwen-1_8B-Chat-tqwen-7b-chat。输入日志如下所示:root@MM-202203161213:/mnt/l/20230918_RAG方向/QAnything#bash./run.sh-clocal-i0-bhf-mQwen-1_8B-Chat-tqwen-7b-chatFromhttps://gi......
  • QAnything接口文档
    QAnything接口主要包括7个接口:新建知识库、查看知识库、删除知识库;上传文件、获取文件列表、删除文件;问答。一.新建知识库(POST)1.URLhttp://{your_host}:8777/api/local_doc_qa/new_knowledge_base2.请求参数(Body)参数名示例参数值是否必填参数类型描述说明user_id“zzp......
  • 通过容器启动QAnything知识库问答系统
    QAnything(QuestionandAnswerbasedonAnything)是致力于支持任意格式文件或数据库的本地知识库问答系统,可断网安装使用。目前已支持格式:PDF(pdf),Word(docx),PPT(pptx),XLS(xlsx),Markdown(md),电子邮件(eml),TXT(txt),图片(jpg,jpeg,png),CSV(csv),网页链接(html)等格式。一.后......
  • 万字长文|下一代系统内存数据加速接口SDXI解读
    本文内容分为5章节,总计10535字,内容较多,建议先收藏!1.SDXI技术产生的背景2.SDXI相比DMA的优势3.SDXI实现原理与架构  3.1描述符环原理解读  3.2上下文管理介绍  3.3AKey与RKey解读  3.4错误日志和状态管理  3.5跨Function访问4.SDXI与CXL协同......
  • 基于Flask的学生宿舍管理系统(含源码、文档、PPT、配套开发软件、软件安装教程)
    该项目含有源码、文档、PPT、配套开发软件、软件安装教程、项目发布教程、包运行成功软件开发环境及开发工具:开发语言:python使用框架:Flask前端技术:JavaScript、VUE.js(2.X)、css3开发工具:pycharm、VisualStudioCode、HbuildX数据库:MySQL5.7.26(版本号)数据库管理工具:phps......
  • springcloud-gateway 网关组件中文文档
      SpringCloud网关GreenwichSR5该项目提供了一个基于Spring生态系统的API网关,其中包括:Spring5,SpringBoot2和项目Reactor。SpringCloud网关的目的是提供一种简单而有效的方法来路由到API,并向它们提供跨领域的关注,例如:安全性,监视/度量和弹性。  如......
  • Apipost接口测试工具的原理及应用详解(四)
    本系列文章简介:        随着软件行业的快速发展,API(应用程序编程接口)作为不同软件组件之间通信的桥梁,其重要性日益凸显。API的质量直接关系到软件系统的稳定性、性能和用户体验。因此,对API进行严格的测试成为软件开发过程中不可或缺的一环。在众多API测试工具中,Apipost......
  • Apipost接口测试工具的原理及应用详解(五)
    本系列文章简介:        随着软件行业的快速发展,API(应用程序编程接口)作为不同软件组件之间通信的桥梁,其重要性日益凸显。API的质量直接关系到软件系统的稳定性、性能和用户体验。因此,对API进行严格的测试成为软件开发过程中不可或缺的一环。在众多API测试工具中,Apipost......
  • 《优化接口设计的思路》系列:第十一篇—表格的导入导出接口优化
    一、前言大家好!我是sum墨,一个一线的底层码农,平时喜欢研究和思考一些技术相关的问题并整理成文,限于本人水平,如果文章和代码有表述不当之处,还请不吝赐教。作为一名从业已达六年的老码农,我的工作主要是开发后端Java业务系统,包括各种管理后台和小程序等。在这些项目中,我设计过单/多......