ASTRA.ai

<div align="center">

<a href="./README.md"><img alt="README in English" src="https://img.shields.io/badge/English-lightgrey"></a> <a href="./docs/readmes/README-CN.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-lightgrey"></a>

Documentation <span>  •  </span> Getting Started <span>  •  </span> Tutorials

</div> <br> <h2>语音代理：Astra</h2>

语音代理：Astra

Astra 是一个语音代理，由 TEN 提供支持，展示了其创建直观和无缝对话交互的能力。

<br>

<h2>本地搭建语音代理指南

先决条件

密钥

• Agora App ID 和 App Certificate (阅读此处了解如何操作)
• Azure 的 speech-to-text 和 text-to-speech API 密钥
• OpenAI API 密钥

安装

• Docker / Docker Compose
• Node.js (LTS) v18

最低系统要求

• CPU ≥ 2 核心
• RAM ≥ 4 GB

Apple Silicon 上的 Docker 设置

如果您使用 Apple Silicon，则需要取消选中 Docker 的“在 Apple Silicon 上使用 Rosetta 进行 x86_64/amd64 仿真”的选项，否则服务器将无法工作。

下一步

1. 修改配置文件

在项目的根目录中，从示例中创建这些文件。它们将用于存储 Docker Compose 的信息。

# 从示例中创建 .env 文件
cp ./.env.example ./.env

# 从示例中创建 property.json 文件
cp ./agents/property.json.example ./agents/property.json

2. 设置 API 密钥

打开 .env 文件并填写密钥和区域。这也是您可以选择使用任何不同扩展的地方：

# Agora App ID 和 Agora App Certificate
# 必需：此变量必须设置
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=

# 扩展：agora_rtc
# Azure STT 密钥和区域
AZURE_STT_KEY=
AZURE_STT_REGION=

# 扩展：azure_tts
# Azure TTS 密钥和区域
AZURE_TTS_KEY=
AZURE_TTS_REGION=

# 扩展：openai_chatgpt
# OpenAI API 密钥
OPENAI_API_KEY=

3. 启动代理开发容器

在同一目录中，运行 docker 命令以编排容器：

# 执行 docker compose up 启动服务
docker compose up

4. 构建代理并启动服务器

打开一个单独的终端窗口，构建代理并启动服务器：

# 进入容器构建代理
docker exec -it astra_agents_dev bash
make build

# 构建完成后，在 8080 端口运行服务器
make run-server

完成并验证 🎉

Astra 语音代理

在浏览器中打开 localhost:3000 以测试 Astra 语音代理。

图形设计器

打开另一个标签，访问 localhost:3001，并使用图形设计器编辑任何扩展的流程和属性。

<br> <h2>TEN 平台</h2>

现在您已经创建了第一个 AI 代理，创意并未止步于此。要开发更多惊人的代理，您需要深入了解 TEN 服务的工作原理。请参考 TEN 平台文档。

<br> <h2>敬请关注</h2>

在进一步探索之前，请给我们的代码库点赞，并获得所有新版本的即时通知！

<br> <h2>加入社区</h2>

• Discord: 适合分享您的应用程序并与社区互动。
• GitHub 讨论: 适合提供反馈和提问。
• GitHub 问题: 最适合报告错误并提出新功能。有关详细信息，请参阅我们的 贡献指南。
• X（前 Twitter）: 适合分享您的代理并与社区互动。

<br> <h2>代码贡献者</h2>

<br> <h2>贡献指南</h2>

欢迎贡献！请先阅读 贡献指南。

<br> <h2>许可证</h2>

此项目以 Apache 2.0 许可证授权 - 详情请参见 LICENSE 文件。