RunLibraryChatGeneration
文档库会话生成,用自然语言提问,检索文档库相关信息,总结回答
服务地址:
华北2(北京)
输入参数
只看必填
workspaceId业务空间Id
body请求体
docIdList文档id列表
0文档id
enableFollowUp是否开启多轮增强
请选择布尔值
enableMultiQuery是否开启query拆分
请选择布尔值
enableOpenQa是否开启openQA
请选择布尔值
followUpLlmquery多轮增强使用的llm
libraryId文档库id
llmType大模型类型
multiQueryLlmquery拆分使用的llm
query用户输入的query
queryCriteria属性过滤器
andand表达式
0and表达式的内容
boost标签的权重
key标签的key
operator标签的操作符:文档库元信息key存储的...
value标签的值
oror表达式
0or表达式的内容
boost标签的权重
key标签的key
operator标签的操作符:文档库元信息key存储的...
value标签的值
rerankType排序策略类型:linear/model...
sessionIdsessionId
stream流式/非流式
请选择布尔值
subQueryList子查询query列表
0子查询query
textSearchParameter搜索引擎参数--文本搜索参数
limit返回行数
searchAnalyzerType搜索分词器(Standard, IkM...
topK最终召回的语料数量
vectorSearchParameter搜索引擎参数--向量搜索参数
limit返回行数
withDocumentReference是否返回文档引用
请选择布尔值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

请求语法

POST /{workspaceId}/api/run/library/chat/generation HTTP/1.1

路径参数

字段名称字段详情
workspaceIdstring

业务空间 Id

示例值:llm-xxxx

请求参数

字段名称字段详情
bodyobject

请求体。

返回参数

字段名称字段详情
costinteger<int64>

耗时

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:null
dataany

响应数据(非流式)。

示例值:{ "finish":true, "text":"是的,记名预付卡的有效期不得低于3年。", "message": "是的,记名预付卡的有效期不得低于3年。", "queryResult":{ "errCode": "0", //接口协议层面的错误码,正常为0,未授权,参数错误,服务器异常时会发生变化,可以忽略不处理 "message": "ok", //接口协议层面的消息 "data":{ "success": true, //有回答true 无回答false "answer": null, //大模型生成的回答结果 "embeddingElapsedMs": 127, "vectorSearchElapsedMs": 2745, "llmElapsedMs": 7911, "totalElapsedMs": 10820, "chunks": [ //召回的分块信息,一般为top5或top10,可联系我们调整效果 { "chunkId": "470182177892469799", //分块信息的编号 "docId": "22666332", //分块关联的文档编号 "chunkText": "Profits plummeted in the first quarter, can't you bear it? In fact, previous rounds of price cuts have indeed had a certain impact on Tesla's financial data. Tesla has just released its financial report for the first quarter of this year. The data shows that in Q1 2023, Tesla achieved revenue of 23.33 billion US dollars, an increase of 24% over the previous year; Tesla delivered more than 422,000 electric vehicles worldwide in the first quarter, an increase of 36% over the previous year", //新闻原始内容 "chunkMeta": { // demo数据中的其他metadata "language": "en", "unique_id": "news_22666332_13", "content_type": "news", "stock_id_list": [] } }], "documents": [{ "docId": "1686637056086872065", //文档编号 "gmtCreate": "2023-08-02 15:16:25", //文档的创建时间 "libraryId": "a1b2c3", //文档关联的知识库编号 "title": "2023年工银信用卡微信、京东绑卡消费累计积分活动", //文档标题 "url": null //文档连接,如有 }] //块文本关联的文档 }, "success": true //接口协议层面的成功/失败状态 true就是errCode为0 } }
dataTypestring

数据类型

示例值:null
errCodestring

错误码

示例值:0
messagestring

错误信息

示例值:ok
requestIdstring

请求 id

示例值:5E3FBAF1-17AF-53B7-AF0A-CDCEEB6DE658
successboolean

是否成功

示例值:true
timestring

时间戳

示例值:2024-04-24 11:54:34

返回说明

流式接口返回说明

根据历史对话改写结果

{
    "success": true,
    "dataType": "copilotStep",
    "time": "2024-08-26 11:28:10",
    "errCode": "0",
    "message": "ok",
    "data": {
        "stepName": "start_followup_query",  // 开始改写
        "data": "业绩表现如何"
    },
    "requestId": null,
    "cost": null
}


{
    "success": true,
    "dataType": "copilotStep",
    "time": "2024-08-26 11:28:10",
    "errCode": "0",
    "message": "ok",
    "data": {
        "stepName": "completed_followup_query", // 完成改写
        "data": "业绩表现如何"
    },
    "requestId": null,
    "cost": null
}

query 分解

{
    "success": true,
    "dataType": "copilotStep",
    "time": "2024-08-26 11:28:10",
    "errCode": "0",
    "message": "ok",
    "data": {
        "stepName": "start_understand_query",  // 开始拆分
        "data": "业绩表现如何"
    },
    "requestId": null,
    "cost": null
}

{
    "success": true,
    "dataType": "copilotStep",
    "time": "2024-08-26 11:28:12",
    "errCode": "0",
    "message": "ok",
    "data": {
        "stepName": "completed_understand_query",  // 完成拆分
        "data": [
            "业绩表现的具体时间段是什么?",
            "是指哪一行业的业绩表现,或者哪个公司的业绩表现?",
            "业绩表现的数据指标有哪些?例如营收、利润、市场份额等。"
        ]
    },
    "requestId": null,
    "cost": null
}

召回结果

{
    "success": true,
    "dataType": "queryResult",
    "time": "2023-09-20 16:36:04",
    "errCode": "0",
    "message": "retriever completed",
    "data": {
        "success": true,
        "answer": null,
        "prompt": "请使用以下上下文来回答最后的问题。\n 以下是上下文内容:\n 回,本办法另有规定的除外。不记名预付卡有效期不得低于 3 年。\n 预付卡不得具有透支功能。\n 发卡机构发行销售预付卡时,应向持卡人告知预付卡的有效 期及计算方法。超过有效期尚有资金余额的预付卡,发卡机构应 当提供延期、激活、换卡等服务,保障持卡人继续使用。\n 第九条预付卡卡面应当记载预付卡名称、发卡机构名称、 是否记名、卡号、有效期限或有效期截止日、持卡人注意事项、 客户服务电话等要素。\n 第十条个人或单位购买记名预付卡或一次性购买不记名预 付卡 1 万元以上的,应当使用实名并提供有效身份证件。\n 发卡机构应当识别购卡人、单位经办人的身份,\n\n 息。\n 对于记名预付卡,发卡机构还应当在预付卡核心业务处理系 统中记载持卡人的有效身份证件信息、预付卡卡号、金额等信息。\n 第十二条单位一次性购买预付卡 5000 元以上,个人一次性购 买预付卡 5 万元以上的,应当通过银行转账等非现金结算方式购 买,不得使用现金。\n 购卡人不得使用信用卡购买预付卡。\n 第十三条采用银行转账等非现金结算方式购买预付卡的, 付款人银行账户名称和购卡人名称应当一致。\n 发卡机构应当核对账户信息和身份信息的一致性,在预付卡 核心业务处理系统中记载付款人银行账户名称和账号、收款人银 行账户名称和账号、转账金额等信息。\n 第十四\n\n\n\n 基于上下文理解作出回答,保持回答尽可能简洁。如果你不知道答案,直接回答我不知道。\n 问题:记名预付卡有效期不得低于 3 年吗?\n 答案:",
        "embeddingElapsedMs": 1423,
        "vectorSearchElapsedMs": 115,
        "textSearchElapsedMs": 0,
        "llmElapsedMs": null,
        "totalElapsedMs": 1626,
        "reRankElapsedMs": 8,
        "chunks": [
            {
                "libraryId": "5rdxr3dxmk",
                "libraryName": "富滇银行测试知识库",
                "title": "《支付机构预付卡业务管理办法》(中国人民银行公告〔2012〕第 12 号)",
                "chunkId": "478245189908103170",
                "docId": "1701838553380655106",
                "chunkText": "回,本办法另有规定的除外。不记名预付卡有效期不得低于 3 年。\n 预付卡不得具有透支功能。\n 发卡机构发行销售预付卡时,应向持卡人告知预付卡的有效 期及计算方法。超过有效期尚有资金余额的预付卡,发卡机构应 当提供延期、激活、换卡等服务,保障持卡人继续使用。\n 第九条预付卡卡面应当记载预付卡名称、发卡机构名称、 是否记名、卡号、有效期限或有效期截止日、持卡人注意事项、 客户服务电话等要素。\n 第十条个人或单位购买记名预付卡或一次性购买不记名预 付卡 1 万元以上的,应当使用实名并提供有效身份证件。\n 发卡机构应当识别购卡人、单位经办人的身份,",
                "fileType": "pdf",
                "chunkMeta": {},
                "score": 0.92747295
            },
            {
                "libraryId": "5rdxr3dxmk",
                "libraryName": "富滇银行测试知识库",
                "title": "《支付机构预付卡业务管理办法》(中国人民银行公告〔2012〕第 12 号)",
                "chunkId": "478245189908234242",
                "docId": "1701838553380655106",
                "chunkText": "息。\n 对于记名预付卡,发卡机构还应当在预付卡核心业务处理系 统中记载持卡人的有效身份证件信息、预付卡卡号、金额等信息。\n 第十二条单位一次性购买预付卡 5000 元以上,个人一次性购 买预付卡 5 万元以上的,应当通过银行转账等非现金结算方式购 买,不得使用现金。\n 购卡人不得使用信用卡购买预付卡。\n 第十三条采用银行转账等非现金结算方式购买预付卡的, 付款人银行账户名称和购卡人名称应当一致。\n 发卡机构应当核对账户信息和身份信息的一致性,在预付卡 核心业务处理系统中记载付款人银行账户名称和账号、收款人银 行账户名称和账号、转账金额等信息。\n 第十四",
                "fileType": "pdf",
                "chunkMeta": {},
                "score": 0.8335201
            }
        ],
        "vectorChunks": [
            {
                "libraryId": "5rdxr3dxmk",
                "libraryName": null,
                "title": null,
                "chunkId": "478245189908103170",
                "docId": "1701838553380655106",
                "chunkText": "回,本办法另有规定的除外。不记名预付卡有效期不得低于 3 年。\n 预付卡不得具有透支功能。\n 发卡机构发行销售预付卡时,应向持卡人告知预付卡的有效 期及计算方法。超过有效期尚有资金余额的预付卡,发卡机构应 当提供延期、激活、换卡等服务,保障持卡人继续使用。\n 第九条预付卡卡面应当记载预付卡名称、发卡机构名称、 是否记名、卡号、有效期限或有效期截止日、持卡人注意事项、 客户服务电话等要素。\n 第十条个人或单位购买记名预付卡或一次性购买不记名预 付卡 1 万元以上的,应当使用实名并提供有效身份证件。\n 发卡机构应当识别购卡人、单位经办人的身份,",
                "fileType": null,
                "chunkMeta": {},
                "score": 0.85494584
            },
            {
                "libraryId": "5rdxr3dxmk",
                "libraryName": null,
                "title": null,
                "chunkId": "478245189908234242",
                "docId": "1701838553380655106",
                "chunkText": "息。\n 对于记名预付卡,发卡机构还应当在预付卡核心业务处理系 统中记载持卡人的有效身份证件信息、预付卡卡号、金额等信息。\n 第十二条单位一次性购买预付卡 5000 元以上,个人一次性购 买预付卡 5 万元以上的,应当通过银行转账等非现金结算方式购 买,不得使用现金。\n 购卡人不得使用信用卡购买预付卡。\n 第十三条采用银行转账等非现金结算方式购买预付卡的, 付款人银行账户名称和购卡人名称应当一致。\n 发卡机构应当核对账户信息和身份信息的一致性,在预付卡 核心业务处理系统中记载付款人银行账户名称和账号、收款人银 行账户名称和账号、转账金额等信息。\n 第十四",
                "fileType": null,
                "chunkMeta": {},
                "score": 0.6670402
            }
        ],
        "textChunks": [],
        "chunkParts": [],
        "chunkTextList": [
            "回,本办法另有规定的除外。不记名预付卡有效期不得低于 3 年。\n 预付卡不得具有透支功能。\n 发卡机构发行销售预付卡时,应向持卡人告知预付卡的有效 期及计算方法。超过有效期尚有资金余额的预付卡,发卡机构应 当提供延期、激活、换卡等服务,保障持卡人继续使用。\n 第九条预付卡卡面应当记载预付卡名称、发卡机构名称、 是否记名、卡号、有效期限或有效期截止日、持卡人注意事项、 客户服务电话等要素。\n 第十条个人或单位购买记名预付卡或一次性购买不记名预 付卡 1 万元以上的,应当使用实名并提供有效身份证件。\n 发卡机构应当识别购卡人、单位经办人的身份,",
            "息。\n 对于记名预付卡,发卡机构还应当在预付卡核心业务处理系 统中记载持卡人的有效身份证件信息、预付卡卡号、金额等信息。\n 第十二条单位一次性购买预付卡 5000 元以上,个人一次性购 买预付卡 5 万元以上的,应当通过银行转账等非现金结算方式购 买,不得使用现金。\n 购卡人不得使用信用卡购买预付卡。\n 第十三条采用银行转账等非现金结算方式购买预付卡的, 付款人银行账户名称和购卡人名称应当一致。\n 发卡机构应当核对账户信息和身份信息的一致性,在预付卡 核心业务处理系统中记载付款人银行账户名称和账号、收款人银 行账户名称和账号、转账金额等信息。\n 第十四"
        ],
        "documents": [
            {
                "docId": "1701838553380655106",
                "gmtCreate": "2023-09-13 14:01:44",
                "libraryId": null,
                "title": "《支付机构预付卡业务管理办法》(中国人民银行公告〔2012〕第 12 号)",
                "url": null,
                "fileType": "pdf"
            }
        ]
    },
    "cost": null
}

模型总结的结果

{
    "success": true,
    "dataType": "message",
    "time": "2023-09-20 16:36:05",
    "errCode": "0",
    "message": "ok",
    "data": {
        "message": "是的,",// 增量答案
        "text": "是的,", // 累计答案
        "finish": false
    },
    "cost": null
}
变更历史
暂无变更历史