必须完成账号认证、API密钥获取、服务开通和参数配置四步闭环，缺一不可：先注册火山引擎账号并完成实名认证（个人传身份证、企业需营业执照及打款验证），再在控制台创建AccessKey获取AK/SK、新建Agent获取Bot ID，接着启用联网搜索并严格配置FunctionName为webSearch、FunctionDescription描述时效场景、ComfortWords设置提示语、DisableImageSearch按需设false，最后通过Responses API或插件模板调用验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在自己的应用中接入火山引擎的联网搜索能力，必须完成账号认证、API密钥获取、服务开通和参数配置四步闭环，缺一不可，否则调用会直接返回401或500错误。
注册并实名认证火山引擎账号
访问火山引擎官网，点击右上角「立即注册」，支持手机号或邮箱注册；注册后【必须完成实名认证】，个人用户上传身份证正反面，企业用户需提供营业执照及对公账户打款验证——未实名的账号无法创建Bot ID，后续所有配置都将卡在第一步。
登录后进入「账号管理→实名认证」页面，按提示提交材料，通常10分钟内审核通过。
获取API Key与Bot ID
进入火山引擎控制台→「访问控制→访问密钥」，点击「创建AccessKey」，系统自动生成AK（Access Key ID）和SK（Secret Access Key），请立即下载保存——SK仅显示一次，丢失后只能删除重置。
前往「智能分析Agent→新建Agent」，填写名称、描述后保存，页面将生成唯一的Bot ID；该ID必须与后续API调用中的bot_id严格一致，大小写敏感，复制时注意不要带空格。
开通联网搜索服务并配置参数
在Agent详情页找到「联网搜索」开关，点击启用；此时会弹出参数配置面板。
按以下要求填写核心字段：
FunctionName：固定填webSearch，不可修改或加空格；
FunctionDescription：用自然语言描述触发场景，例如“查询实时天气、突发新闻、股票行情等时效性信息”，这句话将作为大模型判断是否发起搜索的依据；
ComfortWords：用户等待时显示的提示语，建议设为“正在为您联网检索最新信息，请稍候…”；
DisableImageSearch：如需支持图片搜索，必须设为false，否则图搜功能完全不可用。
调用API完成集成
方法一：通过Responses API直连
向火山引擎提供的API endpoint发送POST请求，Header中携带Authorization: Bearer {your_api_key}，Body中传入含Config对象的JSON，其中ParamsString需URL编码，且必须包含bot_id和stream:true；
方法二：在Cherry-Studio中部署
导入官方提供的Web Search插件模板，将AK、SK、Bot ID填入环境变量，启动服务后，在函数日志中确认出现webSearch triggered即表示接入成功；
测试时输入“今天北京气温多少度”，若返回结构化天气数据而非“我不知道”，说明联网搜索已生效。
