这是一个 Python AI Agent 框架,名为 HelloAgents,用于构建可复用多种 LLM
提供商的 Agent 系统,支持工具调用(ReAct 模式)。
核心设计
1. 多 Provider 统一接口:AsyncLLM 自动检测
provider(OpenAI/DeepSeek/Qwen/ollama/vllm
等),支持流式/非流式调用,内置重试逻辑(429 等 30s,502/503 等 5s)
2. ReAct Agent:ReActAgent 驱动"思考→行动→观察"循环,内置 MY_REACT_PROMPT
模板,LLM 单步只输出一个 Action,支持 Finish[::答案] 终止
3. 工具执行器:ToolExecutor 支持两种工具注册方式:
- tool_* 方法(内置 google_search)
- 装饰器 @register_tool(name='xxx', ctx=True) 动态注册
4. 内置工具:google_search(Serper.dev)、shorten_url、get_user_subscription
、doc_shortlink 等
技术栈
- Python 3.13+,异步 asyncio + AsyncOpenAI
- Pydantic 数据模型
- pytest 测试框架(分级 marker)
- 默认使用七牛云 LLM(qwen3-next-80b-a3b-instruct)