Metadata-Version: 2.4
Name: consultant-agent
Version: 0.1.0
Summary: 一个专业的咨询顾问 AI Agent，支持文档分析、联网搜索、报告生成
Project-URL: Homepage, https://github.com/xiaoboluo/consultant-agent
Project-URL: Repository, https://github.com/xiaoboluo/consultant-agent
Author-email: xiaoboluo <your@email.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,consultant,langchain,llm
Classifier: Development Status :: 3 - Alpha
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
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: ddgs>=6.0.0
Requires-Dist: langchain-openai>=0.1.0
Requires-Dist: langchain>=0.2.0
Requires-Dist: langgraph>=0.1.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: pdfplumber>=0.10.0
Requires-Dist: python-docx>=1.0.0
Requires-Dist: python-pptx>=0.6.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: black>=24.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.3.0; extra == 'dev'
Provides-Extra: ocr
Requires-Dist: pillow>=10.0.0; extra == 'ocr'
Requires-Dist: pymupdf>=1.23.0; extra == 'ocr'
Requires-Dist: pytesseract>=0.3.10; extra == 'ocr'
Provides-Extra: web
Requires-Dist: fastapi>=0.110.0; extra == 'web'
Requires-Dist: gradio>=4.0.0; extra == 'web'
Requires-Dist: uvicorn>=0.27.0; extra == 'web'
Description-Content-Type: text/markdown

# Consultant Agent 🤖

一个专业的咨询顾问 AI Agent，一行命令安装，开箱即用。

[![PyPI version](https://badge.fury.io/py/consultant-agent.svg)](https://pypi.org/project/consultant-agent/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## ✨ 特性

- 🔍 **联网搜索** - 实时获取最新信息
- 📄 **文档阅读** - 支持 PDF、Word、Excel、PPT
- 📊 **数据分析** - Excel 数据处理与分析
- 📝 **内容生成** - 报告大纲、竞品对比、内容总结
- 🛠️ **易于集成** - 可作为工具嵌入其他 Agent
- 💾 **对话记忆** - 自动保存上下文

## 🚀 快速开始

### 安装

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

### 设置 API Key

```bash
# Linux/Mac
export DEEPSEEK_API_KEY="sk-your-api-key"

# Windows
set DEEPSEEK_API_KEY=sk-your-api-key
```

> 💡 去 [DeepSeek 开放平台](https://platform.deepseek.com/) 获取 API Key

### 使用

**命令行交互**
```bash
consultant
```

**单次提问**
```bash
consultant ask "北京今天天气怎么样"
consultant ask "帮我生成一个 AI Agent 技术发展的报告大纲"
```

**Python 代码**
```python
from consultant_agent import ConsultantAgent

agent = ConsultantAgent()
reply = agent.ask("分析一下新能源汽车行业趋势")
print(reply)
```

## 📖 功能详解

### 命令行命令

| 命令 | 说明 | 示例 |
|------|------|------|
| `consultant` | 交互式对话 | - |
| `consultant ask "问题"` | 单次提问 | `consultant ask "上海天气"` |
| `consultant clear` | 清空记忆 | - |

### Python API

```python
from consultant_agent import ConsultantAgent

# 基础用法
agent = ConsultantAgent()
reply = agent.ask("你的问题")

# 自定义配置
agent = ConsultantAgent(
    api_key="sk-xxx",           # 可选，默认从环境变量读取
    model="deepseek-chat",      # 模型名称
    temperature=0,              # 温度参数
    enable_memory=True,         # 启用记忆
)

# 清空记忆
agent.clear_memory()
```

### 作为工具嵌入其他 Agent

```python
from consultant_agent import ConsultantAgent
from langgraph.prebuilt import create_react_agent

# 创建咨询顾问
consultant = ConsultantAgent()

# 转换为工具
consultant_tool = consultant.as_tool()

# 在你的 Agent 中使用
your_agent = create_react_agent(
    your_llm,
    tools=[consultant_tool, your_other_tools...]
)
```

## 🎯 支持的功能

| 功能 | 说明 | 示例 |
|------|------|------|
| 天气查询 | 全球城市天气 | "北京天气" |
| 数学计算 | 表达式计算 | "计算 123 * 456" |
| 联网搜索 | DuckDuckGo 搜索 | "搜索 AI Agent 最新进展" |
| 网页抓取 | 读取网页内容 | "读取 https://example.com" |
| PDF 阅读 | 提取 PDF 文字 | "读取 report.pdf" |
| Word 阅读 | 读取 docx 文档 | "读取 document.docx" |
| Excel 阅读 | 读取表格数据 | "读取 data.xlsx" |
| PPT 阅读 | 提取幻灯片文字 | "读取 slides.pptx" |
| 内容总结 | 多种总结风格 | "总结这篇文章" |
| 报告大纲 | 生成专业大纲 | "生成 XX 报告大纲" |
| 竞品对比 | 多维度对比表 | "对比 A、B、C 产品" |
| 案例搜索 | 查找行业案例 | "搜索数字化转型案例" |

## ⚙️ 环境变量

| 变量 | 必须 | 说明 |
|------|------|------|
| `DEEPSEEK_API_KEY` | ✅ | DeepSeek API Key |

## 📦 可选依赖

```bash
# OCR 功能（识别图片/PDF 中的文字）
pip install consultant-agent[ocr]

# Web 界面
pip install consultant-agent[web]

# 完整安装
pip install consultant-agent[ocr,web]
```

## 🤝 贡献

欢迎 Issue 和 PR！

## 📄 许可证

MIT License
