You need to enable JavaScript to run this app.
文档中心
数据智能体 DataAgent(私有化)

数据智能体 DataAgent(私有化)

复制全文
下载 pdf
最佳实践
基于 API 接入知识库检索能力
复制全文
下载 pdf
基于 API 接入知识库检索能力

本文以金融知识库为例,介绍如何基于大模型核心能力,通过企业知识引擎构建智能检索工具,实现知识导入与智能应答功能。

步骤一:创建知识库
  1. 登录营销 Agent 控制台,在左侧导航栏选择企业知识引擎

  2. 在企业知识引擎左侧导航栏,选择知识管理 > 知识库

  3. 新增知识库。填写基础配置信息,完成后单击保存,完成新的知识库的创建。
    Image
    具体参数配置说明如下表格:

    参数

    参数说明

    示例

    名称

    知识库名称

    XX银行智能助手知识库演示

    描述

    简要描述企业知识引擎的用途或包含的内容(限制200字以内)

    XX银行智能助手

    内容类型

    选择知识库类型,目前支持以下五种类型:

    • 通用内容:支持上传文件、从微信素材库导入、从对象存储导入、从关系型数据库导入。
    • Query缓存:支持xlsx、csv等格式文件。
    • QA问答:支持xlsx、csv等格式文件。
    • 术语:支持xlsx、csv等格式文件。
    • 客户数据:用于创建主体知识库,支持上传VeCDP中已有的主体数据。

    通用内容

  4. 点击新建好的知识库,进入知识库详情页面。在知识管理页面单击导入知识
    Image

  5. 选择通用文档导入方式。
    Image

  6. 设置文件保存路径,并上传文件作为知识库内容。然后单击下一步
    上传的文件可包括:支行网点信息、理财风险揭示书和产品说明书、理财协议文件、产品销售文件、产品附加说明。
    Image

  7. 配置知识分段方式,选择自动分段方式、其他配置保持默认项,然后单击完成
    具体参数详情请参见导入知识
    Image
    导入成功后,所有文件内容会自动分段,待解析完成后在知识管理页面查看。
    Image
    点击知识名称,可进入知识详情页查看分段详情。
    Image

步骤二:创建检索应用
  1. 在企业知识引擎左侧导航栏选择检索应用,并新建应用。
    Image

  2. 自定义设置检索应用的名称与描述,并单击保存
    例如:

    • 名称:XX银行理财小助手
    • 描述:XX智能问答应用
  3. 在应用编排页面左侧,设置检索参数。
    Image

    参数

    参数说明与示例值

    基础信息

    • 名称:XX银行理财小助手
    • 描述:XX智能问答应用

    引用知识

    添加知识库,选择上一步创建的银行知识库。

    向量检索权重

    调节关键词匹配与语义理解的比重:值越低越注重精确词句命中,值越高越注重整体语义相关性。
    示例值:0.5

    混合相似度阈值

    综合语义匹配和关键词匹配的相关性得分下限。仅当候选文档的混合相似度 ≥ 该阈值时才会被召回。数值越高,召回结果越精准但数量越少;数值越低,召回范围越广但可能引入噪声。
    示例值:0.2

    排序策略

    • 语义模型排序:使用专用的语义排序模型,对初筛分片按相关性重新打分排序。速度快、成本低,适用于大多数场景。
    • 大模型排序:调用大语言模型逐条评估分片与问题的匹配度,排序质量更高,但速度稍慢。适用于对回答质量有较为高要求的场景。

    示例值:语义模型排序

    初筛分片数

    从知识库中检索并返回的候选分片数量。数值越大,召回的信息覆盖面越广,但会增加处理时间。该数值应 ≥ 精选分片数。
    示例值:30

    排序分数阈值

    当设置阈值后,仅保留分数 ≥ 该阈值的召回分片,低于阈值的结果将被直接过滤,不参与最终展示。阈值越高结果越精确,但召回数量可能减少;阈值越低结果越丰富,但可能混入相关性较弱内容。
    示例值:0.5

    召回分段数

    经过重排序后,最终在检索列表展示和送入大模型的分片数量。数值越大,模型获得的参考信息越多,但可能引入噪声。
    示例值:5

    开启智能检索

    开启后,系统将通过大模型对召回关键词进行语义改写,以提升检索效果。返回结果中,第一条为大模型基于召回内容生成的总结摘要,其余为匹配到的相关文档分段。注意:开启该功能后,检索耗时将有所增加。
    示例值:开启

  4. 在应用编排页面右侧,输入关键词调试应用,验收应用效果,并基于效果重新调整参数配置。
    Image

  5. 完成所有配置后,在页面右上角单击发布。

步骤三:为应用申请 API
  1. 在企业知识引擎左侧导航栏选择检索应用
  2. 在检索应用列表,找到上一步创建的检索应用,在操作列单击申请 API
    Image
  3. 跳转至开放平台应用管理页面,在页面右侧单击新建应用
    Image
  4. 新建应用页面,完成以下配置,并单击保存
    Image
    参数说明:
    • 应用名称:自定义名称,例如调用检索应用
    • 应用可使用的 API:选择企业知识引擎 > 调用检索应用
    • 访问可授权项目:选择指定项目。
    • 关联用户:选择当前登录用户即可。
  5. 在应用管理列表中,查看已创建的应用,并复制应用 Token
    Image

步骤四:通过 API 接入检索应用

在企业知识引擎控制台左侧导航栏,进入开放平台 > 开放能力页面,参考平台提供的 OpenAPI 接入流程检索应用调用 API,将检索应用接入到您的业务系统中。API 文档说明请参见检索应用调用
Image
以三方平台(如 Postman)为例,调用检索应用调用 API 获取检索结果的示例如下图所示。
Image

最近更新时间:2026.06.12 16:05:00
这个页面对您有帮助吗?
有用
有用
无用
无用