一天内可将业务资料转为轻量智能体，无需写代码、搭服务或配向量库；只需准备UTF-8编码的纯文本知识文件，用AgentKit CLI初始化、挂载、调试并一键部署至云端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在一天内把客服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天无理由退货怎么操作？”，观察返回内容是否准确引用知识文件中的条款编号与条件描述。若出现答非所问，立即检查知识文件中对应段落是否存在关键词缺失或语义断层——【知识片段过长（＞800字）会导致关键信息被截断丢失】。
第四步：按Ctrl+C终止服务。
一键发布到云端运行时
确保已登录火山引擎账号并完成AgentKit服务开通。执行：
agentkit deploy --region cn-north-1
命令触发云端构建流程：自动打包代码+知识文件→上传至镜像仓库→创建运行时实例→生成公网调用地址。全程无需Dockerfile或Kubernetes配置。
部署成功后，终端输出类似https://sales-assistant-xxxxx.agentkit.volces.com的HTTPS接口地址。
