橙心橙怡1. LangChain v1.2 入门指南：构建你的第一个AI Agent
十年前我第一次接触NLP技术时，需要手动拼接各种API和规则引擎。如今LangChain这样的框架让AI应用开发变得像搭积木一样简单。最近在团队内部培训时，我特意用v1.2版本设计了这套入门方案，帮你避开我当年踩过的坑。
这个教程适合三类开发者：
- 想转型AI开发的Python程序员
- 需要快速验证创意的产品经理
- 在校学习NLP相关专业的学生
你将获得：
- 完整的开发环境配置指南（含Pipenv虚拟环境管理）
- 从零实现可运行的对话式Agent
- 关键参数调优的实战技巧
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具链配置
2.1 Python环境精校方案
推荐使用Python 3.10+版本，这是目前与LangChain兼容性最好的稳定版本。我在Windows/Mac/Linux三平台测试时发现几个关键点：
bash复制# 验证Python版本
python --version
# 应显示3.10.x或更高
# 安装Pipenv（比virtualenv更现代的选择）
pip install --user pipenv
注意：不要直接使用系统Python，建议通过pyenv管理多版本。我在Ubuntu 22.04上测试时，系统自带的Python 3.8会导致依赖冲突。
2.2 开发环境实战配置
VSCode配置建议安装以下扩展：
- Python (Microsoft官方)
- Pylance (类型提示支持)
- Jupyter (交互式开发)
新建项目目录后执行：
bash复制pipenv install langchain==1.2 openai tiktoken
这里特别说明版本锁定的重要性：v1.2引入了新的AgentExecutor架构，与旧版API不兼容。tiktoken用于精确计算token消耗，避免超额费用。
3. 第一个Agent的完整实现
3.1 OpenAI密钥安全管理
永远不要将API密钥硬编码在代码中！我推荐两种专业做法：
python复制# 方法1：环境变量（生产环境推荐）
import os
from langchain.llms import OpenA