火山引擎联网问答Agent创建方法(参数配置)

要创建成功，必须填写基础信息、能力配置、接入设置这三类参数；需选择通用Pro版（Lite版不支持关键能力，且无法升级）；基础信息包括名称、简介、开场白、开场问题；能力配置涵盖联网搜索（需配额）和知识库绑定（仅限已发布）；API接入需要HTTPS回调地址、一次性签名密钥以及API Key权限。

要在火山引擎控制台创建一个可对外服务的联网问答Agent，必须完成基础信息、能力配置、接入设置三类参数的准确填写，任何一项留空或格式错误都会导致创建失败无法提交。

进入创建流程并选择版本

登录火山引擎控制台 → 在左侧导航栏找到「联网问答Agent」模块 → 点击进入 → 在产品列表页明确选择【通用Pro版】（Lite版不支持自定义开场白、热点问题API调用等关键能力）→ 点击【创建】按钮。

这一步不能跳过版本选择，

填写基础信息

在智能体配置页面的「基本信息」区域，依次填写：

名称：输入不超过64个字符的中文或英文名称，例如“客服小助手-生产环境”；

简介：简要说明该Agent用途，限200字以内，将直接用于前端展示或内部管理检索；

开场白：用户首次打开对话窗口时自动显示的文字，支持纯文本或含简单HTML标签（如加粗），留空则不显示；

开场问题：最多填写5个引导性问题，每条不超过100字符，用换行分隔，例如：
“今天有什么新政策？”
“如何查询账户余额？”
“能帮我解读这份合同条款吗？”

配置联网与知识能力

方法一：开启联网搜索（需开通相应配额）
勾选「开启联网搜索」→在弹出框中确认已开通「联网问答Agent-Pro版」配额，若未开通，点击跳转至配额中心申请runtime/agent_plan_internet_access配额→提交后等待审批通过（一般2小时内）。

方法二：绑定知识库（需提前在「企业知识引擎」中创建完成）
点击「添加知识库」→ 从下拉列表中选择已发布的知识库（仅显示状态为「已发布」的知识库）→ 可多选 → 每个知识库右侧可单独开关「启用检索」开关。

注意：知识库若处于「草稿」或「审核中」状态，不会出现在此下拉列表里，也无法绑定。

设置API接入参数

第一步：展开「API接入」配置区 → 勾选「启用API调用」；

第二步：填写回调地址（Webhook URL）→ 必须是HTTPS协议、可公网访问、响应超时≤10秒的有效地址；

第三步：配置签名密钥 → 点击「生成新密钥」→ 系统自动生成32位十六进制字符串 →

第四步：选择认证方式 → 推荐使用「API Key接入」→ 此时需确保当前账号已开通「TorchlightApiFullAccess」策略权限，否则后续调用GetBotMeta等接口会返回 invalid_api_key 错误。