快速开始
在本章节中,让我们一起构建 TEN Agent 的 Playground。
前提条件
Agora App ID 和 App Certificate (每月有免费额度)
🎉 CPU >= 2 核
😄 内存 >= 4 GB
Apple Silicon 上的 Docker 设置
对于 Apple Silicon Mac,请在 Docker 设置中取消选中 "Use Rosetta for x86/amd64 emulation"。注意:这可能会导致在 ARM 上的构建时间变慢,但在部署到 x64 服务器时性能将恢复正常。
下一步
1. 克隆 TEN Agent 仓库
git clone https://github.com/TEN-framework/TEN-Agent.git2. 准备配置文件
在你的代码编辑器中打开 TEN Agent。在项目根目录中使用 cd 命令从 .env.example 创建 .env 文件。
cp ./.env.example ./.env3. 在 .env 文件中设置 Agora App ID 和 App Certificate
打开 .env 文件并填写 Agora App ID 和 App Certificate。这些将用于连接 Agora RTC 扩展。
# Agora App ID
# Agora App Certificate(only required if enabled in the Agora Console)
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
# Extension: elevenlabs_tts
# ElevenLabs TTS key
ELEVENLABS_TTS_KEY=
# Extension: deepgram_asr
# Deepgram ASR key
DEEPGRAM_API_KEY=4. 启动 agent 构建工具容器
在同一目录下,运行 docker 命令来组合容器:
docker compose up -d5. 进入容器
使用以下命令进入容器:
docker exec -it ten_agent_dev bash6. 构建 agent
使用以下命令构建 agent:
task use7. 启动 Web 服务器
使用以下命令启动 Web 服务器:
task run8. 编辑 Playground 设置
在 localhost:3000 打开 Playground 来配置你的 agent。
- 选择一个图类型 (例如,语音 Agent,实时对话 Agent)
- 选择一个对应的模块
- 选择一个扩展并配置其 API 密钥设置 (若你还未在前面步骤的.env中配置环境变量)
在 GitHub 上编辑
最后更新