Co-creation-projects/haoye2-UnivesalAgent/README.md
基于Hello-Agents框架的智能搜索和命令执行助手
这是一个基于 Hello-Agents 框架的通用智能体系统,采用 单智能体 + 多工具 设计。 智能体通过 ToolRegistry 注册并调用多个工具实现复杂任务处理。
pip install -r requirements.txt
# 创建.env文件
cp .env.example .env
# 编辑.env文件,填入你的API密钥
LLM_API_KEY=your_api_key_here
方式1: Jupyter Notebook(推荐)
jupyter lab
# 打开main.ipynb并运行
方式2: 命令行界面
python main.py
输入: 搜索Python人工智能最新发展
输出: 返回相关的搜索结果和内容摘要
输入: pwd
输出: /Users/qinbohua/Developing/universal_hello_agent_llm_decision
输入: ls -la
输出: total 48...(文件列表)
输入: mkdir test_project && cd test_project
输出: 目录创建成功并切换完成
输入: grep -n "import" src/
output: src/agents/agent_universal.py:1:from hello_agents
输入: 搜索LangChain框架的最新版本信息,然后查看当前目录的文件列表
输出: 先执行搜索,然后列出文件,最后给出综合结果
universal_hello_agent_llm_decision/
├── README.md # 项目说明文档
├── requirements.txt # Python依赖列表
├── main.ipynb # 主要的Jupyter Notebook
├── main.py # 命令行入口(可选)
├── data/ # 数据文件(可选)
│ └── sample_queries.txt
├── outputs/ # 输出结果(可选)
│ ├── demo_results.md
│ ├── docs/ # 文档文件
│ │ ├── CONTRIBUTING.md
│ │ └── IMPROVEMENTS_SUMMARY.md
│ └── tests/ # 测试文件
│ ├── test_agent_improvements.py
│ └── test_tools.py
└── src/ # 源代码(可选,如果代码较多)
├── __init__.py
├── agents/ # 智能体模块
│ ├── __init__.py
│ ├── agent_universal.py
│ └── config.py
├── tools/ # 工具定义
│ ├── __init__.py
│ ├── browser_tool.py
│ └── terminal_tool.py
└── utils/ # 工具函数
└── __init__.py
欢迎提出Issue和Pull Request!
MIT License
感谢Datawhale社区和Hello-Agents项目!
项目使用 config.py 统一管理工具配置,主要配置项:
# config.py
TERMINAL_SECURITY_MODE = "strict" # 或 "warning"
详细说明请参考:CONFIG_GUIDE.md
terminal_exec 只执行列入白名单的命令,仍建议在容器或受控环境中运行。.env 的 LLM_API_BASE 与 LLM_API_KEY 配置是否正确。src/tools/browser_tool.py 并添加 API key。