음성 대화로 멤버가 봇과 소리 내어 이야기할 수 있어요. 봇이 음성 채널에 들어와서 듣고, 음성으로 대답해요. AI Response와 같은 모델, 설정(lore), 메모리를 사용합니다.
실험적 기능. 이 기능은 새로 나온 것이라 아직 자리를 잡는 중이에요. 거친 부분이 있을 수 있으니, 발견한 점을 알려 주세요.
🎙️ 사용 방법
봇은 음성 채널에 들어가 들은 내용을 텍스트로 옮기고, 텍스트 메시지와 똑같이 AI Response로 보낸 뒤, 답변을 텍스트 음성 변환(TTS)으로 말해요. 듣기 시작하기 전에 항상 텍스트 채널에 안내를 게시하고, 그 안내를 쓸 수 있는 채널이 없으면 절대 듣지 않아요.
봇이 들어오는 방법은 두 가지이고, 봇이 참여하는 방식으로 설정해요.
🙋 요청 시
멤버가 /voice-chat start로 자기 음성 채널에 봇을 초대하고, /voice-chat stop으로 내보내요.
| 설정 | 기능 |
|---|---|
| 대화당 시간(분) | 이 시간에 도달하거나 채널에 혼자 1분 남게 되면 봇이 나가요. |
| 초대할 수 있는 역할 | 누가 대화를 시작할 수 있는지 제한해요. 비워 두면 모두가 초대할 수 있어요. |
| 초대할 수 있는 음성 채널 | 봇을 부를 수 있는 채널을 제한해요. 비워 두면 모든 음성 채널을 허용해요. |
🏠 상주
봇이 선택한 음성 채널 하나에 계속 머물고, 그곳에 있는 누구나 먼저 초대하지 않고도 봇과 이야기할 수 있어요.
| 설정 | 기능 |
|---|---|
| 상주할 음성 채널 | 봇이 머무는 채널 하나예요. |
| 알림용 텍스트 채널 | 봇이 음성 채널 자체의 채팅에 쓸 수 없을 때 사용돼요. 쓸 수 있는 채널이 없으면 듣지 않아요. |
| 하루 청취 시간(분) | 하루에 총 얼마나 들을 수 있는지예요. |
하루 허용량에 도달하면, 봇은 채널에 머물지만 UTC 자정까지 듣지 않아요. 나가지 않으며, 다음 날 다시 초대할 필요도 없어요. 오늘 이미 사용한 듣기 시간은 패널이 저장하므로, 봇을 다시 시작해도 하루 허용량이 돌아오지 않아요.
🔊 음성
| 설정 | 기능 |
|---|---|
| 답변에 서버 메모리 사용 | AI Response 메모리가 활성화되어 있으면 그것을 읽어요. 음성 대화는 메모리에 절대 쓰지 않아요. 텍스트 대화만 써요. |
| 듣기와 말하기용 OpenAI API 키 | 답변 자체를 생성하는 AI Response API 키와 별도로, 전사(음성→텍스트)와 음성(텍스트→음성)에 사용돼요. |
| 듣기 모델 / 말하기 모델 | 어떤 모델이 전사하고 어떤 모델이 말할지를 엔드포인트에서 골라요. |
| 목소리 | 봇이 말할 때 쓰는 목소리로, 고정된 목록(Alloy, Ash, Coral, Echo, Fable, Nova, Onyx, Sage, Shimmer)에서 골라요. |
| 자체 음성 엔드포인트 사용 | 꺼짐: api.openai.com. 켜짐: 전사와 음성을 모두 제공하는 내 OpenAI 호환 서버예요. |
| 이 엔드포인트의 음성 이름 | 내 엔드포인트가 음성 이름을 다르게 부를 때만 필요해요. 보낸 음성을 엔드포인트가 알고 있어야 해요. 비워 두면 위에서 고른 음성을 그대로 보내요. |
⌨️ 명령어
/voice-chat은 슬래시 전용이에요. 접두사를 설정해 놓아도 텍스트 명령어로는 작동하지 않아요.
| 하위 명령어 | 기능 |
|---|---|
/voice-chat start |
현재 음성 채널로 봇을 초대해요(요청 시 모드에서만 사용할 수 있어요). |
/voice-chat stop |
봇을 내보내요. |
🔗 함께 쓰는 기능
- AI Response - 음성 대화에 답하는 모델, 설정(lore), 메모리는 AI Response의 것이에요. 그곳에서 설정하세요.
- 음성 녹음 - 서버에는 음성 연결이 하나뿐이라서, 봇이 한 채널을 녹음하면서 동시에 다른 채널에서 음성 대화를 할 수는 없어요. 두 기능을 함께 설정할 필요는 없지만, 한 번에 하나만 연결을 쓸 수 있어요.
✅ 권한
봇은 들어갈 수 있는 음성 채널에서 View Channel, Connect, Speak 권한이, 안내를 받는 텍스트 채널에서 Send Messages 권한이 필요해요. 그 권한이 없으면 아예 듣지 않아요.
💡 모범 사례
- 상주 모드에 채널을 내주기 전에, 먼저 요청 시 모드로 시작해서 커뮤니티가 실제로 어떻게 사용하는지 확인하세요.
- **하루 청취 시간(분)**은 처음에는 적당히 두세요. 실제 사용량을 알게 되면 언제든 올릴 수 있어요.
- AI Response의 설정(lore)과 메모리 설정을 먼저 검토하세요. 음성 대화는 읽을 수 있는 것만큼만 좋아요.