bot_unavailable_error 表示 bot 实例不可用，需检查发布状态、联网插件配置（api key、模型服务）、服务实例运行状态（监控或健康接口）、账号权限及项目绑定关系。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎联网问答接口返回 bot_unavailable_error 错误时，说明当前 Bot 实例未处于可用状态，无法响应请求，常见于 Bot 未发布、已下线、配置异常或服务未启用等场景，需逐项验证并修正状态。
确认 Bot 是否已成功发布
登录火山引擎控制台 → 进入「智能对话（VolcBot）」→ 左侧导航选择「Bot 管理」→ 找到目标 Bot，查看「状态」列是否为「已发布」。
若显示「草稿中」或「已下线」，点击操作栏「发布」按钮提交；发布前系统会自动校验意图、FAQ 和联网插件配置，任一模块缺失或存在语法错误都会导致发布失败，此时需返回对应模块修复后再试。
检查联网问答插件是否启用并配置正确
在 Bot 编辑页 → 点击左侧「插件中心」→ 找到「联网问答」插件 → 确认开关已开启（蓝色）。
点击「配置」进入设置页：确保「API Key」已填写且为当前项目下有效的 VolcEngine AccessKey Secret（注意不是 AK），同时「模型服务」下拉框已选择已开通权限的推理服务（如 Qwen2.5-7B-Instruct-HTTP）。
若使用自定义 API 地址，请确认域名可公网访问、HTTPS 证书有效、响应格式符合 VolcBot 要求（含 answer 字段），否则调用时将静默触发 bot_unavailable_error。
验证 Bot 对应的服务实例运行状态
方法一：通过控制台服务监控确认
进入「Bot 管理」→ 点击目标 Bot 右侧「更多」→「服务监控」→ 查看「实例状态」是否为「运行中」；若为「异常」或「未启动」，点击「重启实例」等待 1–2 分钟。
方法二：调用健康检查接口手动验证
向 Bot 的 endpoint 发起 GET 请求：https://[your-bot-id].bot.volces.com/health，返回 {"status":"healthy"} 表示服务层正常；若返回 404 或超时，说明实例未就绪或路由未生效。
注意：新发布 Bot 首次启动需约 90 秒冷启动时间，期间所有请求均报 bot_unavailable_error，不可重试过快。
排查账号与项目权限绑定关系
进入火山引擎「访问控制（IAM）」→「用户管理」→ 找到当前操作账号 → 点击「授权策略」→ 确认已附加 VolcBotFullAccess 或至少包含 volcbot:InvokeBot、volcbot:GetBot 权限的自定义策略。
同时检查该账号是否已加入 Bot 所属项目：在「项目管理」→「成员管理」中搜索账号，角色必须为「项目管理员」或拥有「VolcBot 操作权限」的自定义角色。
