火山引擎AgentKit接入知识库构建业务智能体

需依次完成知识库创建、注册与运行时绑定：先在AgentKit控制台创建新的知识库，上传文件并配置切分；接着在Skills中心将其注册为Skill，并指定不可修改的版本号；最后通过控制台或CLI在运行时绑定该Skill，重启实例后才能生效。

要在火山引擎AgentKit中接入知识库并构建可上线的业务智能体，必须先完成知识库创建、注册与运行时绑定三个不可跳过的环节，缺一不可，否则智能体调用时会因找不到知识源而返回空响应。

创建AgentKit专属知识库

登录AgentKit控制台→在左侧导航栏选择「知识库」→单击「新建知识库」。

填写知识库名称（如“客服FAQ知识库”），选择地域（必须与后续运行时部署地域一致，

上传知识文件：支持PDF、TXT、MD、DOCX格式，单次最多上传20个文件，总大小不超过500MB；若文件含表格或代码块，请确保格式未被破坏，否则切片后向量化效果会严重下降。

配置切分参数：保持默认“自动切分”即可；如文档结构高度规整（如每章以“第X节”开头），可选“按标题切分”，提升语义连贯性。

注册知识库为Skill供智能体调用

知识库创建成功后，系统自动生成一个同名Skill，但该Skill默认处于“未注册”状态，无法被智能体发现。

进入「Skills中心」→「Skills空间」→找到刚创建的知识库Skill→点击右侧「注册」按钮。

注册时需指定Skill版本号（如v1.0），版本号一旦设定不可修改；若后续更新知识文件，必须新建版本并重新注册，旧版本仍可被历史运行时调用。

注册完成后，Skill状态变为“已启用”，此时才具备被智能体绑定的资格。

在运行时中绑定并启用知识库Skill

方法一：通过控制台创建运行时并绑定

进入「智能体运行时」→「创建智能体」→在「高级配置」区域展开「知识库」选项卡→点击「添加知识库Skill」→从下拉列表中勾选已注册的Skill（如“客服FAQ知识库-v1.0”）→开启「启用语义检索」开关。

方法二：使用CLI工具快速绑定（推荐用于迭代开发）

在本地项目根目录执行以下操作：首先，输入代码 agentkit config set runtime.knowledge_skills='["客服FAQ知识库-v1.0"]'；接着，运行 agentkit deploy 命令，这样就能将配置同步至云端运行时。

注意：若运行时已存在且正在服务中，绑定新Skill后需手动触发「重启实例」，否则变更不生效；重启过程约30秒，期间请求会短暂失败。

验证是否生效：部署完成后，在「运行时详情页」→「调试」标签页输入测试问题（如“退货流程是什么？”），观察响应中是否包含知识库原文片段及引用标记[1]。