Ai大模型agent LangChain入门环境搭建2025最新

真的从0到1，跑出代码！（可能格式问题，电脑浏览器更佳！）

因为自己淋过雨，所以想给你打把伞~

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版本。

安装依赖包
在安装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

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

curl https://pyenv.run | bash

配置环境变量
将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

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

pyenv install 3.10.12
pyenv global 3.10.12

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

python --version

vscode安装

搜索》》》code

在vscode安装jupyter

扩展：api key监控（可选）

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

可选，监控

Ai大模型agent LangChain入门环境搭建2025最新以下是在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 发行版的详细信息。

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

lsb_release -a

输出内容中会显示 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密钥

访问 OpenAI官网注册/登录。
进入 API Keys 页面，点击 Create new secret key。
复制生成的密钥并妥善保存（页面关闭后不可见）(#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版本和依赖项完整性，多数问题可通过社区资源解决。

{{userData.name}}已认证

Ai大模型agent LangChain入门环境搭建2025最新

python环境：3.10.12

方法：使用`pyenv`安装

vscode安装

Python环境配置

一、Ubuntu环境准备

安装中文

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

二、安装LangChain及依赖

1. 安装基础包

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

3. 其他工具安装

三、简单使用示例

1. 获取OpenAI API密钥

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

3. 其他基础功能

四、常见问题及解决

1. Python版本不兼容

2. 依赖项缺失

3. 网络问题

4. 权限问题

五、进阶配置建议

1. 使用LangChain社区集成

2. 版本管理

六、参考资料

扣子/coze智能体开发的经验与避坑指南

🤯 终于搞懂了！LLM、RAG 和 AI Agents 到底是什么关系？

{{userData.name}}已认证

python环境：3.10.12

方法：使用pyenv安装

vscode安装

Python环境配置

一、Ubuntu环境准备

安装中文

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

二、安装LangChain及依赖

1. 安装基础包

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

3. 其他工具安装

三、简单使用示例

1. 获取OpenAI API密钥

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

3. 其他基础功能

四、常见问题及解决

1. Python版本不兼容

2. 依赖项缺失

3. 网络问题

4. 权限问题

五、进阶配置建议

1. 使用LangChain社区集成

2. 版本管理

六、参考资料

扣子/coze智能体开发的经验与避坑指南

🤯 终于搞懂了！LLM、RAG 和 AI Agents 到底是什么关系？

方法：使用`pyenv`安装