知識庫問答配置

1.1 版本

1.2 應用場景

FineChatBI 的知識問答功能支援使用者在智慧配置中接入企業自行開發的API，實現對企業內部知識庫的問答服務。

1.3 功能簡介

使用者開啟知識庫問答功能之後，知識庫根據使用者輸入查詢內容生成對應回答的 HTML 字串並進行 Base64 編碼，帆軟再解碼還原 HTML 並並將其渲染至 FineChatBI 卡片答覆介面。

2.1 API概覽

• 請求方式：POST

• 請求地址：企業自訂的API地址

在「智慧問答配置>其他配置」中開啟「知識庫問法」，輸入企業自訂的API地址。

2.2 入參

2.3 出參

2.4 範例

• 知識庫編碼匯出：

對於要匯出的字串 <div>Hello world! 你好世界！</div> ，系統將其經過 Base64 編碼處理後，匯出以下的出參結果給到帆軟：

 PGRpdj5IZWxsbyB3b3JsZCEg5L2g5aW95LiW55WM77yBPC9kaXY+

{
    "data": "PGRpdj5IZWxsbyB3b3JsZCEg5L2g5aW95LiW55WM77yBPC9kaXY+",
    "code": 200
}

• 帆軟解碼渲染

帆軟獲取 base64 編碼後，自動執行解碼操作，還原為初始 html 字串 <div>Hello world! 你好世界！</div>，並將其渲染至 FineChatBI 卡片答覆介面。

3.1 接口概览

• 请求方式：POST
  

• 请求地址：企业自定义的接口地址（需是流式输出地址，否则将报错）

在「智能问答配置>其他配置」中打开「知识库问法」和「流式输出」，并填入请求地址。如下图所示：

3.2 入参

3.3 出参

请求地址返回的流式响应中，每个流式块的结构需遵循以下规范。

{
  "choices": [
    {
      "delta": {
        "content": "回答内容片段",  // 回答内容（可为null，表示当前无内容）
        "reasoning_content": "推理过程片段"  // 推理内容（可为null，表示当前无推理）
      },
      "finish_reason": null  // 状态：null（未结束）/"stop"（结束）
    }
  ]
}

本系统兼容复杂的 OpenAPI 结构，不过当前阶段仅处理choices数组中index为 0 的对象所包含的content、reasoning_content及finish_reason三个字段：

複雜openapi結構規範

{
  "id": "chatcmpl-123",
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "delta": {
        "role": "assistant",
        "content": "Hello",
        "tool_calls": [
          {
            "id": "tool-1",
            "type": "function",
            "function": {
              "name": "getTime",
              "arguments": "{}"
            }
          }
        ]
      },
      "finish_reason": null
    },
    {
      "index": 1,
      "delta": {
        "role": "assistant",
        "content": "World"
      },
      "finish_reason": "stop"
    }
  ]
}

配置提問入口的名稱和提示內容，可在下方查看效果預覽。如下圖所示：