推荐语

掌握AI大模型LangChain，从零开始搭建你的入门环境！

核心内容：
1. 2025最新AI大模型agent LangChain入门指南
2. Ubuntu系统与Python环境配置详解
3. 使用pyenv工具安装Python 3.10.12步骤

杨芳贤

53A创始人/腾讯云(TVP)最具价值专家

https://waytoagi.feishu.cn/wiki/NMXLwb0lli3lNGkTWLzcKl39nfV

https://waytoagi.feishu.cn/wiki/X59gwGdzginQgJkfVvQcqKZfn4e

https://waytoagi.feishu.cn/wiki/GGfrwr1AVifiXjk4mM9cICIcnyb

Datawhale-学用 AI,从此开始

https://fmhw1n4zpn.feishu.cn/docx/U3PwdA2utoafCIxChmbcPymnngh

快速入门 |  Langchain

LangChain入门

此处为语雀内容卡片，点击链接查看：https://www.yuque.com/qiaokate/su87gb/iawv1isi0qu6fktx

环境配置：

Ubuntu 18或20都可以

python环境：3.10.12

在Ubuntu系统中安装Python 3.10.12可以通过多种方式完成，以下是几种常见的方法：

方法：使用pyenv安装

pyenv是一个流行的工具，可以方便地管理和安装多个Python版本。

1. 安装依赖包
   在安装pyenv之前，需要安装一些依赖包：

sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \
libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \
xz-utils tk-dev libffi-dev liblzma-dev python-openssl git

1. 安装pyenv
   使用curl或wget安装pyenv：bash复制

curl https://pyenv.run | bash

1. 配置环境变量
   将pyenv初始化脚本添加到你的~/.bashrc或~/.zshrc文件中：bash复制

echo 'export PATH="$HOME/.pyenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init --path)"' >> ~/.bashrc
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
source ~/.bashrc

1. 安装Python 3.10.12
   使用pyenv安装指定版本的Python：bash复制

pyenv install 3.10.12
pyenv global 3.10.12

1. 验证安装
   检查Python版本：bash复制

python --version

vscode安装

搜索》》》code

在vscode安装jupyter

扩展：api key监控（可选）

Langchain的环境和监控_哔哩哔哩_bilibili

可选，监控

以下是在Ubuntu系统上搭建LangChain环境并进行简单使用的详细指南，包含环境配置、安装步骤、基础示例及常见问题解决方案：

pip install langchain_community

pip install openai

尝试运行：

from langchain.llms import OpenAI

llm = OpenAI(openai_api_key="...")

接入火山方舟大模型的deepseek api

Python环境配置

# 安装LangChain核心库及OpenAI兼容模块
pip install langchain-core langchain-openai

火山方舟地址：

https://www.volcengine.com/experience/ark

demo版

from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage

# 配置火山方舟参数
model_name = "ep-20250304123456-7b8r2"  # 替换为你的接入点模型名称
api_key = "volc-xxxxxxxxxx"  # 替换为你的API密钥

# 初始化LangChain模型对象
llm = ChatOpenAI(
    model=model_name,
    openai_api_key=api_key,
    openai_api_base="https://ark.cn-beijing.volces.com/api/v3",  # 火山方舟API地址
    max_tokens=1024,
    temperature=0.8
)

# 发送单轮对话请求
response = llm.invoke([
    HumanMessage(content="用鲁迅的风格写一段关于人工智能的讽刺短文")
])
print(response.content)

实际版

from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage

# 配置火山方舟参数
model_name = "deepseek-r1-distill-qwen-32b-250120"  # 替换为你的接入点模型名称
api_key = "d0334548-xxxx-xxxx-a4c1-2xxxxxxb3"  # 替换为你的API密钥

# 初始化LangChain模型对象
llm = ChatOpenAI(
    model=model_name,
    openai_api_key=api_key,
    openai_api_base="https://ark.cn-beijing.volces.com/api/v3",  # 火山方舟API地址
    max_tokens=1024,
    temperature=0.8
)

# 发送单轮对话请求
response = llm.invoke([
    HumanMessage(content="用鲁迅的风格写一段关于人工智能的讽刺短文")
])
print(response.content)

一、Ubuntu环境准备

安装中文

在Ubuntu中安装中文输入法_ubuntu zhongwenshurufa-CSDN博客

