diff --git a/README.md b/README.md index c535027..24ba095 100644 --- a/README.md +++ b/README.md @@ -1,81 +1,87 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/RasaHQ/rasa) · [上游 README](https://github.com/RasaHQ/rasa/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 +

Rasa Open Source

-[![Join the Agent Engineering Community](https://img.shields.io/badge/Community-Join%20the%20Discussion-blueviolet)](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=) -[![Try Hello Rasa](https://img.shields.io/badge/Playground-Try%20Hello%20Rasa-ff69b4)](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=) -[![PyPI version](https://badge.fury.io/py/rasa.svg)](https://badge.fury.io/py/rasa) -[![Supported Python Versions](https://img.shields.io/pypi/pyversions/rasa.svg)](https://pypi.python.org/pypi/rasa) -[![Build Status](https://github.com/RasaHQ/rasa/workflows/Continuous%20Integration/badge.svg)](https://github.com/RasaHQ/rasa/actions) -[![Documentation Status](https://img.shields.io/badge/docs-stable-brightgreen.svg)](https://rasa.com/docs) +[![加入 Agent Engineering 社区](https://img.shields.io/badge/Community-Join%20the%20Discussion-blueviolet)](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=) +[![试用 Hello Rasa](https://img.shields.io/badge/Playground-Try%20Hello%20Rasa-ff69b4)](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=) +[![PyPI 版本](https://badge.fury.io/py/rasa.svg)](https://badge.fury.io/py/rasa) +[![支持的 Python 版本](https://img.shields.io/pypi/pyversions/rasa.svg)](https://pypi.python.org/pypi/rasa) +[![构建状态](https://github.com/RasaHQ/rasa/workflows/Continuous%20Integration/badge.svg)](https://github.com/RasaHQ/rasa/actions) +[![文档状态](https://img.shields.io/badge/docs-stable-brightgreen.svg)](https://rasa.com/docs)

-

🚧 Note: Maintenance Mode 🚧

+

🚧 注意:维护模式 🚧

- Rasa Open Source is currently in maintenance mode. + Rasa Open Source 目前处于维护模式。
- The future of building AI agents with Rasa is Hello Rasa and CALM. + 使用 Rasa 构建 AI agent 的未来方向是 Hello RasaCALM


-## 🚀 The Future of Rasa: Hello Rasa +## 🚀 Rasa 的未来:Hello Rasa -**Building reliable AI agents just got easier.** +**构建可靠的 AI agent 变得更容易了。** -[**Hello Rasa**](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=) is our new interactive playground for prototyping AI agents. It combines LLM fluency with the reliability of business logic using our **CALM** (Conversational AI with Language Models) engine. +[**Hello Rasa**](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=) 是我们全新的交互式 playground,用于原型化 AI agent。它将 LLM 的流畅表达能力与我们 **CALM**(Conversational AI with Language Models,基于语言模型的对话式 AI)引擎的可靠性相结合。 -### Why switch to Hello Rasa? +### 为什么切换到 Hello Rasa? -* **No setup required:** Open the playground, pick a template (Banking, Telecom, Support), and start building in your browser. -* **No NLU training:** We have moved beyond intents. The LLM handles dialogue understanding while you define the business flows. -* **Built-in copilot:** A specialized AI assistant helps you generate code, debug flows, and expand your agent instantly. -* **Production ready:** Hello Rasa is not just a toy. Export your agent to the Rasa Platform when you are ready to scale. +* **无需设置:** 打开 playground,选择一个模板(Banking、Telecom、Support),即可在浏览器中开始构建。 +* **无需 NLU 训练:** 我们已超越 intents。LLM 负责理解对话,而你定义业务流。 +* **内置 copilot:** 专用 AI 助手可帮助你生成代码、调试流程,并即时扩展 agent。 +* **可用于生产:** Hello Rasa 不只是玩具。准备扩展时,可将 agent 导出到 Rasa Platform。 -### Core concepts +### 核心概念 -* **CALM:** Combines LLM flexibility with strict business logic. The LLM understands the user; the code enforces the rules. -* **Flows:** Describe logical steps (e.g., collect money, transfer funds) rather than rigid dialogue trees. -* **Inspector:** See real-time decision-making. No black boxes. +* **CALM:** 将 LLM 的灵活性与其严格的业务逻辑相结合。LLM 理解用户;代码强制执行规则。 +* **Flows(流程):** 描述逻辑步骤(例如收款、转账),而非僵化的对话树。 +* **Inspector(检查器):** 查看实时决策过程。没有黑箱。 -👉 **[Start building for free at Hello Rasa](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=)** +👉 **[在 Hello Rasa 免费开始构建](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=)** --- -## 🧠 Join the Agent Engineering Community +## 🧠 加入 Agent Engineering 社区 -We are building a home for people shipping real-world AI agents. +我们正在为交付真实世界 AI agent 的人们打造一个家园。 -Agent Engineering is evolving faster than any single framework. This is a vendor-neutral space to discuss architectures, memory, orchestration, and safety with builders across the industry. +Agent Engineering 的演进速度超过任何单一框架。这是一个厂商中立的场所,可与行业内的构建者一起讨论架构、记忆、编排与安全。 -### What you get: -* **Network:** Meet engineers building production agents -* **Learn:** Discuss practical patterns, not just theory -* **Access:** Direct influence on the Hello Rasa roadmap and early access to features +### 你能获得什么: +* **人脉:** 结识正在构建生产级 agent 的工程师 +* **学习:** 讨论实用模式,而不仅是理论 +* **权限:** 直接影响 Hello Rasa 路线图,并抢先体验新功能 -| Channel | Purpose | +| 频道 | 用途 | | :--- | :--- | -| **#agent-design** | Architectures, reasoning, memory, testing | -| **#showcase** | Show your builds, demos, and repos | -| **#ask-anything** | Debugging and workflow questions | +| **#agent-design** | 架构、推理、记忆、测试 | +| **#showcase** | 展示你的构建成果、演示与仓库 | +| **#ask-anything** | 调试与工作流问题 | -👉 **[Join the Community](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=)** +👉 **[加入社区](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=)** ---

-# Rasa Open Source (Legacy) +# Rasa Open Source(旧版) -> **Note:** The documentation and installation instructions below apply to the classic Rasa Open Source framework. For the latest CALM-based experience, see the [Hello Rasa](#-the-future-of-rasa-hello-rasa) section above. +> **注意:** 以下文档与安装说明适用于经典 Rasa Open Source 框架。如需最新的基于 CALM 的体验,请参阅上方的 [Hello Rasa](#-the-future-of-rasa-hello-rasa) 章节。 -Rasa is an open source machine learning framework for automating text and voice-based conversations. With Rasa, you can build contextual assistants on: +Rasa 是一个用于自动化文本与语音对话的开源机器学习框架。借助 Rasa,你可以在以下渠道上构建上下文助手: - Facebook Messenger - Slack @@ -86,32 +92,32 @@ Rasa is an open source machine learning framework for automating text and voice- - Mattermost - Telegram - Twilio -- Your own custom conversational channels +- 你自己的自定义对话渠道 -Rasa helps you build contextual assistants that can handle layered conversations with lots of back-and-forth. +Rasa 帮助你构建能够处理大量来回交互、具备多层上下文的助手。 -### 📚 Resources -- 🤓 [Read the docs](https://rasa.com/docs/rasa/) -- 😁 [Install Rasa](https://rasa.com/docs/rasa/installation/environment-set-up) -- 🚀 [Learn all about Conversational AI](https://learning.rasa.com/) -- 🏢 [Explore the enterprise platform](https://rasa.com/product/rasa-platform/) +### 📚 资源 +- 🤓 [阅读文档](https://rasa.com/docs/rasa/) +- 😁 [安装 Rasa](https://rasa.com/docs/rasa/installation/environment-set-up) +- 🚀 [全面了解 Conversational AI](https://learning.rasa.com/) +- 🏢 [探索企业平台](https://rasa.com/product/rasa-platform/) -## Development Internals & Contributing +## 开发内部机制与贡献 -We are happy to receive contributions. Please review our [Contribution Guidelines](CONTRIBUTING.md) before getting started. +我们欢迎贡献。开始前请先阅读我们的 [贡献指南](CONTRIBUTING.md)。 -### Installation for Development -Rasa uses **Poetry** for packaging and dependency management. +### 开发环境安装 +Rasa 使用 **Poetry** 进行打包与依赖管理。 -1. **Install Poetry**: Follow the [official guide](https://python-poetry.org/docs/#installation). -2. **Build from source**: +1. **安装 Poetry**:请遵循[官方指南](https://python-poetry.org/docs/#installation). +2. **从源码构建**: ```bash make install ``` - *Note for macOS users*: If you run into compiler issues, try `export SYSTEM_VERSION_COMPAT=1` before installation. + *macOS 用户注意*:若遇到编译器问题,请在安装前尝试 `export SYSTEM_VERSION_COMPAT=1`。 -### Running Tests -Make sure you have development requirements installed: +### 运行测试 +请确保已安装开发依赖: ```bash make prepare-tests-ubuntu # Ubuntu/Debian @@ -119,16 +125,16 @@ make prepare-tests-macos # macOS make test # Run tests ``` -### Releases +### 发布版本 -Rasa follows Semantic Versioning. +Rasa 遵循语义化版本(Semantic Versioning)。 - * **Major**: Incompatible API changes - * **Minor**: Backward-compatible functionality - * **Patch**: Backward-compatible bug fixes + * **Major(主版本)**:不兼容的 API 变更 + * **Minor(次版本)**:向后兼容的功能新增 + * **Patch(补丁版本)**:向后兼容的缺陷修复 -For full details on our release cadence and maintenance policy, visit our [Product Release and Maintenance Policy](https://rasa.com/rasa-product-release-and-maintenance-policy/). +有关发布节奏与维护政策的完整详情,请访问我们的 [产品发布与维护政策](https://rasa.com/rasa-product-release-and-maintenance-policy/). -## License +## 许可证 -Licensed under the Apache License, Version 2.0. Copyright 2022 Rasa Technologies GmbH. [Copy of the license](https://www.google.com/search?q=LICENSE.txt). +根据 Apache License, Version 2.0 授权。Copyright 2022 Rasa Technologies GmbH。[许可证副本](https://www.google.com/search?q=LICENSE.txt).