Agent

Reson Agent

可扩展、可学习的 Agent 框架。

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置环境变量

cp .env.example .env
# 编辑 .env，添加你的 API 密钥

3. 创建 Skills

在 skills/ 目录下创建 .md 文件：

---
name: browser-use
description: 浏览器自动化工具使用指南
category: web-automation
---

## When to use
- 需要访问网页、填写表单

## Guidelines
- 先运行 `browser-use state` 查看可点击元素
- 使用元素索引进行交互

4. 运行 Agent

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/               # 示例代码

文档

• 完整文档 - 系统架构和设计
• Skills 指南 - Skills 使用指南
• 工具系统 - 工具系统文档

License

MIT