---
title: 语音不可用
summary: 麦克风控件缺失或被禁用：每种具体原因的含义以及如何解决。
date: 2026-09-09
---

# 语音不可用

麦克风控件缺失或被禁用：每种具体原因的含义以及如何解决。

语音会以几种具体的、可区分的方式失败。界面会指出具体适用哪一种，而不只是显示一个被禁用的按钮，因此在假设整个功能都坏了之前，请先查看确切的提示信息。

## 未配置传输层

如果此安装上还没有人连接 LiveKit 项目，语音功能对每一个组织都不可用，而不仅仅是你的组织。这是**设置 → 语音**下的一个安装范围设置。请让管理你安装的人完成此配置。参见[语音设置](/zh/docs/guides/voice-guide)。

## 传输层已禁用

存在一个 LiveKit 连接，但已被关闭。这与“从未配置”不同：凭证被保留，只是没有生效。从同一个设置页面重新启用它，而不必重新输入连接详情。

## 传输层未验证

该连接要么从未被测试过，要么上次测试失败了。在依赖它之前，先在**设置 → 语音**中运行**测试连接**。

## 没有转录提供商

传输层可能完全正常，只是你的组织根本没有连接任何活跃的语音转文字供应商。这是最常见的按组织出现的原因，区别于上面提到的安装范围传输层设置：即使另一位管理员已经为整个安装配置了 LiveKit，仍需要有管理员为转录角色连接 Deepgram 或 ElevenLabs。

## 麦克风能用，但智能体从不出声回复

如果只配置了转录而没有启用文本转语音提供商，这是预期行为。仅语音输入是一种受支持的模式，而不是 bug。如果你也想要语音回复，请连接一个文本转语音提供商。

## 相关内容

- [语音设置](/zh/docs/guides/voice-guide)：连接传输层和语音提供商
- [语音](/zh/docs/features/voice)：这些各个部分分别做什么