智能体未进房或未正常工作？--实时音视频-火山引擎

文档中心

立即注册

导航

实时音视频

智能体未进房或未正常工作？

最近更新时间：2025.05.15 10:26:17首次发布时间：2025.05.15 10:26:17

问题描述

如果调用智能体接口 HTTP 返回 200，但是智能体未进入房间或进入房间未正常工作。

问题排查

你可以参考以下步骤排查：

步骤1：定位问题类型

进入实时对话式 AI Web 体验 Demo进行 AI 对话：

如果无法和智能体进行正常对话，则证明是设备问题，请跳转至步骤 2 检查音频输入设备。
如果可以和智能体进行正常对话，则证明是智能体接口设置问题，请跳转至步骤 3 检查智能体参数设置。

步骤2：检查音频输入设备

如果是 Web 端，请参看 Web 排查无声问题。
如果是移动端，请参看 Native 排查无声问题。

步骤3：检查智能体参数设置

请确保已开通 ASR、TTS、LLM 中你需要的服务并获取对应的参数值.

注意

若 ASR、TTS 或 LLM 使用火山引擎服务，请检查是否在使用免费版。如在使用免费版请前往控制台确认免费版额度是否用完。如已开通正式版，请确认是否购买资源包。

服务名称		需获取参数
ASR	火山引擎流式语音识别	AppId：开通火山引擎流式语音识别服务后获取的 App ID，用于标识应用。你可登录语音技术控制台获取。 Cluster：开通的流式语音识别服务对应的集群标识（Cluster ID）。你可登录语音技术控制台开通服务后获取。
ASR	火山引擎流式语音识别大模型	AppId：开通火山引擎流式语音识别大模型服务后获取的 App ID，用于标识应用。你可登录语音技术控制台获取。 AccessToken：与开通流式语音识别大模型服务 App ID 对应的 AccessToken，用于身份认证。你可登录语音技术控制台获取。
TTS	火山引擎语音合成	appid：开通火山引擎语音合成服务后获取的 App ID，用于标识应用。你可登录语音技术控制台获取。 cluster：开通的语音合成服务对应的集群标识（Cluster ID）。你可登录语音技术控制台开通服务后获取。 voice_type：已开通音色对应的音色种类（Voice_type）。你可登录语音技术控制台购买音色后获取。
	火山引擎语音合成
	火山引擎语音合成大模型流式输入流式输出	appid：开通火山引擎语音合成大模型服务后获取的 App ID，用于标识应用。你可登录语音技术控制台获取。 token：与开通流式语音识别大模型服务 App ID 对应的 AccessToken，用于身份认证。你可登录语音技术控制台获取。 voice_type：已开通音色对应的音色种类（Voice_type）。你可登录语音技术控制台购买音色后获取。
	火山引擎声音复刻大模型非流式输入流式输出	appid：开通火山引擎声音复刻大模型服务后获取的 App ID，用于标识应用。你可登录语音技术控制台获取。 cluster：开通的声音复刻大模型服务对应的集群标识（Cluster ID）。你可登录语音技术控制台开通服务后获取。 voice_type：声音复刻声音 ID。你可登录语音技术控制台获取。
	火山引擎声音复刻大模型流式输入流式输出	appid：开通火山引擎声音复刻大模型服务后获取的 App ID，用于标识应用。你可登录语音技术控制台获取。 cluster：开通的声音复刻大模型服务对应的集群标识（Cluster ID）。你可登录语音技术控制台开通服务后获取。 voice_type：声音复刻声音 ID。你可登录语音技术控制台获取。
	MiniMax	Authorization：API 密钥。前往 Minimax 账户管理-接口密钥获取。 Groupid：用户所属组 ID。前往 Minimax 账号信息-基本信息获取。
LLM	火山方舟平台	自定推理点 EndPointID 或智能体应用 ID。前往火山方舟控制台获取。
	Coze 平台	BotId：Coze 智能体 ID。可前往你需要调用的智能体开发页面获取。开发页面 URL 中 bot 参数后的数字即智能体ID。例如开发页面 URL 为：`https://www.coze.cn/space/341/bot/73428668`，则 `BotId` 为 `73428668`。 APIKey：Coze 访问密钥。你可以生成++个人访问令牌++以供测试。线上环境注意替换为 OAuth 访问密钥。你可根据不同的使用场景，选择不同的 OAuth 授权方式，详情参考OAuth 应用管理。
	第三方大模型	URL：第三方大模型 URL。

请确保是否开启跨服务授权。
前往跨服务授权查看是否已开通跨服务授权。若显示未开通可按照提示一键开通。
检查 StartVoiceChat 接口请求参数是否填写正确。

所有必填参数是否填写。
RoomId、TaskId、TargetUserId、UserId 是否按照参数赋值规范填写，不得出现中文字符。
RoomId 是否与房间内客户端 SDK 进房时的使用的 RoomId 保持一致
TargetUserId 是否与房间内客户端 SDK 进房时使用的 UserId 保持一致。

若按照以上步骤排查后智能体依然无法正常工作，请联系技术支持提供 OpenAPI 接口请求的 RequestId 进行排查。