LangChain 接入 DeepSeek 时，应优先使用当前官方集成包和模型类，先跑通单轮消息，再叠加智能体、流式或工具调用。 示例未对你的 DeepSeek 账号、网络或套餐实测；模型名、价格、上下文与功能支持会变化，以 LangChain 集成页和 DeepSeek 当前官方控制台为准。
本篇验收要点：安装当前集成包，把 DEEPSEEK_API_KEY 放入环境变量，并用 ChatDeepSeek 指定目标模型。 调用 invoke 后检查 content 非空、response_metadata 中的模型信息和 usage_metadata，而不是只打印一句回答。
安装独立集成并设置环境变量
在虚拟环境中安装官方集成页当前列出的 langchain-deepseek。Windows PowerShell 可在当前会话设置变量，生产环境应使用密钥管理服务。
$env:DEEPSEEK_API_KEY='从安全位置注入，不要写进脚本'
执行一条最小消息
from langchain_deepseek import ChatDeepSeek
model = ChatDeepSeek(
model="deepseek-chat",
temperature=0,
max_retries=2,
)
response = model.invoke([
("system", "Answer with one integer only."),
("human", "What is 7 multiplied by 8?"),
])
print(response.content)
print(response.response_metadata)
print(response.usage_metadata)
assert response.content.strip() == "56"
按错误类型排查
401 检查密钥是否加载到启动该 Python 进程的环境；模型不存在要核对当前模型名；429 可能是速率或余额；连接超时要从运行机器检查 DNS、代理和服务状态。重试只用于可能恢复的网络或限流错误，不要对认证失败无限重试。
单轮调用稳定后，再逐项增加 streaming、tool calling 或 create_agent，每加一项都保留最小回归用例。
读者下一步是创建只用于当前项目的 API 密钥并写入本地环境变量，确认不会提交到版本库。
验证标准是请求成功、响应文本与固定问题相符、元数据能确认实际模型和用量；使用错误密钥时程序明确报认证失败。
常见问题
可以改成 OpenAI 兼容基址吗？
有些项目这样做，但当前 LangChain 已提供专门集成时，优先使用官方集成更容易获得明确能力和元数据。
为什么环境变量已经设置仍读不到？
环境变量只对相应进程及其子进程生效。重新启动终端或应用，并避免在日志中打印变量值。
官方资料与适用边界
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/31164.html
