火山引擎AgentKit快速搭建轻量业务智能体示例

一天内可将业务资料转为轻量智能体，无需写代码、搭服务或配向量库；只需准备UTF-8编码的纯文本知识文件，用AgentKit CLI初始化、挂载、调试并一键部署至云端。

想在一天内把客服FAQ、产品手册或销售话术变成可调用的轻量业务智能体，不用写模型代码、不搭推理服务、不配向量库也能上线运行。

准备业务知识素材

请将业务资料整理为纯文本格式，例如客服常见问题解答（FAQ）、产品功能说明文档或销售SOP流程。文件必须是UTF-8编码的.txt格式，单个文件大小不得超过5MB。若资料中包含图片、表格或PDF扫描件，请先使用OCR工具提取文字，并进行人工校对——

将文件命名为中文无空格名称，例如“售后政策202608.txt”，放入本地新建的knowledge/文件夹中。

用AgentKit CLI初始化项目

打开终端，执行以下命令：

agentkit init --template basic-kb-agent --name sales-assistant

该命令会自动创建sales-assistant目录，生成标准agentkit.yaml、requirements.txt和main.py骨架。模板已预置知识库检索组件与基础对话流，无需手动接入向量引擎。

进入项目目录：cd sales-assistant

挂载本地知识文件

方法一：修改agentkit.yaml配置

用编辑器打开agentkit.yaml，在knowledge节点下添加本地路径：

knowledge:

type: local

path: ../knowledge/售后政策202608.txt

方法二：启动时动态指定（适合调试阶段）

执行：agentkit launch --knowledge-path ../knowledge/售后政策202608.txt

注意：CLI会自动检测文件编码并切分chunk，但若文件含大量代码块或特殊符号，建议先用vscode开启“显示不可见字符”功能检查换行符是否为LF。

本地调试验证问答效果

第一步：运行调试服务

agentkit launch

第二步：访问http://localhost:8000/debug，页面自动加载交互式测试面板。

第三步：输入测试问题，例如“7天无理由退货怎么操作？”，观察返回内容是否准确引用知识文件中的条款编号与条件描述。若出现答非所问的情况，立即检查知识文件中对应段落是否存在关键词缺失或语义断层——

第四步：按Ctrl+C终止服务。

一键发布到云端运行时

确保已登录火山引擎账号并完成AgentKit服务开通。执行：

agentkit deploy --region cn-north-1

命令触发云端构建流程：自动打包代码+知识文件→上传至镜像仓库→创建运行时实例→生成公网调用地址。全程无需Dockerfile或Kubernetes配置。

部署成功后，终端输出类似https://sales-assistant-xxxxx.agentkit.volces.com的HTTPS接口地址。