活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 驭马迎春·福礼抢先领 5.5折无门槛折扣券+开箱即用方案双加持,节后上云快人一步!
  • 云上钜惠 爆款云主机全场特惠,2核4G只要1.8折起!
  • 中小企业服务商合作专区 国家云助力中小企业腾飞,高额上云补贴重磅上线
  • 出海产品促销专区 NEW 爆款云主机低至2折,高性价比,不限新老速来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

息壤智算

领先开放的智算服务平台,提供算力、平台、数据、模型、应用“五位一体”智算服务体系,构建全流程的AI基础设施能力
AI Store
  • 算力市场
  • 模型市场
  • 应用市场
  • MCP市场
算力互联调度平台
  • 裸金属
  • 定制裸金属
训推服务
  • 模型开发
  • 训练任务
  • 服务部署
模型推理服务
  • 模型广场
  • 体验中心
  • 服务接入
应用托管
  • 应用实例
科研助手
  • 科研智能体
  • 科研服务
  • 开发机
  • 并行计算
大模型
  • DeepSeek-V3.1
  • DeepSeek-R1-0528
  • DeepSeek-V3-0324
  • Qwen3-235B-A22B
  • Qwen3-32B
智算一体机
  • 智算一体机
模型适配专家服务
  • 模型适配专家服务
算力服务商
  • 入驻算力服务商

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场进入AI Store创新解决方案公有云生态专区智云上海应用生态专区
建站工具
  • 新域名服务
  • SSL证书
  • 翼建站
企业办公
  • 安全邮箱
  • WPS 365 天翼云版
  • 天翼企业云盘(标准服务版)
灾备迁移
  • 云管家2.0
  • 翼备份(SaaS版)

定价

协助您快速了解云产品计费模式、价格详情,轻松预估上云成本
价格计算器
  • 动态测算产品价格
定价策略
  • 快速了解计费模式

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼信创云专区
  • 信创云专区
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
培训与认证
  • 天翼云学堂
  • 天翼云认证
开源社区
  • 魔乐社区
  • OpenTeleDB

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 服务保障
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家
我要反馈
  • 建议与反馈
  • 用户体验官
