Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Readme-cn wording update #201

Merged
merged 6 commits into from
Aug 19, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 17 additions & 16 deletions docs/readmes/README-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,14 +32,14 @@

<br>

## Astra 语音助手
## Astra voice agent

[Astra voice agent](https://theastra.ai) 是通过 TEN 搭建出来的 voice agent, 展示了多模态,低延迟的能力。

[![Showcase Astra voice agent](https://github.com/rte-design/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai)

<br>
<h2>如何用搭建的 graph designer 配置 voice agent</h2>
<h2>如何本地搭建 Astra voice agent</h2>

### 先决条件
#### Keys
Expand Down Expand Up @@ -70,7 +70,7 @@
```

### 下一步
#### 1. 准备设置文件
#### 1. 创建配置文件
Clone 项目后,在根目录下跑下面的命创建 `property.json` 和 `.env`:
```bash
# 创建 .env 文件
Expand All @@ -81,56 +81,57 @@ cp ./agents/property.json.example ./agents/property.json
```

#### 2. 绑定积木的 keys
打开 `.env` 文件,绑定对应的积木 keys,这里可以通过配置不同的 keys 选用不用的积木:
打开 `.env` 文件,绑定对应的积木 keys,这里也可以通过配置不同的 keys 选用不用的积木:
cyfyifanchen marked this conversation as resolved.
Show resolved Hide resolved
```
# Agora App ID and Agora App Certificate
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=

# Extension: agora_rtc
# Azure STT key and region
AZURE_STT_KEY=
AZURE_STT_REGION=

# Extension: azure_tts
# Azure TTS key and region
AZURE_TTS_KEY=
AZURE_TTS_REGION=

# Extension: openai_chatgpt
# OpenAI API key
OPENAI_API_KEY=
```

#### 3. 开启 Docker 容器
在同一个目录下,通过 Docker 镜像构建 Docker 容器:
#### 3. 创建 Docker 容器
在根目录下,通过 `docker compose up` 创建 docker 容器:
```bash
# 开启 Docker 容器:
docker compose up
```

#### 4. 构建 Agent 并开启服务
再打开一个 Terminal 窗口,通过下面的命令进入 Docker 容器,创建并开启服务
#### 4. 在容器内创建 agent 服务
再打开一个 Terminal 窗口,通过下面的命令进入 Docker 容器,创建 agent 服务
```bash
# 进入容器创建 Agent
# 进入容器创建 agent
docker exec -it astra_agents_dev bash

make build
```

#### 5.开启服务
```bash
# 端口 8080 开启服务
make run-server
make run-sever
```

### 构建完成 🎉

走到这里就本地构建完成了,简单 4 步,上手体验拉满!
走到这里就本地构建完成了,简单 5 步,上手体验拉满!

#### 验证 Astra voice agent

现在可以打开浏览器 `localhost:3000` 体验 voice agent。
现在可以打开浏览器 http://localhost:3000 体验 Astra voice agent。

#### 验证 Graph designer

同时可以再开一个 tab 在 `localhost:3001` 体验 TEN Graph Designer (beta),通过简单拖拽和动态节点连接轻松定制 Astra voice agent。
同时可以再开一个 tab 在 http://localhost:3001 体验 Graph Designer (beta),通过简单拖拽和动态节点连接轻松定制 Astra voice agent。

![TEN Graph Designer](https://github.com/rte-design/docs/blob/main/assets/gifs/graph-designer.gif?raw=true)

Expand Down