j9九游会登录/ 智果（agentarts）智能体平台/ 低代码开发/ / / / 连接koosearch知识库
更新时间：2026-07-15 gmt 08:00

连接koosearch知识库-j9九游会登录

为什么要连接外部知识库？

当企业已在koosearch等平台构建了成熟的知识库，通过外部知识库连接可直接复用现有数据，无需重复上传，同时可利用koosearch的联网增强能力获取公域知识。

agentarts支持连接外部知识库平台，以便用户访问和利用外部的知识资源。

koosearch可以帮助企业搭建企业级rag，提升用户获取企业私有知识的效率，同时提供联网增强功能，提供互联网公域知识问答能力。主要用于智能客服应用、数字人、数字员工、ai助手、ai搜索等知识问答场景。

本文将介绍如何在agentarts对接第三方koosearch知识库。

图1 连接koosearch知识库流程

费用说明

通过agentarts调用koosearch知识库会消耗koosearch的api调用次数及流量，请关注koosearch服务的资源使用情况。

约束与限制

删除外部知识库连接前，请确认无智能体正在使用该连接下的知识库，否则将导致智能体问答失败。

当资源数量达到上限时，请删除不再使用的资源以释放配额：

  • 第三方知识库连接：进入 “第三方知识库连接” 页面进行删除。具体操作请参考管理知识库中的“删除外部知识库连接信息”。删除后，基于该连接接入的知识库将不可用。
  • 第三方知识库：进入 “知识库” 页面进行删除。具体操作请参考管理知识库中的“取消接入”。

关于知识库的更多约束与限制，请参考知识库使用限制。

步骤一：准备工作

获取第三方koosearch知识库的连接信息：
  1. 确保需要连接的第三方koosearch知识库平台已经开通了华为云koosearch服务，并购买了相关资费套餐。第三方koosearch的拥有者需要发布搜索知识库和获取知识库列表的两个api接口供后续使用者在agentarts平台调用。发布api接口请参考通过api使用koosearch实现搜索问答。
  2. 在koosearch中创建一个知识库，并上传相关文档。
    图2 koosearch中的知识库
  3. 获取koosearch服务地址：可以参考koosearch接口获取获取apig公网地址，也可以参考以下步骤：
    1. 登录koosearch绑定的apig服务，在“apig接口 > 实例管理”中单击实例名称。
      图3 实例名称
    2. 在“实例信息”页签中找到并复制“弹性ip地址”，该弹性ip地址就是koosearch的服务地址。
      图4 弹性ip地址
  4. 获取项目id请参考获取koosearch服务的项目id。
  5. 获取应用id请参考获取koosearch服务的应用id。
  6. 获取apig凭证请参考获取koosearch服务的apig凭证的app认证部分。
  7. 获取koosearch知识库详情页面链接。
    1. 登录koosearchj9九游会登录主页，单击需要接入的知识库，进入koosearch知识库详情页面。
      图5 koosearch知识库列表
    2. 复制浏览器地址栏中的链接，该链接就是koosearch知识库详情页面的链接。
      图6 知识库详情页面链接

