# langchain

**Repository Path**: jzcode/langchain

## Basic Information

- **Project Name**: langchain
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LangChain + 腾讯云混元大模型 Demo 项目

基于 Python 的 LangChain 开发示例，对接腾讯云混元（Hunyuan）大模型。

## 项目结构

```
langchain/
├── .env.example        # 环境变量模板
├── .env                # 真实密钥（不提交到 Git）
├── .gitignore
├── requirements.txt    # 依赖列表
├── demo_basic.py       # 基础对话示例（原生 ChatHunyuan）
├── demo_chain.py       # LCEL 链式调用示例（OpenAI 兼容接口）
└── README.md
```

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置 API Key

复制环境变量模板并填入真实密钥：

```bash
cp .env.example .env
```

编辑 `.env` 文件：

```env
HUNYUAN_SECRET_ID=你的腾讯云SecretId
HUNYUAN_SECRET_KEY=你的腾讯云SecretKey
```

> **获取密钥**: 登录[腾讯云控制台](https://console.cloud.tencent.com/) → 访问管理 → 访问密钥 → 新建密钥

### 3. 运行 Demo

```bash
# 基础对话示例（使用 ChatHunyuan 原生集成）
python demo_basic.py

# 链式调用示例（使用 OpenAI 兼容接口）
python demo_chain.py
```

---

## Demo 说明

### `demo_basic.py` — 基础对话

| 示例 | 说明 |
|------|------|
| 简单单轮对话 | 直接向模型发送消息并获取回复 |
| 带系统提示词 | 通过 `SystemMessage` 设置角色和行为 |
| 多轮对话 | 维护历史消息实现上下文连续对话 |
| 流式输出 | 实时输出模型生成的 token |

### `demo_chain.py` — LCEL 链式调用

| 示例 | 说明 |
|------|------|
| 基础 Chain | `prompt \| llm \| parser` 管道 |
| 结构化输出 | 使用 `JsonOutputParser` 解析 JSON |
| RAG 风格 Chain | 将检索上下文注入 Prompt |
| 顺序 Chain | 多步骤串联（摘要 → 翻译） |

---

## 接入方式说明

### 方式一：LangChain 原生集成（`demo_basic.py`）

使用 `langchain-community` 中的 `ChatHunyuan`，通过腾讯云 SDK 鉴权：

```python
from langchain_community.chat_models import ChatHunyuan

llm = ChatHunyuan(
    hunyuan_secret_id=os.getenv("HUNYUAN_SECRET_ID"),
    hunyuan_secret_key=os.getenv("HUNYUAN_SECRET_KEY"),
    model="hunyuan-pro",
)
```

### 方式二：OpenAI 兼容接口（`demo_chain.py`）

腾讯混元提供 OpenAI 兼容 API，可直接使用 `langchain-openai`：

```python
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="hunyuan-pro",
    api_key=os.getenv("HUNYUAN_SECRET_ID"),
    base_url="https://api.hunyuan.cloud.tencent.com/v1",
)
```

---

## 可用模型

| 模型名称 | 说明 |
|----------|------|
| `hunyuan-lite` | 轻量版，响应速度快，适合简单任务 |
| `hunyuan-standard` | 标准版，均衡性能 |
| `hunyuan-pro` | 旗舰版，最强性能，适合复杂推理 |

## 参考文档

- [腾讯混元大模型 API 文档](https://cloud.tencent.com/document/product/1729)
- [LangChain 官方文档](https://python.langchain.com/)
- [LangChain ChatHunyuan 集成](https://python.langchain.com/docs/integrations/chat/hunyuan)