|
|
@@ -1,92 +0,0 @@
|
|
|
-# Reson Agent
|
|
|
-
|
|
|
-可扩展、可学习的 Agent 框架。
|
|
|
-
|
|
|
-## 快速开始
|
|
|
-
|
|
|
-### 1. 安装依赖
|
|
|
-
|
|
|
-```bash
|
|
|
-pip install -r requirements.txt
|
|
|
-```
|
|
|
-
|
|
|
-### 2. 配置环境变量
|
|
|
-
|
|
|
-```bash
|
|
|
-cp .env.example .env
|
|
|
-# 编辑 .env，添加你的 API 密钥
|
|
|
-```
|
|
|
-
|
|
|
-### 3. 创建 Skills
|
|
|
-
|
|
|
-在 `skills/` 目录下创建 `.md` 文件：
|
|
|
-
|
|
|
-```markdown
|
|
|
----
|
|
|
-name: browser-use
|
|
|
-description: 浏览器自动化工具使用指南
|
|
|
-category: web-automation
|
|
|
----
|
|
|
-
|
|
|
-## When to use
|
|
|
-- 需要访问网页、填写表单
|
|
|
-
|
|
|
-## Guidelines
|
|
|
-- 先运行 `browser-use state` 查看可点击元素
|
|
|
-- 使用元素索引进行交互
|
|
|
-```
|
|
|
-
|
|
|
-### 4. 运行 Agent
|
|
|
-
|
|
|
-```python
|
|
|
-from agent import AgentRunner
|
|
|
-from agent.llm.providers.gemini import create_gemini_llm_call
|
|
|
-import os
|
|
|
-
|
|
|
-runner = AgentRunner(
|
|
|
- llm_call=create_gemini_llm_call(os.getenv("GEMINI_API_KEY"))
|
|
|
-)
|
|
|
-
|
|
|
-async for event in runner.run(
|
|
|
- task="从网站提取数据",
|
|
|
- tools=["skill", "list_skills", "bash"],
|
|
|
- model="gemini-2.0-flash-exp"
|
|
|
-):
|
|
|
- if event.type == "conclusion":
|
|
|
- print(event.data["content"])
|
|
|
-```
|
|
|
-
|
|
|
-## 功能特性
|
|
|
-
|
|
|
-- 📚 **Skills 管理**: 使用 Markdown 文件定义领域知识
|
|
|
-- 🔧 **按需加载**: Agent 通过 `skill` 工具按需加载 skills
|
|
|
-- 🛠️ **工具系统**: 装饰器风格的工具定义和自动注册
|
|
|
-- 📊 **执行追踪**: 完整的 Trace 和 Step 记录
|
|
|
-
|
|
|
-## 项目结构
|
|
|
-
|
|
|
-```
|
|
|
-.
|
|
|
-├── agent/ # 核心框架
|
|
|
-│ ├── runner.py # Agent 执行引擎
|
|
|
-│ ├── models/ # 数据模型
|
|
|
-│ ├── storage/ # 存储接口和实现
|
|
|
-│ │ └── skill_loader.py # Skills 加载器
|
|
|
-│ ├── tools/ # 工具系统
|
|
|
-│ └── llm/ # LLM 提供者
|
|
|
-├── tools/ # 工具实现
|
|
|
-│ └── skill.py # Skill 工具
|
|
|
-├── skills/ # Skills 库
|
|
|
-│ └── browser-use.md
|
|
|
-└── examples/ # 示例代码
|
|
|
-```
|
|
|
-
|
|
|
-## 文档
|
|
|
-
|
|
|
-- [完整文档](docs/README.md) - 系统架构和设计
|
|
|
-- [Skills 指南](docs/skills.md) - Skills 使用指南
|
|
|
-- [工具系统](docs/tools.md) - 工具系统文档
|
|
|
-
|
|
|
-## License
|
|
|
-
|
|
|
-MIT
|
Talegorithm