15分钟内可跑通火山引擎ai大模型demo：开通服务并实名认证后获取agent plan密钥，通过一键脚本或docker启动本地服务，再将业务数据放入/data目录、修改config.yaml配置file_search工具路径并重启，即可实现对话、推理与工具调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在15分钟内跑通一个能对话、能推理、能调工具的火山引擎AI大模型Demo，不需要写一行训练代码，也不用配GPU驱动——只要会点开网页、粘贴密钥、敲几条命令就行。
开通服务并获取API密钥
打开火山引擎控制台（https://console.volcengine.com），登录账号后进入「大模型服务平台」→「Model Studio」。首次使用需完成企业实名认证，个人开发者可选「个体工商户」快速提交材料，审核通常2小时内完成。
认证通过后，在「API密钥管理」页面点击「创建密钥」，选择「Agent Plan」套餐（支持Hermes Agent接入与多模型切换），生成Access Key ID和Secret Access Key。这两串字符必须立刻复制保存，【页面关闭后无法再次查看，且重置将导致所有已配置服务中断】。
本地启动预置Demo环境
方法一：使用官方一键脚本（推荐）
在Mac或Linux终端中执行：
curl -fsSL https://model.volcengine.com/demo/install.sh | bash
脚本会自动检测Python 3.9+环境、安装vLLM依赖、拉取QwQ-32B量化版模型缓存，并启动Flask本地服务。Windows用户请改用WSL2子系统运行该命令。
方法二：Docker快速容器化
确保已安装Docker Desktop，执行：
docker run -d --gpus all -p 8000:8000 -e VOLC_ACCESS_KEY=你的AccessKeyID -e VOLC_SECRET_KEY=你的SecretAccessKey volcengine/agent-demo:latest
容器启动后，访问 http://localhost:8000 即可见交互式Web界面，支持文本输入、历史回溯、模型切换下拉菜单。
对接真实业务逻辑
第一步：准备你的业务数据文件
把Excel格式的客服FAQ表、产品参数CSV、或内部知识库Markdown文档，放到项目根目录下的/data目录中。文件名不要含中文或空格，例如faq_v2.csv。
第二步：修改配置文件
编辑config.yaml，找到tools字段，将type: "file_search"下的path值改为./data/faq_v2.csv。这一步让模型具备“查表能力”，用户问“退换货流程”，它会自动检索CSV中对应行并组织回答。
第三步：重启服务验证
若用脚本部署，执行pkill -f demo_server.py && bash ~/volc-demo/start.sh；若用Docker，执行docker restart $(docker ps -q --filter ancestor=volcengine/agent-demo)。等待日志出现“Tool registry loaded: file_search”即表示对接成功。
