Skip to content
开发文档
能力中心
应用市场
WebOffice
开发者后台

团队文档片段召回

根据关键字召回原文相关片段

请求说明

请求地址https://openapi.wps.cn/v7/aidocs/recall_rank
请求方法POST
签名方式KSO-1
权限要求读写智能文档库应用数据(应用授权) kso.aidocs.readwrite

请求头(Header)

Header 名称参数类型是否必填说明
Content-Typestring使用:application/json
X-Kso-DatestringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-AuthorizationstringKSO-1 签名值,详见《签名方法》
Authorizationstring授权凭证,格式为:Bearer {access_token}

请求体(Body)

名称参数类型是否必填说明
querystring查询关键字
driveslist[object]团队id和file_id,召回的范围
∟ drive_idstring团队id
∟ file_idslist[string]不传默认召回范围是整个团队
topkint召回排序之后的片段数量(上限100)

请求地址示例

[POST] https://openapi.wps.cn/v7/aidocs/recall_rank

请求体示例

json
{
  "query":"2025年第一季度的财报",
  "drives":[
  {
    "drive_id":"2125182427",
    "file_ids":[
    "1111",
    "2222",
    ]
  },
  {
    "drive_id":"2125182428",
  }
  ],
  "topk":88,
}

响应体

名称参数类型说明
codeinteger响应代码。非 0 表示失败,参照《状态码说明》
msgstring响应信息
dataobject响应数据
∟ file_idstring文件id
∟ file_namestring文件名
∟ link_urlstring文件跳转链接
∟ drive_idstring团队id
∟ contentstring片段内容
∟ image_urllist[string]所有段落结构信息(paragraph)的图片信息的集合,并且会进行去重处理。
∟ table_contentlist[string]表格内容
∟ chunk_idint片段序号
∟ ref_scorefloat相关性得分
∟ paragraphslist[object]段落结构信息
∟ ∟ contentstring文章或段落内容
∟ ∟ content_typestring该paragraph的内容类型,目前支持的类型有: 内容类型: 表格:table 标题:title 正文:para 页眉:page_header 页码:page_number 页脚:page_footer 图像:image
∟ ∟ image_urllist[string]如果 content_type 是 image, 该字段会返回公网可以访问的 url。 该链接将会设置有效期,目前暂定是 24h。
∟ ∟ levelint标题等级

响应体示例

json
{
  "code": 0,
  "data": [
    {
      "file_id": "338204329892",
      "file_name": "OpenAI发布GPT-4,大模型的发展进入新的里程碑.pdf",
      "link_url": "https://365.kdocs.cn/l/cmlmxhgk95Kh",
      "drive_id": "2410178939",
      "image_url": [
        "doc_qa/gray/v1/document/66f3afa2175bdb51dfb971ca/cT6qY0u5KYgPTp58YaQtL62teEU8eNufoEiwWOOYXNg/670cea040f043a01ad8f9ac6/media/1728899588704/3.png",
        "doc_qa/gray/v1/document/66f3afa2175bdb51dfb971ca/cT6qY0u5KYgPTp58YaQtL62teEU8eNufoEiwWOOYXNg/670cea040f043a01ad8f9ac6/images/d743df7b29214decb8009ecdeae17f15/9_0.jpeg",
        "doc_qa/gray/v1/document/66f3afa2175bdb51dfb971ca/cT6qY0u5KYgPTp58YaQtL62teEU8eNufoEiwWOOYXNg/670cea040f043a01ad8f9ac6/media/1728899588704/8.png"
      ],
      "table_content": [
        "||投资咨询资格编号|\n|S1060517070006|\n|YANLEI511@pingan. com. cn|\n||投资咨询资格编号|\n|S1060520070001|\n|FUQIANG021@pingan. com. cn|\n||投资咨询资格编号|\n|S1060519090004|\n|XUYONG318@pingan. com. cn|\n",
        "||一般证券从业资格编号|\n|S1060121070070|\n|XUBIYUN372@pingan. com. cn|\n"
      ],
      "ref_score": 0.6063527803649517,
      "chunk_id": 1,
      "content": "行业报告行业点评证券研究报告\n计算机\n2023年 03月 15日\n行业点评\nOpenAI发布GPT-4,大模型的发展进入新的里程碑\n强于大市(维持)\n||投资咨询资格编号|\n|S1060517070006|\n|YANLEI511@pingan. com. cn|\n||投资咨询资格编号|\n|S1060520070001|\n|FUQIANG021@pingan. com. cn|\n||投资咨询资格编号|\n|S1060519090004|\n|XUYONG318@pingan. com. cn|\n\n||一般证券从业资格编号|\n|S1060121070070|\n|XUBIYUN372@pingan. com. cn|\n\n事项:\n当地时间 3月 14日,OpenAI发布GPT-4。在OpenAI的网站上,对GPT-4的描述是:GPT-4是OpenAI最先进的系统,能够给出更安全和更有用的响应。",
      "paragraphs": [
        {
          "content": "行业报告行业点评证券研究报告",
          "content_type": "para",
          "level": 10
        },
        {
          "content": "||投资咨询资格编号|\n|S1060517070006|\n|YANLEI511@pingan. com. cn|\n||投资咨询资格编号|\n|S1060520070001|\n|FUQIANG021@pingan. com. cn|\n||投资咨询资格编号|\n|S1060519090004|\n|XUYONG318@pingan. com. cn|\n",
          "content_type": "table",
          "level": 10
        },
        {
          "content": "GPT-4根据OpenAI网站的信息,虽然在OpenAI的内部评估中,与GPT-3.5相比,GPT-4响应不被允许的内容的请求的可能性降低 82%,产生符合事实的响应的可能性提高 40%。但是,GPT-4与之前的GPT模型一样,仍然有局限性。在对抗性问题测试中,GPT-4仍然会犯错。而且,GPT-4缺乏对绝大多数训练数据中断后(2021年 9月之后)的事件的了解。另外,GPT-4有时也会像人类一样在难题上失败,例如,GPT-4在其生成的代码中也会引入安全漏洞。因此,GPT-4",
          "content_type": "para",
          "level": 10
        },
        {
          "content": "推荐(预计 6个月内,股价表现强于市场表现 10%至 20%之间)",
          "content_type": "para",
          "level": 10
        }
      ]
    }
  ],
  "msg": "success"
}