内容
<div align="center">
英文 | <a href="README.cn.md">简体中文</a>
</div>
<div align="center">
<img src="https://raw.githubusercontent.com/RedDotRocket/AgentUp/main/assets/logo.png" alt="AgentUp Logo" width="400"/>
<!-- CTA Buttons -->
<p>
<a href="https://github.com/RedDotRocket/AgentUp/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">
<img src="https://img.shields.io/badge/贡献-优秀的第一份问题-green?style=for-the-badge&logo=github" alt="优秀的第一份问题"/>
</a>
<a href="https://discord.gg/pPcjYzGvbS">
<img src="https://img.shields.io/badge/聊天-加入Discord-7289da?style=for-the-badge&logo=discord&logoColor=white" alt="加入Discord"/>
</a>
</p>
<!-- Badges -->
<p>
<a href="https://opensource.org/licenses/Apache-2.0">
<img src="https://img.shields.io/badge/许可证-Apache%202.0-blue.svg" alt="许可证"/>
</a>
<a href="https://github.com/RedDotRocket/AgentUp/actions/workflows/ci.yml">
<img src="https://github.com/RedDotRocket/AgentUp/actions/workflows/ci.yml/badge.svg" alt="CI状态"/>
</a>
<a href="https://pypi.org/project/AgentUp/">
<img src="https://img.shields.io/pypi/v/AgentUp.svg" alt="PyPI版本"/>
</a>
<a href="https://pepy.tech/project/agentup">
<img src="https://static.pepy.tech/badge/agentup" alt="下载量"/>
</a>
<a href="https://discord.gg/pPcjYzGvbS">
<img src="https://img.shields.io/discord/1384081906773131274?color=7289da&label=Discord&logo=discord&logoColor=white" alt="Discord"/>
</a>
</p>
<br/>
</div>
<!-- Status Box -->
<div align="center">
<table>
<tr>
<td align="center">
<strong>🚀 活跃开发中</strong>
<br/>
<sub>🏃♂️ 我们正在快速推进，可能会出现问题！</sub>
<br/>
</td>
</tr>
</table>
</div>
<br/>
## 为什么选择AgentUp？
就像Docker使应用程序不可变、可重现且易于运维一样，**AgentUp** 对AI代理也做了同样的事情。 通过配置文件定义您的代理，它可以在任何地方一致运行。 与队友分享代理，他们可以克隆/分叉并立即运行。 在开发、测试和生产环境中部署时，您知道您的代理将表现相同。
<img src="assets/init.gif" width="100%" height="100%"/>
当您需要自定义时，请编写干净的抽象代码并加载到AgentUp的运行时中，并继承AgentUp的所有中间件和安全功能。 然后，您可以将代码作为依赖项进行管理，以及使用您使用的任何其他基于社区的插件。 不再与每次更改都会破坏您的应用程序的框架作斗争。 查看 [AgentUp插件注册表](https://agentup.dev/packages) 以获取当前提供的一些插件。
<img src="/assets/plugins.gif" width="100%" height="100%"/>
AgentUp由工程师团队构建，他们曾创建过为 **谷歌、GitHub、英伟达、红帽、Shopify 等** 关键系统提供支持的开源解决方案。 我们了解构建稳定、安全、可扩展的软件需要什么 - 并且我们正在应用这些相同的原则，使AI代理真正适用于生产环境、安全和可靠。
## AgentUp：面向开发者的Agent框架
AgentUp提供企业级代理基础设施，专为需要强大和简单性的专业开发者设计。
**开发者优先的运维**：由了解现实世界约束的开发者构建。 每个代理都生活在自己的存储库中，带有单个AgentUp配置文件。 克隆，运行 `agentup run`，所有依赖项都在初始化期间解析 - 不再有环境设置头痛。
**安全设计**：具有OAuth2、JWT和API密钥身份验证的细粒度、基于范围的访问控制，防止未经授权的工具/MCP访问，确保数据保护。 安全性不是事后才考虑的 - 它是AgentUp的基础架构。
**配置驱动架构**：通过声明性配置定义复杂的代理行为、数据源和工作流。 跳过数周的样板代码和框架斗争。 您的代理成为具有明确契约的可移植、版本化资产，定义其功能和交互。
**可扩展的自定义生态系统**：需要RAG、图像处理、自定义API逻辑？ 没问题。 利用社区插件或构建自动继承AgentUp中间件、安全性和运维功能的自定义扩展。 独立插件版本与现有的CI/CD管道无缝集成，确保核心平台更新不会破坏您的实现。 使用AgentUp，您可以立即获得正在运行的代理的反馈，以及框架的可扩展性。
**代理到代理的发现**：自动A2A代理卡生成将您的代理功能暴露给生态系统中的其他代理，实现代理间的无缝通信和编排。
**异步任务架构**：基于消息的任务管理支持具有回调通知的长时间运行操作。 适用于研究代理、数据处理工作流和事件驱动自动化。 Redis和其他后端的状态持久性确保了大规模的可靠性。
**确定性路由**：大多数框架将所有内容都放在LLM的执行路径中，但这通常不是最佳选择。 通常，更好的解决方案是通过确定性代码，即良好的旧软件工程。 为此，AgentUp允许基于确定性关键字的路由，其中请求可以自然语言驱动，但可以发送到现有的非LLM服务，利用缓存和其他效率机制。
**MCP支持**：AgentUp包含对模型上下文协议（MCP）的内置支持，允许代理与各种通信通道和API无缝交互。 STDIO、SSE和Streamable HTTP均提供完整支持。 只需添加配置文件，就像为Claude、Cursor或VSCode添加配置文件一样。
## 多种代理类型
在AgentUp中，我们称之为多种代理类型。
**反应代理**：这些代理响应用户输入和事件，作为单次交互，非常适合聊天机器人和交互式应用程序。
**迭代代理**：设计用于需要多个规划步骤或迭代的任务，非常适合研究。 这些代理将目标分解为较小、可管理的任务，并依次执行它们，在整个过程中保持上下文和状态。 目标必须达到置信阈值才能结束。
## 保持更新
AgentUp的开发正在快速推进 🏃♂️，要关注项目并及时了解新版本，**请给仓库点赞**。
<img src="/assets/star.gif" width="40%" height="40%"/>
## 几分钟内开始使用
### 安装
使用您喜欢的Python包管理器安装AgentUp：
```bash
pip install agentup
```
### 创建您的第一个代理
使用交互式配置生成新的代理项目：
```bash
agentup init
```
通过交互式提示，选择可用选项并配置代理的功能、身份验证和AI提供商设置。
### 启动您的代理
启动开发服务器并开始构建：
```bash
agentup run
```
您的代理现在运行在 `http://localhost:8000`，具有完整的A2A兼容JSON RPC API、安全中间件和所有已配置的功能。
### 下一步
#### 需要UI吗？
获取AgentUp聊天客户端，通过简单的界面使用[AgentUpChat](https://github.com/RedDotRocket/AgentUpChat)与您的代理进行对话。
<img src="/assets/demo.gif" width="100%" height="100%"/>
#### 查看文档！
浏览综合 [文档](https://docs.agentup.dev)，了解高级功能、教程、API引用和现实世界的例子，以便您快速构建代理。
### 当前集成
AgentUp代理可以作为工具呈现给不同的框架，这带来了确保所有工具使用一致、安全、可跟踪和可追溯的优势。
- [CrewAI](https://crewai.com)，请参阅 [文档](docs/integrations/crewai.md) 获取详细信息。
## 开源和社区驱动
AgentUp采用Apache 2.0许可，并基于开放标准构建。 该框架实现了A2A（代理到代理）规范，用于互操作性，并遵循MCP（模型上下文协议），用于与更广泛的AI工具生态系统集成。
**贡献** - 无论您是修复错误、添加功能还是改进文档，欢迎贡献。 加入日益增长的开发者社区，构建AI代理基础设施的未来。
**社区支持** - 通过 [GitHub问题](https://github.com/RedDotRocket/AgentUp/issues) 报告问题、请求功能和获取帮助。 加入实时讨论，在 [Discord](https://discord.gg/pPcjYzGvbS) 上与其他开发者交流。
## 什么是DCO Bot？
我们使用开发者原始码证书（DCO）来保持项目的法律健全性并保护我们的社区。 这在开源项目中很常见（Linux内核、Kubernetes、Docker）。
DCO防止诸如意外包含专有代码等问题，并确保所有贡献者都有权提交其更改。
这保护了贡献者和项目用户。
### 如何签署提交
只需在提交时添加 `-s` 标志：
```bash
git commit -s -m "添加很酷的新功能"
```
这添加了一个“已签署”行，证明您编写了代码或有权在Apache 2.0下贡献它。 您保留对贡献的所有权 - 不需要文书工作！
---
**许可证** - Apache 2.0
[badge-discord-img]: https://img.shields.io/discord/1384081906773131274?label=Discord&logo=discord
[badge-discord-url]: https://discord.gg/pPcjYzGvbS
MCP 市场