rtc-voice-chat/backend/.env.example
2026-04-02 20:15:15 +08:00

93 lines
3.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ============ 火山引擎账号凭证 ============
CUSTOM_ACCESS_KEY_ID=your-access-key-id
CUSTOM_SECRET_KEY=your-secret-key
# ============ RTC 配置 ============
CUSTOM_RTC_APP_ID=your-rtc-app-id
CUSTOM_RTC_APP_KEY=
CUSTOM_RTC_ROOM_ID= # 留空自动生成
CUSTOM_RTC_USER_ID= # 留空自动生成
CUSTOM_RTC_TOKEN= # 留空自动生成
RTC_OPENAPI_VERSION=2025-06-01
# ============ 场景配置 ============
CUSTOM_SCENE_NAME=自定义助手
CUSTOM_SCENE_ICON=https://lf3-rtc-demo.volccdn.com/obj/rtc-aigc-assets/DoubaoAvatar.png
CUSTOM_TASK_ID=your-task-id
CUSTOM_AGENT_USER_ID=your-agent-user-id
CUSTOM_AGENT_TARGET_USER_ID= # 留空默认等于 RTC_USER_ID
CUSTOM_AGENT_WELCOME_MESSAGE=你好,我是小块,有什么需要帮忙的吗?
CUSTOM_INTERRUPT_MODE=0
# ============ LLM 配置 (RTC OpenAPI 侧) ============
# RTC 会回调 CUSTOM_LLM_URL 指定的地址(通常是本后端的 /api/chat_callback
CUSTOM_LLM_THINKING_TYPE=disabled
CUSTOM_LLM_VISION_ENABLE=false
# 填写后端服务的公网 HTTPS 地址,火山引擎 RTC 平台会回调此地址
# 例如https://api.yourdomain.com/v1/api/chat_callback
CUSTOM_LLM_URL=
# 火山调用当前 backend 的 /api/chat_callback 时使用的 Bearer Token可留空
CUSTOM_LLM_API_KEY=
CUSTOM_LLM_MODEL_NAME=
CUSTOM_LLM_HISTORY_LENGTH=
CUSTOM_LLM_PREFILL=
CUSTOM_LLM_CUSTOM=
CUSTOM_LLM_EXTRA_HEADER_JSON=
CUSTOM_LLM_ENABLE_PARALLEL_TOOL_CALLS=
CUSTOM_LLM_TEMPERATURE=
CUSTOM_LLM_TOP_P=
CUSTOM_LLM_MAX_TOKENS=
# ============ 本地 LLM 回调配置 (/api/chat_callback) ============
# RTC 回调本后端的 /api/chat_callback 后,
# 本后端再用以下配置调用方舟(通过 OpenAI SDK
LOCAL_LLM_API_KEY=
LOCAL_LLM_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
LOCAL_LLM_MODEL=your-ark-endpoint-id
LOCAL_LLM_TIMEOUT_SECONDS=1800
LOCAL_LLM_TEMPERATURE=0.3
# ============ ASR / TTS ============
CUSTOM_ASR_APP_ID=your-asr-app-id
CUSTOM_TTS_APP_ID=your-tts-app-id
CUSTOM_ASR_PROVIDER=volcano
CUSTOM_ASR_MODE=smallmodel
CUSTOM_ASR_CLUSTER=volcengine_streaming_common
CUSTOM_TTS_PROVIDER=volcano
CUSTOM_TTS_CLUSTER=volcano_tts
CUSTOM_TTS_VOICE_TYPE=BV001_streaming
CUSTOM_TTS_SPEED_RATIO=1
CUSTOM_TTS_PITCH_RATIO=1
CUSTOM_TTS_VOLUME_RATIO=1
# ============ RAG 配置 ============
# 火山引擎知识库(语义检索)
# 设置 VOLC_KB_ENABLED=true 后,每次对话前自动检索知识库并注入上下文
VOLC_KB_ENABLED=false
VOLC_KB_NAME=your_collection_name # 知识库名称(与 VOLC_KB_RESOURCE_ID 二选一)
VOLC_KB_RESOURCE_ID= # 知识库唯一 ID优先级高于 NAME
VOLC_KB_PROJECT=default # 知识库所属项目
VOLC_KB_ENDPOINT=
VOLC_KB_TOP_K=3 # 检索返回条数
VOLC_KB_RERANK=false # 是否开启 rerank 重排
VOLC_KB_ATTACHMENT_LINK=false # 是否返回图片临时链接(图文混合场景开启,链接有效期 10 分钟)
# 静态上下文占位VOLC_KB_ENABLED=false 时的降级方案)
RAG_STATIC_CONTEXT=
RAG_CONTEXT_FILE=
# ============ 数字人 (可选) ============
CUSTOM_AVATAR_ENABLED=false
CUSTOM_AVATAR_TYPE=3min
CUSTOM_AVATAR_ROLE=250623-zhibo-linyunzhi
CUSTOM_AVATAR_BACKGROUND_URL=
CUSTOM_AVATAR_VIDEO_BITRATE=2000
CUSTOM_AVATAR_APP_ID=
CUSTOM_AVATAR_TOKEN=
# ============ Tools (Function Calling) 配置 ============
# 启用后 LLM 可主动调用已注册的工具函数查询真实数据
TOOLS_ENABLED=true
TOOLS_MAX_ROUNDS=5 # 单次对话最大工具调用轮数(防无限循环)