Metadata-Version: 2.4
Name: consultant-agent
Version: 0.2.0
Summary: 一个专业的咨询顾问 AI Agent，支持文档分析、联网搜索、报告生成
Author: xiaoboluo
License: MIT
Project-URL: Homepage, https://github.com/xiaoboluo/consultant-agent
Project-URL: Repository, https://github.com/xiaoboluo/consultant-agent
Project-URL: Documentation, https://github.com/xiaoboluo/consultant-agent#readme
Keywords: ai,agent,consultant,llm,langchain,document-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: langchain>=0.2.0
Requires-Dist: langchain-openai>=0.1.0
Requires-Dist: langgraph>=0.1.0
Requires-Dist: pdfplumber>=0.10.0
Requires-Dist: python-docx>=1.0.0
Requires-Dist: python-pptx>=0.6.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: duckduckgo-search>=6.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: ruff>=0.3.0; extra == "dev"
Provides-Extra: web
Requires-Dist: gradio>=4.0.0; extra == "web"
Requires-Dist: fastapi>=0.110.0; extra == "web"
Requires-Dist: uvicorn>=0.27.0; extra == "web"
Provides-Extra: ocr
Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
Requires-Dist: pillow>=10.0.0; extra == "ocr"
Requires-Dist: pymupdf>=1.23.0; extra == "ocr"

# Consultant Agent

一个专业的咨询顾问 AI Agent，支持文档分析、联网搜索、报告生成。

## 功能特性

- **文档分析**: 支持 PDF、Word、Excel、PowerPoint 文档解析
- **联网搜索**: 使用 DuckDuckGo 搜索最新信息
- **报告生成**: 基于模板自动生成专业分析报告
- **多 Agent 协作**: 支持多 Agent 并行处理复杂任务
- **Plan 模式**: 支持分步骤规划和执行复杂任务

## 安装

```bash
pip install consultant-agent
```

安装可选依赖：

```bash
# Web 界面支持
pip install consultant-agent[web]

# OCR 支持
pip install consultant-agent[ocr]

# 开发依赖
pip install consultant-agent[dev]
```

## 快速开始

### 命令行使用

```bash
# 设置 API Key
export DEEPSEEK_API_KEY=your_api_key

# 运行单次查询
consultant-agent "帮我搜索一下最新的AI新闻"

# 交互模式
consultant-agent --interactive
```

### Python API

```python
from consultant_agent import create_agent, run_agent

# 创建 Agent
agent = create_agent()

# 运行查询
result = run_agent(agent, "帮我分析这份报告")

# 流式输出
run_agent(agent, "搜索最新新闻", stream=True)
```

### 使用工具

```python
from consultant_agent.tools import register_all_tools, get_langchain_tools

# 注册所有工具
register_all_tools()

# 获取 LangChain 格式的工具
tools = get_langchain_tools()

# 自定义 Agent
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

llm = ChatOpenAI(model="gpt-4")
agent = create_react_agent(llm, tools)
```

## 支持的工具

| 工具 | 描述 |
|------|------|
| `read_file` | 读取文件内容 |
| `write_file` | 写入文件 |
| `edit_file` | 编辑文件 |
| `list_files` | 列出目录文件 |
| `run_command` | 执行命令行命令 |
| `web_search` | 联网搜索 |
| `read_url` | 读取网页内容 |
| `read_pdf` | 读取 PDF 文件 |
| `read_docx` | 读取 Word 文档 |
| `read_excel` | 读取 Excel 文件 |
| `analyze_excel` | 分析 Excel 数据 |
| `read_pptx` | 读取 PowerPoint |
| `summarize` | 文本摘要 |

## 环境变量

| 变量 | 描述 | 默认值 |
|------|------|--------|
| `DEEPSEEK_API_KEY` | DeepSeek API Key | - |
| `OPENAI_API_KEY` | OpenAI API Key (可选) | - |

## 版本历史

### v0.2.0
- 修复 API Key 延迟初始化问题
- 优化包结构
- 添加 CLI 命令

### v0.1.0
- 初始版本发布

## License

MIT License
