---
title: GAIA Agent
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.5.0
app_file: app.py
pinned: false
license: mit
hf_oauth: true
hf_oauth_expiration_minutes: 480
---

# GAIA Agent

基于 LangGraph 的 GAIA 基准测试 Agent，用于 HuggingFace Agents Course Unit 4 评测。

## 功能特点

- **ReAct 架构**: 基于 LangGraph StateGraph 实现的推理-行动循环
- **多种搜索工具**: DuckDuckGo、Wikipedia、arXiv、Tavily、YouTube、StackOverflow
- **文件处理**: 支持 PDF、Excel、图片 OCR、音频转写
- **代码执行**: 安全的 Python 沙箱环境
- **RAG 支持**: 可选的知识库检索增强

## 工具列表

| 工具 | 功能 |
|------|------|
| `web_search` | DuckDuckGo 网络搜索 |
| `wikipedia_search` | 维基百科搜索 |
| `arxiv_search` | arXiv 学术论文搜索 |
| `tavily_search` | Tavily 高质量搜索 |
| `fetch_task_files` | 下载任务附件 |
| `read_file` | 读取本地文件 |
| `parse_pdf` | 解析 PDF 文件 |
| `parse_excel` | 解析 Excel 文件 |
| `calc` | 安全数学计算 |
| `run_python` | Python 代码执行 |

## 环境变量

在 HuggingFace Spaces 的 Settings > Secrets 中配置：

| 变量 | 必需 | 说明 |
|------|------|------|
| `OPENAI_API_KEY` | 是 | OpenAI API Key |
| `OPENAI_BASE_URL` | 否 | 自定义 API 端点 |
| `MODEL` | 否 | 模型名称，默认 gpt-4o-mini |
| `TAVILY_API_KEY` | 否 | Tavily API Key（可选） |

## 本地运行

```bash
# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入 API Key

# 启动应用
python app.py
```

访问 http://localhost:7860

## 技术栈

- [LangGraph](https://github.com/langchain-ai/langgraph) - Agent 框架
- [LangChain](https://github.com/langchain-ai/langchain) - LLM 工具链
- [Gradio](https://gradio.app/) - Web UI 框架
- [FAISS](https://github.com/facebookresearch/faiss) - 向量检索

## 许可证

MIT License