步骤二：连接koosearch第三方知识库

  1. 登录。
  2. 在左侧导航栏中选择“开发中心 > 组件库”，选择“知识库”页签。
  3. 在“知识库”页面，单击“第三方知识库连接”。
  4. 在“第三方知识库连接”界面，单击“新建知识库连接”。
  5. 在“创建知识库连接”页面，设置连接koosearch知识库基本信息，参数配置请参考表1。
    图7 连接外部知识库
    表1 参数说明

    参数

    说明

    示例

    基本信息

    选择类型
    • general：用于对接用户自研知识库平台，需自行实现检索接口。
    • koosearch：用于对接华为云企业搜索服务，开箱即用koosearch。
    • ragflow：用于对接开源项目ragflow，快速对接复用。

    koosearch

    知识库名称

    用于标识知识库。

    由1~50个字符组成，包含中文、字母、数字、中划线、下划线，且必须以中文、字母、数字开头。

    koosearch

    描述（可选）

    用于简要说明知识库内容和用途。它提供了关于知识库的详细信息，帮助用户了解知识库的内容和使用场景。

    由0~255个字符组成。

    koosearch知识库

    图标

    系统默认知识库图标，可单击自动生成图标，也可以自定义图标。

    1. 鼠标移动至图标上，单击鼠标左键。
    2. 上传已准备好的知识库图标。

      支持jpg、jpeg、png、gif格式图片，且不大于200kb。

    默认

    连接信息

    服务地址

    能够访问检索接口及查询列表接口的地址，以https://或http://开头。

    https://xxx.com

    项目id

    登录koosearch知识库平台账号的项目id。

    0503dda8970xxxxxx

    应用id

    koosearch知识库平台的应用id。

    9ae90c5e53xxxxxx

    apig凭证

    koosearch平台接口绑定的apig凭证的appcode，用于认证鉴权。

    注意：

    请妥善保管apig凭证，避免泄露。建议定期更换凭证以确保安全。

    关于密钥加密：鼠标移动至“apig凭证”右侧的上，可查看密钥的加密方式。平台默认使用kms加密 默认密钥方式对认证密钥进行加密存储，防止信息泄露。
    • 加密机制：使用用户选择的密钥派生dek进行加密，默认密钥为kms-agentarts/default。
    • 费用说明：实例不收费，每月提供20,000次免费调用额度。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考更换密钥的加密方式。超出后按实际调用次数计费，详见。

    b099xxxxxxxx

    知识库详情页面链接

    第三方koosearch知识库详情页面的链接，可通过该页面直接访问koosearch知识库的详情页面。

    注意需要使用占位符{{id}}表示知识库id，否则无法跳转到对应的知识库页面。

    https://xxxxx.com/xxxx?id={{id}}
  6. 单击“测试连接”，弹出“测试成功”提示。

    如果显示“第三方知识库连接失败，请检查连接地址和认证信息”，请检查koosearch服务是否支持在公网使用api访问。

  7. 测试成功后，单击“确定”。

    页面返回第三方知识库连接列表，连接创建成功后“状态”为“已停用”，完成步骤三：创建general第三方知识库后“状态”变为“已启用”。

步骤三：创建koosearch第三方知识库

agentarts通过连接外部知识库，可以显著扩展知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。

已完成步骤二：连接koosearch第三方知识库。

  1. 登录。
  2. 在左侧导航栏中选择“开发中心 > 组件库”，选择“知识库”页签。
  3. 在“知识库”页面，单击“创建知识库 > 接入第三方知识库”。
    • 创建平台知识库：适用于数据在agentarts平台直接管理的场景，支持上传文档和faq。具体操作请参考。
    • 接入第三方知识库：适用于企业已有现成知识库（如ragflow），希望直接对接复用的场景。
  4. 在“接入第三方知识库”界面中，选择已接入的知识库，在右侧勾选知识库。

    如果列表中没有需要的第三方知识库，则可以单击“新建”，新建知识库连接，具体配置请参考表1。

    图8 接入第三方知识库
  5. 单击“确定”，第三方知识库创建完成。

    创建完成的知识库，显示在知识库列表，“类型”为“koosearch”，“状态”为“已启用”。

相关操作

在“第三方知识库连接”页面，支持的其他操作请参考表2。

表2 相关操作

操作

说明

编辑第三方知识库连接信息

在对应的“操作”列下，单击“编辑”，可以编辑外部知识库连接信息。

如遇连接失败，请参考的常见问题。

删除第三方知识库连接信息
注意：

需要先取消接入后，才可以删除。

在对应的“操作”列下，单击“删除”，可以删除外部知识库连接信息。

常见问题

相关文档

  • 连接外部知识库后，请参考知识库命中测试校验知识库是否可用。
  • 连接外部知识库后，可以对外部知识库进行管理，具体请参考管理知识库。
父主题：

相关文档

网站地图