README.md

metadata

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（可选）

本地运行

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

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

# 启动应用
python app.py

访问 http://localhost:7860

技术栈

• LangGraph - Agent 框架
• LangChain - LLM 工具链
• Gradio - Web UI 框架
• FAISS - 向量检索

许可证

MIT License