信息公告
  • 客户公告

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 息壤智算
  • 产品
  • 解决方案
  • 应用商城
  • 定价
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      知识库问答

      知识库问答

      • 知识库问答

      无数据

        • 产品介绍
        • 产品简介
        • 产品功能
        • 产品优势
        • 计费说明
        • 计费模式
        • 查询消耗
        • 产品续订
        • 产品退订
        • 快速入门
        • 平台说明
        • 账号说明
        • 接入流程
        • 开通服务
        • 智能体入口
        • 用户指南
        • 控制台
        • 功能简介
        • 实例列表
        • 实例概览
        • 用量趋势
        • 智能体应用
        • 功能简介
        • 知识库问答
        • 数据源说明
        • 对话操作
        • 新对话配置
        • 对话详情操作
        • 查看历史对话
        • 系统管理
        • 前置说明
        • 基础管理
        • 数据概览
        • 公共文档库管理
        • 基座模型配置
        • 联网搜索配置
        • 日志管理
        • 权限管理
        • 用户管理
        • 角色管理
        • 角色类型说明
        • 新增/删除/编辑角色
        • 角色授权/取消授权
        • 一键投诉
        • 常见问题
        • 控制台操作
        • 知识库问答智能体操作
        • 系统管理操作
        • 模型服务续订
        • 模型服务操作
        • 最佳实践
        • 坐席助手
        • 企业知识库
        • 邀请外部账号使用
        • 文档权限管理
        • API参考
        • 调用前必知
        • 状态码
        • 如何调用API
        • 终端节点
        • 构造请求
        • 认证鉴权
        • Python3调用示例
        • Java调用示例
        • PHP调用示例
        • C#调用示例
        • API
        • 查询类目详情
        • 创建知识库
        • 更新知识库
        • 删除知识库
        • 查询知识库列表
        • 获取知识库下文档列表
        • 生成文件上传预签名地址
        • 上传文件到预签名地址
        • 上报文件上传完成状态
        • 获取知识库中文件详情
        • 删除知识库中文件
        • 查询模型列表
        • 知识库问答
        • 获取文件切片详情
        • 查询知识库切分策略详情
        • 文档下载
          无相关产品

          本页目录

          帮助中心知识库问答API参考API知识库问答
          知识库问答
          更新时间 2026-01-13 00:41:10
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2026-01-13 00:41:10
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          本文介绍知识库问答内容。

          接口描述

          依据知识库与大模型进行对话问答

          请求方法

          POST

          接口要求

          无

          URI
          /openapi/v1/rag/talk                

          请求参数

          请求头header参数

          参数是否必填参数类型说明示例下级对象
          Content-Type是Stringjson格式application/json 
          tenantId是String租户ID562b89493b1a40e1b97ea05e50dd8170 
          ctyun-eop-request-id是String用户请求 id,由用户构造,用户可以通过 uuid 等方法自行生成唯一字符串,用于日志请求追踪33dfa732-b27b-464f-b15a-21ed6845afd5 
          eop-date是String请求时间,由用户构造,形如 yyyymmddTHHMMSSZ。20211221T163014Z 
          host是String终端节点域名,固定字段kqa-global.ctapi.ctyun.cn 
          Eop-Authorization是String由天翼云官网 accessKey 和 securityKey 经签名后生成,参与签名生成的字段包括天翼云官网 accessKey 、securityKey、平台应用的appkey(非必须),用户请求id(非必须),请求时间,终端节点域名(非必须)以及请求体内容。  

          请求体body参数

          参数是否必填参数类型说明示例下级对象
          text是String问题的文本内容- 
          infobaseIds否Array[String]通用知识库ID列表  
          customBaseIds否Array[String]自定义知识库ID列表  
          modelId是String模型ID  
          contextId否String上一轮会话的ID,需要多轮对话时使用  
          searchEnable否Boolean是否开启联网搜索  
          index否Boolean 是否输出文档索引引用标签  

          prompt

          否String用户自定义输入的prompt  

          请求代码示例

          Curl -X POST "https://kqa-global.ctapi.ctyun.cn/openapi/v1/rag/talk"
          -H "Content-Type: application/json"
          -H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
          -H "tenantId:XXX"
          -H "Eop-Authorization:XXX"
          -H "eop-date:20211109T104641Z"
          -H "host:kqa-global.ctapi.ctyun.cn"
          --data '{
              "text": "总结下文档内容",
              "infobaseIds": [123456789, 987654321],
              "modelId": "d5f09a41d4584715a5d94a4892411c0f",
              "searchEnable": false,
          		"index": true,
              	"prompt": "请依据文档内容进行回答,不得使用超出文档内容的知识;\n- 确保您的回答既精确又实用且忠实于原文,同时覆盖所有相关的要点,以满足用户的查询需求;\n- 要求语句通顺,条理清晰,易于阅读;\n- 请不要随意发散,尽量以原文档内容输出;\n- 对于包含多个子问题的问题,请回答每一个子问题,不要遗漏问题;  \n下面是文档信息:\n{chunks}\n问题为:{question}\n开始回答:\n"
            }'

          返回值说明

          1.请求成功返回响应参数

          参数参数类型说明示例下级对象
          statusCodeString返回状态,返回200表示成功200 
          messageString返回SuccessSuccess 
          returnObjObject接口返回结果 returnObj表

          returnObj表

          参数参数类型说明示例下级对象
          codeInt0表示成功0 
          messageString返回successsuccess 
          resultObject对话结果 result表

          result表

          参数参数类型说明示例下级对象
          inputString对话输入文本介绍下定积分 
          outputString对话输出文本定积分是一种.... 
          contextIdString此轮对话的ID  
          finishStateString会话状态
          状态取值:start(开始)/continued(生成中)/stop(正常结束)/interrupt(中断)
          stop 
          inferSource Array[Object]拼入模型prompt的参考文档信息。请求体参数index为false时生效 inferSource对象

          indexInfo

          Array[Object]模型回复的参考引用片段。请求体参数index为true时生效  indexInfo对象

          indexInfo表

          参数参数类型说明示例下级对象

          indexId

          int

          引用下标

          1

           

          subTitle

          String

          子标题

           

           

          docTitlec

          String

          文档标题

          文档.doc

           
          docTitleString来源Knowledge 
          contentString引用片段内容  
          fileNameString引用文档名称文档.doc 
          fileIdString引用文档id133 

          inferSource表

          参数参数类型说明示例下级对象

          fileName

          String

          检索到的参考文档名称

          文档.doc

           

          fileId

          String

          检索到的参考文档id

          133

           

          fileType

          String

          文档类型

          doc

           
          contentTextString参考文档的内容  
          scoreFloat参考文档和用户输入的相关性分数,取值[0-1]0.33 

          2.请求失败返回响应参数

          参数参数类型说明示例下级对象
          statusCodeString错误码,放置API对应的错误码40001 
          messageString失败信息缺少鉴权信息 
          errorString返回对应的错误码KQA_40001 

          返回值示例

          该接口为SSE接口,返回值为流式返回,返回时Content-Type为text/event-stream。

          1.请求成功返回值示例(关闭引用开关index=false)

          data:{     
          	'statusCode': 200,          
              "error": null,
              "message": "Success",
              "returnObj": {
                  "code": 0,
                  "message": "success",
                  "result": {
                      "input": "水泥的国标",
                      "output": "<think>\n好的,我现在需要处理用户的问题:“水泥的国标”。首先。。。",
                      "finishState": "stop",
                      "contextId": "2f963a77-e58b-467e-ad92-23ddf2e4015b",
                      "inferSource": [
                          {
                              "fileName": "筑府办函xx号附件.wps",
                              "fileId": 32432,
                              "fileType": "doc",
                              "contentText": "xxx",
                              "score": 0.37754068
                          }
                      ],
                      "indexInfo": []
                  },
                  "details": null
              }
          }

          2.请求成功返回值示例(开启引用开关index=true)

          data:{
              "statusCode": 200,
              "error": null,
              "message": "Success",
              "returnObj": {
                  "code": 0,
                  "message": "success",
                  "result": {
                      "input": "水泥的国标",
                      "output": "根据提供的文档内容,水泥的参考标准为**GB 16780**[[1]]。。。",
                      "finishState": "stop",
                      "contextId": "bcca2bb9-5b45-4d41-b9b8-78a24659b3d5",
                      "inferSource": [],
                      "indexInfo": [
                          {
                              "indexId": 1,
                              "subTitle": "",
                              "docTitle": "筑府办函xx号附件.wps",
                              "from": "Knowledge",
                              "content": "xxx",
                              "fileName": "筑府办函xx号附件.wps",
                              "fileId": 32432
                          }
                      ]
                  },
                  "details": null
          	}
          }

          3.请求失败返回值示例   

          data:{
                "statusCode": "40004",
                "error": "KQA_40004",
                "message": "接口执行异常"
          }

          状态码

          http状态码描述
          200表示请求成功

          错误码说明

          错误码错误信息错误描述
          40013对话出现异常无法进行正常交互
          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  查询模型列表
          下一篇 :  获取文件切片详情
          搜索 关闭
          ©2026 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2026天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明