# weh-langchain-agent-demo

**Repository Path**: weh_coder/weh-langchain-agent-demo

## Basic Information

- **Project Name**: weh-langchain-agent-demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Weh LangChain Agent Demo

[Chinese: Weh LangChain Agent 演示项目]

## 项目简介

本项目是一个基于 LangChain 的 Agent 演示项目，展示了如何使用 LangChain 框架构建具有记忆功能的 AI Agent。项目中集成了多种工具和记忆组件，适用于构建智能对话系统。

## 功能特性

- **LLM 工具集成**: 提供基于大语言模型的智能工具
- **记忆系统**: 支持多种记忆存储方式
  - 基础内存管理
  - Redis 分布式内存存储
  - 可扩展的内存存储接口
- **检索工具**: 支持知识检索功能
- **搜索集成**: 集成 Tavily 搜索引擎

## 项目结构

```
├── agent_tools_llm.py          # LLM 工具定义
├── agent_tools_llm_memory.py   # 内存管理基础功能
├── agent_tools_llm_memory_redis.py  # Redis 内存存储实现
├── agent_tools_llm_memory_store.py  # 内存存储抽象接口
├── tools_llm.py                # LLM 相关工具
├── tools_retriever.py          # 检索工具
└── tools_tavily.py             # Tavily 搜索工具
```

## 核心组件

### 1. Agent 工具 (agent_tools_llm.py)
提供 Agent 核心功能的工具类定义。

### 2. 记忆系统
- **agent_tools_llm_memory.py**: 基础内存功能
- **agent_tools_llm_memory_redis.py**: 基于 Redis 的分布式会话历史存储
  - `get_history(user_id, conversation_id)`: 获取指定用户和会话的历史记录
- **agent_tools_llm_memory_store.py**: 统一的内存存储接口
  - `get_history(session_id)`: 获取会话历史

### 3. 工具集
- **tools_llm.py**: LLM 相关工具
- **tools_retriever.py**: 文档检索工具
- **tools_tavily.py**: Tavily 搜索引擎集成

## 快速开始

### 环境要求

- Python 3.8+
- Redis (用于分布式内存存储)

### 安装依赖

```bash
pip install langchain redis
```

### 配置说明

1. 设置环境变量或配置文件
2. 根据需要配置 Redis 连接
3. 配置 LLM API 密钥

## 使用示例

```python
# 导入所需模块
from agent_tools_llm_memory_redis import get_history
from agent_tools_llm_memory_store import get_history as get_store_history

# 获取会话历史
history = get_history(user_id="user123", conversation_id="conv456")

# 使用检索工具
from tools_retriever import retriever_tool
```

## 技术栈

- **LangChain**: LLM 应用开发框架
- **Redis**: 分布式会话存储
- **Tavily**: 搜索引擎 API

## 许可证

本项目仅供学习交流使用。

## 作者

weh_coder

---

更多用法请参考各模块的具体实现和注释。