🎙️ Starter Agent
-A starter agent optimized for voice conversations.
+针对语音对话优化的入门 Agent。
-Code
+代码
|
🔄 Multi-user push to talk
-Responds to multiple users in the room via push-to-talk.
+通过按键通话（push-to-talk）响应房间内多位用户。
-Code
+代码
|
@@ -262,16 +266,16 @@ For more examples and detailed setup instructions, see the [examples directory](
🎵 Background audio
-Background ambient and thinking audio to improve realism.
+背景环境音和思考音效，提升真实感。
-Code
+代码
|
🛠️ Dynamic tool creation
-Creating function tools dynamically.
+动态创建函数工具。
-Code
+代码
|
@@ -279,16 +283,16 @@ For more examples and detailed setup instructions, see the [examples directory](
☎️ Outbound caller
-Agent that makes outbound phone calls
+进行外呼电话的 Agent
-Code
+代码
|
📋 Structured output
-Using structured output from LLM to guide TTS tone.
+使用 LLM 的结构化输出来指导 TTS 语调。
-Code
+代码
|
@@ -296,16 +300,16 @@ For more examples and detailed setup instructions, see the [examples directory](
🔌 MCP support
-Use tools from MCP servers
+使用 MCP 服务器提供的工具
-Code
+代码
|
💬 Text-only agent
-Skip voice altogether and use the same code for text-only integrations
+完全跳过语音，使用相同代码进行纯文本集成
-Code
+代码
|
@@ -313,16 +317,16 @@ For more examples and detailed setup instructions, see the [examples directory](
📝 Multi-user transcriber
-Produce transcriptions from all users in the room
+为房间内所有用户生成转录文本
-Code
+代码
|
🎥 Video avatars
-Add an AI avatar with Tavus, Bithuman, LemonSlice, and more
+使用 Tavus、Bithuman、LemonSlice 等添加 AI 虚拟形象
-Code
+代码
|
@@ -330,105 +334,105 @@ For more examples and detailed setup instructions, see the [examples directory](
🍽️ Restaurant ordering and reservations
-Full example of an agent that handles calls for a restaurant.
+处理餐厅来电的完整 Agent 示例。
-Code
+代码
|
👁️ Gemini Live vision
-Full example (including iOS app) of Gemini Live agent that can see.
+具备视觉能力的 Gemini Live Agent 完整示例（含 iOS 应用）。
-Code
+代码
|
-## Running your agent
+## 运行你的 Agent
-### Testing in terminal
+### 在终端中测试
```shell
python myagent.py console
```
-Runs your agent in terminal mode, enabling local audio input and output for testing.
-This mode doesn't require external servers or dependencies and is useful for quickly validating behavior.
+在终端模式下运行 Agent，启用本地音频输入和输出以便测试。
+此模式无需外部服务器或依赖，适合快速验证行为。
-### Developing with LiveKit clients
+### 使用 LiveKit 客户端进行开发
```shell
python myagent.py dev
```
-Starts the agent server and enables hot reloading when files change. This mode allows each process to host multiple concurrent agents efficiently.
+启动 Agent 服务器，并在文件变更时启用热重载。此模式允许每个进程高效托管多个并发 Agent。
-The agent connects to LiveKit Cloud or your self-hosted server. Set the following environment variables:
+Agent 会连接到 LiveKit Cloud 或你自托管的服务器。请设置以下环境变量：
- LIVEKIT_URL
- LIVEKIT_API_KEY
- LIVEKIT_API_SECRET
-You can connect using any LiveKit client SDK or telephony integration.
-To get started quickly, try the [Agents Playground](https://agents-playground.livekit.io/).
+你可以使用任意 LiveKit 客户端 SDK 或电话集成进行连接。
+要快速上手，请试用 [Agents Playground](https://agents-playground.livekit.io/).
-### Running for production
+### 生产环境运行
```shell
python myagent.py start
```
-Runs the agent with production-ready optimizations.
+以面向生产环境的优化配置运行 Agent。
-## License
+## 许可证
-The Agents framework is licensed under [Apache-2.0](LICENSE). The LiveKit turn detection models are licensed under the [LiveKit Model License](MODEL_LICENSE).
+Agents 框架采用 [Apache-2.0](LICENSE) 许可证。LiveKit 话轮检测（turn detection）模型采用 [LiveKit Model License](MODEL_LICENSE) 许可证。
-## Contributing
+## 贡献
-The Agents framework is under active development in a rapidly evolving field. We welcome and appreciate contributions of any kind, be it feedback, bugfixes, features, new plugins and tools, or better documentation. You can file issues under this repo, open a PR, or chat with us in the [LiveKit community](https://docs.livekit.io/intro/community/).
+Agents 框架正处于快速发展领域中的积极开发阶段。我们欢迎并感谢各类贡献，无论是反馈、错误修复、功能、新插件和工具，还是更完善的文档。你可以在本仓库提交 issue、发起 PR，或在 [LiveKit 社区](https://docs.livekit.io/intro/community/).
-### Development setup
+### 开发环境设置
-This project uses [uv](https://docs.astral.sh/uv/) for package management. To install dependencies for development:
+本项目使用 [uv](https://docs.astral.sh/uv/) 进行包管理。要安装开发依赖：
```shell
uv sync --all-extras --dev
```
-### Examples
+### 示例
-This project includes many examples in the [`examples`](examples/) directory. To run them, create the file `examples/.env` with credentials for LiveKit Server and any necessary model providers (see `examples/.env.example`), then run:
+本项目在 [`examples`](examples/) 目录中包含许多示例。要运行它们，请创建文件 `examples/.env`，并填入 LiveKit Server 及所需模型提供商的凭据（参见 `examples/.env.example`），然后运行：
```shell
uv run examples/voice_agents/basic_agent.py dev
```
-For more information, see the [examples README](examples/README.md).
+更多信息请参阅 [examples README](examples/README.md)。
-### Tests
+### 测试
-Unit tests are in the `tests` directory and can be run with:
+单元测试位于 `tests` 目录，可通过以下命令运行：
```shell
uv run pytest --unit
```
-Integration tests for each plugin require various API credentials and run automatically in GitHub CI for PRs submitted by project maintainers. See the [tests workflow](.github/workflows/tests.yml) for details.
+各插件的集成测试需要多种 API 凭据，并在项目维护者提交的 PR 中于 GitHub CI 自动运行。详情请参阅 [tests workflow](.github/workflows/tests.yml)。
-### Formatting
+### 格式化
-This project uses [ruff](https://github.com/astral-sh/ruff) for formatting and linting:
+本项目使用 [ruff](https://github.com/astral-sh/ruff) 进行格式化和 lint：
```shell
uv run ruff format
uv run ruff check --fix
```
-### Documentation
+### 文档
-To generate docs locally with [pdoc](https://github.com/pdoc3/pdoc):
+要使用 [pdoc](https://github.com/pdoc3/pdoc): 在本地生成文档：
```shell
uv sync --all-extras --group docs
@@ -437,16 +441,16 @@ uv run --active pdoc --skip-errors --html --output-dir=docs livekit
+