知识库连接概述
知识库连接用于将已有的外部知识库接入 AgentCore，使 Agent 能够检索知识库中的内容并据此回答问题。知识库中的文档和索引无需迁移到 AgentCore，仍由原知识库产品负责存储和管理。AgentCore 负责建立知识库连接，并通过模型上下文协议（Model Context Protocol，MCP）将知识库的检索工具提供给 Agent。使用知识库连接列表即可完成创建、查看和关联操作，无需先了解 MCP 的具体配置；需要查看底层服务详情、工具能力或二次开发时，前往工具管理。
什么是知识库连接
知识库连接不是在 AgentCore 内部重新创建一套知识库，而是建立 AgentCore 与已有知识库之间的访问关系。知识库连接创建后，AgentCore 会将知识库的检索能力作为工具提供给 Agent。Agent 运行时可根据任务需要调用相应工具，并使用返回的知识内容生成回答。知识库连接涉及以下对象：
对象 | 说明 |
外部知识库 | 实际保存文档、切片和索引的知识库。AgentCore 支持接入表格存储 OTS 或百炼知识库。 |
知识库连接 | AgentCore 用于访问外部知识库的资源，记录知识库类型、连接状态及必要的连接配置。 |
MCP 工具 | 工具体系视角下知识库连接的技术视图，即向 Agent 提供知识检索能力的 MCP Server，可包含一个或多个检索工具。 |
检索工具 | MCP Server 向 Agent 提供的具体能力，包括工具名称、说明和参数 Schema。 |
Agent 关联关系 | 决定哪些 Agent 可以使用该知识库连接。创建连接后，仍需前往 Agent 的关联资源选择并挂载。 |
知识库与工具管理
通过官方知识库模板创建知识库连接后，AgentCore 会生成一个 MCP 工具，以下两个视图展示的是同一份知识库资源，无需分别创建或维护：
资产管理 > 知识库（知识库连接列表）：面向知识库用户，用于创建、查看和管理知识库连接。
资产管理 > 工具管理 > 我的工具：面向工具和 MCP 管理，用于查看底层服务详情、工具能力、运行配置以及二次开发，相关操作见管理 MCP 工具。
工具管理 > 工具广场也会展示官方知识库模板，知识库连接列表同样会显示从工具广场安装的官方知识库模板。对于普通的知识库使用场景，推荐从资产管理 > 知识库入口操作；需要排查连接、查看具体工具或扩展实现时，进入工具管理继续操作。
适用场景
当业务文档已经沉淀于表格存储 OTS 知识库或百炼知识库，并希望 Agent 直接使用这些内容时，可以创建知识库连接。该方式适合继续沿用原有知识库的数据管理、权限和检索能力，同时通过 AgentCore 为 Agent 挂载并使用这些知识内容。
AgentCore 只提供连接和检索知识库的能力，不支持新增、更新或删除知识库文档。文档上传与更新、切片、向量索引、元数据以及知识库默认检索配置均由表格存储 OTS 或百炼知识库供应方管理，需前往原知识库产品的管理控制台完成维护。维护完成后，Agent 通过连接使用更新后的知识内容。
支持的知识库类型
AgentCore 当前提供两个官方知识库连接入口。业务文档已沉淀在哪个产品，就选择对应类型的知识库连接：
知识库类型 | 适用范围 |
表格存储 OTS 知识库 | 连接已有的表格存储 OTS 知识库，前置条件与配置项见在 AgentCore 中连接表格存储 OTS 知识库。 |
百炼知识库 | 连接已有的阿里云百炼知识库，前置条件与配置项见在 AgentCore 中连接百炼知识库。 |
创建和使用知识库连接
创建知识库连接前，了解以下限制：
一个知识库连接对应一个外部知识库。需要使用多个知识库时，请分别创建连接，再按需添加到 Agent。
模板托管的连接参数在创建时确定。如需切换实例、业务空间或知识库，请删除原连接并重新创建。
知识库连接目录仅收录模板托管状态的相关MCP；已转自由编辑的，请在工具目录查看与管理。
创建知识库连接
打开知识库连接列表，选择要接入的知识库类型，并根据页面提示填写知识库元数据。不同知识库类型所需的前置条件和配置项不同，请按在 AgentCore 中连接表格存储 OTS 知识库或在 AgentCore 中连接百炼知识库完成对应类型的接入。
进入目标 Workspace。
在左侧导航栏选择资产管理 > 知识库。
单击创建知识库连接。
选择表格存储 OTS或百炼知识库。
填写连接配置，如知识库标识、执行角色和可选日志配置。
单击安装并部署，等待连接状态正常。
创建完成后，知识库连接列表和工具管理 > 我的工具会同时显示该资源。
为托管 Harness Agent 关联知识库
创建知识库连接不会自动让所有 Agent 获得使用权限；将连接添加到目标 Agent 后，对应的检索能力才会作为工具提供给该 Agent。配置页面各页签的作用与更新方式见管理 Agent。
进入目标 Agent 的配置页面。
切换到Agent 资产配置的知识库页签，选择该知识库连接。
更新 Agent。
工具页签也会显示同一个连接。知识库页签是面向知识库连接MCP的筛选视图，工具页签是全部 MCP 工具的统一视图；从任一页签挂载或移除，结果都会同步。
查看检索工具和参数
知识库连接列表主要展示连接本身；完整的工具名称、工具说明和调用参数可按以下方式查看：
进入资产管理 > 工具管理 > 我的工具。
找到与知识库连接同名的 MCP 工具。
进入工具详情页。
查看工具列表中 MCP Server 提供的工具及参数。
工具列表由 AgentCore 从已经部署的服务中读取。如果工具列表为空或读取失败，请先按管理 MCP 工具中的说明检查部署状态和运行日志。
Agent 使用知识库时，AgentCore 会把工具名称、说明和参数 Schema 提供给模型。模型根据问题和 Agent 指令决定是否调用检索工具，并生成对应的工具参数。
转为自由编辑
从资产管理 > 知识库快速创建知识库连接，或从工具广场安装对应官方模板后，生成的 MCP 工具默认处于模板托管状态。在模板托管状态下，知识库连接保持与官方知识库模板及其应用版本的关联，MCP 工具的协议、端口、基础运行配置和核心连接配置由模板统一管理，用户无法修改。
转为自由编辑是单向操作，同一个 MCP 工具无法恢复为模板托管状态。需要重新使用官方模板时，请从资产管理 > 知识库重新创建一个知识库连接。
适合转换的场景
如果需要二次开发，可以将模板托管的 MCP 工具转为自由编辑。适合转为自由编辑的场景包括：
修改检索工具名称、说明或参数 Schema。
增加新的 MCP 工具。
在调用知识库前后增加自定义处理逻辑。
替换代码包，或调整 MCP 工具的运行配置。
转换前确认
转换前建议确认以下事项：
当前需求是否确实需要修改 MCP 工具的代码或运行配置。
是否已经保存自定义代码包及配置。
使用该连接的 Agent 是否能够兼容计划中的工具变更。
是否接受后续以普通 MCP 工具方式维护该资源。
执行转换
进入资产管理 > 工具管理 > 我的工具 > 工具详情，将模板托管的 MCP 工具转为自由编辑。转换后，该资源成为工具管理 > 我的工具中的普通 MCP 工具，此后按管理 MCP 工具中的普通 MCP 工具方式维护代码包和运行配置。
转换后的变化
转换完成后继续使用当前部署，原 MCP 工具的可用性、部署和网关地址保持不变，无需重新部署。
可以使用普通 MCP 工具的编辑能力修改代码包和运行配置；发生需要重新部署的修改时，AgentCore 会发布新的部署版本。
连接配置改为通过普通 MCP 工具的编辑能力维护。
如果转换后修改了工具名称、工具说明或参数 Schema，请重新进入工具详情页检查工具列表，并重新发布或启动相关 Agent，使其使用最新工具定义。