# 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