快速开始

在本章节中，让我们一起构建 TEN Agent 的 Playground。

前提条件

API Keys

• Agora App ID 和 App Certificate (每月有免费额度)

安装

• Docker / Docker Compose

• Node.js(LTS) v18

最低系统要求

🎉 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.git

2. 准备配置文件

在你的代码编辑器中打开 TEN Agent。在项目根目录中使用 cd 命令从 .env.example 创建 .env 文件。

>_ 终端

cp ./.env.example ./.env

3. 在 .env 文件中设置 Agora App ID 和 App Certificate

打开 .env 文件并填写 Agora App ID 和 App Certificate。这些将用于连接 Agora RTC 扩展。

.env

AGORA_APP_ID=
AGORA_APP_CERTIFICATE=

4. 启动 agent 构建工具容器

在同一目录下，运行 docker 命令来组合容器：

>_ 终端

docker compose up -d

5. 进入容器

使用以下命令进入容器：

>_ Bash

docker exec -it ten_agent_dev bash

6. 构建 agent

使用以下命令构建 agent：

>_ Bash

task use

7. 启动 Web 服务器

使用以下命令启动 Web 服务器：

>_ Bash

task run

8. 编辑 Playground 设置

在 localhost:3000 打开 Playground 来配置你的 agent。

1. 选择一个图类型 (例如，语音 Agent，实时对话 Agent)

2. 选择一个对应的模块

3. 选择一个扩展并配置其 API 密钥设置

模块示例