lsb_release 是一个常用的命令，用于显示 Linux 发行版的详细信息。

1. 打开终端（Terminal）。
2. 输入以下命令并按回车：bash复制

lsb_release -a

1. 输出内容中会显示 Distributor ID 和 Release 信息。如果显示如下内容，则说明系统是 Ubuntu 20.04：复制

Distributor ID: Ubuntu
Description:    Ubuntu 20.04 LTS
Release:        20.04
Codename:       focal

如果你不确定当前使用的桌面环境，可以通过以下命令查看：

bash复制

echo $XDG_CURRENT_DESKTOP

如果输出为 GNOME，则说明你正在使用 GNOME 桌面环境

sudo apt install ibus
sudo apt install ibus-gtk ibus-gtk3
sudo apt install ibus-pinyin

有时候看不到下图，需要重启一下系统

按win+空格==切换输入法（有时候抽风，不好用...)

2. 创建虚拟环境（推荐）

避免依赖冲突，建议使用虚拟环境：

python3 -m venv langchain-env  # 创建虚拟环境
source langchain-env/bin/activate  # 激活环境

退出虚拟环境：deactivate (#evidence21)

二、安装LangChain及依赖

1. 安装基础包

pip install langchain  # 最低依赖版本 (#evidence11)

2. 安装扩展依赖（按需）

• 常用LLM支持
  （如OpenAI、HuggingFace）：

pip install langchain[llms]

• 完整集成
  （所有模块）：

pip install 'langchain[all]'  # 注意zsh需加引号 (#evidence13)

3. 其他工具安装

• LangSmith（可选）
   ：开发者平台集成

pip install langsmith

• LangServe（API部署）
  ：

pip install "langserve[all]"

三、简单使用示例

1. 获取OpenAI API密钥

1. 访问 OpenAI官网 注册/登录。
2. 进入 API Keys 页面，点击 Create new secret key。
3. 复制生成的密钥并妥善保存（页面关闭后不可见）(#evidence31)。

2. 示例代码：调用OpenAI模型

from langchain.llms import OpenAI

# 初始化模型（替换为你的API密钥）
llm = OpenAI(api_key="your-api-key")

# 发送请求
response = llm("请用一句话解释量子计算")
print(response)

3. 其他基础功能

• Prompt模板
  ：

from langchain import PromptTemplate

template = "你好，{name}！今天有什么计划？"
prompt = PromptTemplate(input_variables=["name"], template=template)
formatted_prompt = prompt.format(name="Alice")
print(formatted_prompt)  # 输出：你好，Alice！今天有什么计划？ (#evidence23)

四、常见问题及解决

1. Python版本不兼容

• 现象
  ：ModuleNotFoundError: No module named 'langchain' 或依赖报错。
• 解决
  ：

• 确保Python ≥3.8.1：python3 --version
• 升级Python或使用虚拟环境（参考步骤一）(#evidence43)。

2. 依赖项缺失

• 现象
  ：安装后无法导入模块。
• 解决
  ：

pip install langchain[llms]  # 补充安装LLM依赖
# 或手动安装特定包（如缺少requests）
pip install requests

3. 网络问题

• 现象
  ：pip install 下载超时。
• 解决
  ：

• 更换国内镜像源：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple langchain

• 使用代理（如有）：export http_proxy="[http://your-proxy:port](http://your-proxy:port)" (#evidence44)。

4. 权限问题

• 现象
  ：Permission denied 错误。
• 解决
  ：

• 使用虚拟环境（避免系统路径权限限制）。
• 或添加 --user 参数：pip install --user langchain (#evidence47)。

五、进阶配置建议

1. 使用LangChain社区集成

• 向量数据库
  （如Chroma）：

pip install chromadb

• 文档加载器
  （如PDF）：

sudo apt install poppler-utils  # Ubuntu依赖
pip install unstructured[all-docs]

2. 版本管理

• 升级LangChain至最新版：

pip install --upgrade langchain

• 固定版本（避免兼容性问题）：

pip install langchain==0.0.268

六、参考资料

• LangChain官方文档：详细API说明及案例。
• GitHub仓库：最新源码及社区讨论。

通过以上步骤，您可以在Ubuntu系统上顺利搭建LangChain环境，并实现基础功能开发。遇到问题时，优先检查Python版本和依赖项完整性，多数问题可通过社区资源解决。