Skip to content

V0.2.9

Choose a tag to compare

View all tags
@jjyaoao jjyaoao released this 13 Feb 05:48
· 14 commits to main since this release
V0.2.9
6749914

🎓 HelloAgents V0.2.9 - 学习版定稿公告

📅 发布日期: 2026-02-13
📦 版本: v0.2.9 (Learning Edition - Stable)
🔗 GitHub: https://github.com/jjyaoao/HelloAgents
📚 教程: https://github.com/datawhalechina/Hello-Agents

🎯 核心公告

HelloAgents V0.2.9 正式定稿为「学习版」，从此版本开始：

  • ✅ 接口冻结：核心 API 保持稳定，不再引入破坏性变更
  • ✅ 教程基准：所有教程、文档、示例代码均基于此版本
  • ✅ 长期维护：仅接受 bug 修复和安全更新，不添加新特性
  • ✅ 初学者友好：推荐所有初学者和教程读者使用此版本

📖 为什么需要学习版？

在过去的开发中，我们收到了很多反馈：

"教程里的代码跑不通了，API 变了..."
"刚学会一个功能，更新后又不一样了..."
"能不能有个稳定版本，让我安心学完整个教程？"

我们听到了你们的声音！

V0.2.9 学习版的目标是：

  • 🎓 教学优先：为 Datawhale《Hello-Agents》教程提供稳定基础
  • 📚 文档完整：所有示例代码保证可运行
  • 🔒 接口稳定：学习过程中不会遇到 API 变更
  • 🌱 循序渐进：从简单到复杂，逐步掌握 Agent 开发

🚀 V0.2.9 核心特性

1. 核心框架

from hello_agents import SimpleAgent, HelloAgentsLLM

# 最简单的 Agent
llm = HelloAgentsLLM(model="gpt-4")
agent = SimpleAgent("助手", llm)
response = agent.run("你好")

2. 工具系统

from hello_agents.tools import SearchTool, ToolRegistry

# 工具注册与使用
search = SearchTool(backend="tavily")
registry = ToolRegistry()
registry.register_tool(search)

agent = SimpleAgent("搜索助手", llm, tool_registry=registry)

3. 记忆系统

from hello_agents.memory import VectorMemory, GraphMemory

# 向量记忆
vector_mem = VectorMemory()
vector_mem.add("重要信息")

# 图记忆
graph_mem = GraphMemory()
graph_mem.add_entity("Alice", "Person")

4. RAG 系统

from hello_agents.tools import RAGTool

# RAG 工具
rag = RAGTool(docs_path="./docs")
rag.index_documents()
results = rag.search("如何使用 Agent?")

5. 协议支持

from hello_agents.protocols import MCPServer

# MCP 协议
server = MCPServer("my-server")
server.add_tool(search)
server.run()

📦 安装指南

基础安装

pip install hello-agents==0.2.9

完整安装

# 所有功能（推荐学习使用）
pip install hello-agents[all]==0.2.9

# 或按需安装
pip install hello-agents[search]==0.2.9        # 搜索功能
pip install hello-agents[memory]==0.2.9        # 记忆系统
pip install hello-agents[rag]==0.2.9           # RAG 系统
pip install hello-agents[protocols]==0.2.9     # MCP/A2A 协议
pip install hello-agents[evaluation]==0.2.9    # 评估工具

验证安装

import hello_agents
print(hello_agents.__version__)  # 应输出: 0.2.9

🔮 下一步：Dev 开发版

在保持学习版稳定的同时，我们将启动 Dev 开发版 分支，用于探索和集成新特性：

Dev 版将保持对学习版的接口兼容：

  • ✅ 学习直接在 Dev 版运行
  • ✅ 新特性通过可选参数添加
  • ✅ 不破坏现有 API 设计
  • ✅ 提供平滑迁移路径

📚 学习资源

官方教程

贡献指南

学习版虽然冻结新特性，但我们欢迎：

  • ✅ Bug 修复
  • ✅ 文档改进
  • ✅ 示例代码优化
  • ✅ 测试用例补充

🙏 致谢

感谢所有为 HelloAgents 做出贡献的开发者和学习者！

特别感谢：

  • Datawhale 社区：提供教学平台和反馈
  • 早期用户：帮助我们发现和修复问题
  • 贡献者：提交代码和文档改进
  • 所有学习者：你们的反馈推动了学习版的诞生
Assets 2
Loading