helloagents
一个功能全面的生产级多智能体开发框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：helloagents。 它的用途是：一个功能全面的生产级多智能体开发框架。 完整的 Skill 内容见：https://321skill.com/skills/helloagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“分析当前项目目录下的代码结构，找出潜在的安全风险并生成一份Markdown格式的报告。”，框架内的ReActAgent会协调ReadTool读取文件，分析代码，并最终调用WriteTool生成详细的风险评估报告。
介绍
HelloAgents 是一个专为构建复杂智能体应用设计的开源框架。它旨在解决开发者在集成大语言模型、管理多智能体协作、处理工具调用以及保障应用稳定性时面临的工程化难题。框架原生集成了工具响应协议、会话持久化、子代理机制、熔断器等16项核心能力，为智能体应用提供从开发到部署的全流程支持。
使用上，开发者通过简单的安装命令即可引入框架，并通过配置环境变量连接不同的LLM服务商。框架提供了ReActAgent等开箱即用的智能体基类，以及丰富的内置工具（如文件读写、任务进度管理），开发者可以快速组装和定制自己的智能体工作流。其智能适配器能自动识别OpenAI、Anthropic、Gemini等多种API格式，极大简化了配置过程。
该框架非常适合有一定Python基础，希望将大语言模型能力深度集成到生产系统中的开发者、研究者和技术团队。无论是构建自动化客服、代码助手、数据分析流水线，还是探索复杂的多智能体协作场景，HelloAgents都能提供坚实的底层支撑。
需要注意的是，框架目前维护着“学习版本”和“开发版本”两个分支。初学者建议从learn_version分支开始，以配合官方教程进行学习；而追求最新功能和改进的开发者则应使用主分支。此外，框架主要面向后端开发集成，对于前端展示或纯交互式应用，可能需要额外的开发工作。
核心特点
与同类智能体框架相比，HelloAgents的核心区别在于其高度工程化的16项内置能力，特别是工具响应协议（ToolResponse）和子代理机制（TaskTool），使得多智能体间的工具调用与任务分解协作更为规范和高效；同时，其集成的会话持久化、熔断器、乐观锁等特性，直接瞄准了生产环境对稳定性、可观测性和数据一致性的严苛要求。
注意事项
该框架主要面向后端开发者进行系统集成，不适合需要快速构建轻量级、纯前端交互式智能体应用的场景。
常见问题
HelloAgents支持哪些大模型？
通过三种智能适配器，支持所有提供OpenAI兼容接口的云端/本地模型（如DeepSeek、Qwen、GLM、Ollama）、Anthropic Claude以及Google Gemini。
学习版本和开发版本有什么区别？
学习版本（learn_version分支）与Datawhale教程完全同步，代码稳定，适合初学者；开发版本（主分支）包含最新功能和改进，但可能与教程有差异，适合进阶开发者。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/helloagents/raw/index.md 读取 helloagents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/helloagents/raw/index.md（查看排版版本）