Qwen3-1.7B新手教程：Jupyter+LangChain快速体验-编程阁

Qwen3-1.7B新手教程：Jupyter+LangChain快速体验

你是不是也试过下载大模型、配环境、写推理脚本，结果卡在API密钥、端口映射或依赖冲突上？别急——这次我们跳过所有“编译焦虑”，用最轻量的方式，在浏览器里直接和Qwen3-1.7B聊起来。不需要GPU服务器，不用装CUDA，不改一行配置文件。只要打开Jupyter Notebook，粘贴三行代码，就能让这个2025年刚开源的千问新旗舰模型开口说话。

本文面向完全没接触过Qwen3的新手：你不需要懂MoE架构，不需要调LoRA参数，甚至不需要知道“base_url”后面那串字符是什么意思。我们会从镜像启动那一刻开始，手把手带你完成一次真实、流畅、有反馈的交互体验，并告诉你每一步为什么这么写、哪里容易出错、怎么一眼看出它真的在思考。

1. 镜像启动与Jupyter环境准备

1.1 一键启动，无需本地部署

Qwen3-1.7B镜像已预置完整运行环境，无需手动安装transformers、vLLM或ollama。你只需在CSDN星图镜像广场中找到该镜像，点击“启动”，系统将自动分配GPU资源并初始化服务。

启动成功后，你会看到类似这样的提示信息：

JupyterLab 已就绪 → 访问地址：https://gpu-pod69523bb78b8ef44ff14daa57-8000.web.gpu.csdn.net → 密码：已自动填入登录框（无需手动输入） → 默认端口：8000（注意不是8888！这是关键）

注意：base_url中的域名（如gpu-pod69523bb78b8ef44ff14daa57-8000.web.gpu.csdn.net）是动态生成的，每次启动都不同。它必须和你当前访问Jupyter的网址完全一致，且端口号固定为8000。复制时请务必核对完整URL，漏掉-8000或误写成8080都会导致连接失败。

1.2 进入Jupyter，创建第一个Notebook

点击链接进入JupyterLab界面后，按以下步骤操作：

点击左上角+号 → 选择Python 3内核
在右侧文件浏览器中，右键 →新建文本文件→ 命名为qwen3_demo.ipynb
双击打开，确保右上角显示Python 3 (ipykernel)

此时你已拥有一个干净、隔离、开箱即用的Python执行环境。所有依赖（包括langchain_openai、httpx、pydantic等）均已预装完毕，可直接导入使用。

1.3 验证基础连通性（可选但推荐）

在第一个代码单元格中运行以下命令，确认网络与服务可达：

import requests url = "https://gpu-pod69523bb78b8ef44ff14daa57-8000.web.gpu.csdn.net/v1/models" headers = {"Authorization": "Bearer EMPTY"} try: resp = requests.get(url, headers=headers, timeout=5) print(" 模型服务响应正常") print("可用模型列表：", resp.json().get("data", [])) except Exception as e: print(" 连接失败，请检查base_url是否正确，或等待镜像完全启动（通常<30秒）") print("错误详情：", str(e))

如果输出模型服务响应正常，说明后端API已就绪；若报错，请暂停下一步，先核对URL——这是新手90%卡住的第一关。

2. LangChain调用Qwen3-1.7B：三步走通链路

2.1 为什么用ChatOpenAI？而不是原生API？

你可能会疑惑：既然有OpenAI兼容接口，为什么不直接用requests.post调用？答案很实在：LangChain封装了流式响应、消息历史、工具调用、错误重试等工程细节，让你专注“问什么”，而不是“怎么问”。

尤其对Qwen3-1.7B这类支持思维链（reasoning）的新模型，LangChain能自动处理extra_body中的结构化参数，避免手动拼JSON、解析SSE流、处理token截断等问题。

2.2 核心代码详解（逐行拆解）

下面这段代码就是全文最关键的“钥匙”，我们逐行解释它在做什么：

from langchain_openai import ChatOpenAI import os chat_model = ChatOpenAI( model="Qwen3-1.7B", temperature=0.5, base_url="https://gpu-pod69523bb78b8ef44ff14daa57-8000.web.gpu.csdn.net/v1", api_key="EMPTY", extra_body={ "enable_thinking": True, "return_reasoning": True, }, streaming=True, )

model="Qwen3-1.7B"：告诉LangChain你要调用的是哪个模型。注意这里不是Hugging Face模型ID，而是服务端注册的模型名称，大小写敏感，不可写成qwen3-1.7b或Qwen3_1.7B
temperature=0.5：控制输出随机性。值越低越确定（适合问答、摘要），越高越发散（适合创意写作）。新手建议保持0.3–0.7之间
base_url：必须带/v1后缀，且端口为8000。这是OpenAI兼容API的标准路径，缺一不可
api_key="EMPTY"：服务端采用无密钥认证，填"EMPTY"是约定俗成写法，填其他字符串会报401
extra_body：这是Qwen3特有参数。enable_thinking=True表示启用思维链推理；return_reasoning=True表示把思考过程（如“让我一步步分析…”）也返回给你，方便调试逻辑
streaming=True：开启流式输出。这意味着模型边想边说，你能实时看到文字逐字出现，体验更自然

2.3 第一次对话：不只是“你是谁？”

运行chat_model.invoke("你是谁？")确实能跑通，但它只返回最终答案，看不到Qwen3的思考过程。要真正体验其能力，我们改用流式调用：

# 启动一次带思考过程的对话 for chunk in chat_model.stream("请用三句话介绍你自己，要求第一句讲身份，第二句讲能力，第三句讲特点"): if chunk.content: # 过滤空内容 print(chunk.content, end="", flush=True)

你会看到类似这样的输出（实际内容以模型为准）：

我是阿里巴巴研发的千问系列第三代大语言模型Qwen3-1.7B，于2025年4月正式开源…… 我支持32K长上下文理解，能处理复杂文档、多轮对话和代码生成任务…… 我的特点是推理能力强、响应速度快，且在中文场景下表现尤为稳定……

成功标志：文字逐字打印，无报错，无卡顿，末尾有标点。这说明LangChain已成功建立连接，并完整接收了Qwen3的流式响应。

3. 实用技巧：让Qwen3更好用的5个方法

3.1 提示词怎么写？给新手的3条铁律

Qwen3-1.7B虽强，但不会读心。好的提示词（Prompt）是高效体验的前提。记住这三条：

角色先行：开头明确指定身份，比如"你是一位资深Python工程师，请帮我优化以下代码……"
任务具体：避免模糊指令，把“写个文案”改成"写一段60字以内、面向Z世代用户的咖啡品牌小红书文案，带emoji和话题标签"
格式约束：用括号注明输出要求，例如（请用JSON格式返回，包含字段：title, summary, tags）

试试这个例子：

prompt = """你是一名电商运营专家。请为‘便携式无线充电宝’生成3个淘宝主图文案，每个不超过20字，突出‘10000mAh’和‘18W快充’两个卖点。用破折号分隔不同文案。""" for chunk in chat_model.stream(prompt): print(chunk.content, end="", flush=True)

3.2 处理长文本：别让输入超限

Qwen3-1.7B支持32768 token上下文，但Jupyter单次请求仍有默认限制。如果你要传入一篇长文章：

正确做法：用messages列表传递多轮对话，把长文本作为user角色的一次输入
错误做法：把整篇PDF文本硬塞进invoke()字符串里

示例（安全传入2000字文本）：

long_text = "（此处粘贴你的长文本，比如产品说明书、会议纪要等）" messages = [ ("system", "你是一名专业摘要助手，请用3句话总结以下内容的核心要点"), ("user", long_text) ] result = chat_model.invoke(messages) print(result.content)

3.3 控制输出长度：比max_tokens更简单的办法

LangChain未暴露max_tokens参数，但你可以用model_kwargs替代：

chat_model = ChatOpenAI( model="Qwen3-1.7B", temperature=0.3, base_url="https://gpu-pod69523bb78b8ef44ff14daa57-8000.web.gpu.csdn.net/v1", api_key="EMPTY", model_kwargs={"max_tokens": 256}, # ← 关键！控制最大生成长度 streaming=True )

3.4 多轮对话：保持上下文不丢失

Qwen3原生支持多轮对话，LangChain通过messages自动维护历史。不要用invoke("问题1"); invoke("问题2")这种割裂方式：

# 正确：构建消息列表，让模型看到完整上下文 messages = [ ("user", "北京今天天气怎么样？"), ("assistant", "北京今天晴，气温18–25℃，空气质量良。"), ("user", "那明天呢？") ] result = chat_model.invoke(messages) print(result.content) # 模型会基于前两轮回答“明天”

3.5 错误排查速查表

现象	最可能原因	解决方案
`ConnectionError`	`base_url`端口不是8000，或域名拼错	复制Jupyter地址栏完整URL，严格匹配
`404 Not Found`	`model`名称写错，或服务未加载模型	运行1.3节的验证代码，检查`resp.json()`中的`data`字段
`401 Unauthorized`	`api_key`没写`"EMPTY"`，或多了空格	检查引号是否为英文，值是否完全一致
输出为空或卡住	`streaming=False`且未处理`content`属性	改用`stream()`或确保调用`result.content`
中文乱码/方块字	Jupyter内核编码异常	重启内核（Kernel → Restart Kernel），再运行

4. 进阶体验：用LangChain链做一件实事

光聊天不过瘾？我们用Qwen3-1.7B+LangChain做一个真实小工具：会议纪要自动生成器。

4.1 场景还原

假设你刚参加完一场20分钟的技术分享，手机录了语音，转成文字后得到约3000字逐字稿。你想快速提取：

3个核心观点
2个待办事项
1句总结

4.2 完整可运行代码

from langchain_core.prompts import ChatPromptTemplate from langchain_core.output_parsers import StrOutputParser # 构建结构化提示模板 prompt = ChatPromptTemplate.from_messages([ ("system", "你是一名专业会议助理。请严格按以下格式输出：\n" "【核心观点】\n1. ...\n2. ...\n3. ...\n\n" "【待办事项】\n1. ...\n2. ...\n\n" "【总结】\n..."), ("user", "{transcript}") ]) # 组装链（无需额外安装组件） chain = prompt | chat_model | StrOutputParser() # 模拟会议记录（实际使用时替换为你的文本） sample_transcript = """ 主持人：今天我们邀请王工分享大模型推理优化实践。王工在阿里云负责Qwen系列模型部署…… 王工：首先，FP8量化让Qwen3-1.7B在A10G上达到120 tokens/s……其次，我们改进了KV缓存复用逻辑……最后，动态批处理使吞吐提升3倍…… Q&A环节：有同学问如何在边缘设备部署？王工答：可结合TensorRT-LLM做INT4压缩…… """ # 执行 result = chain.invoke({"transcript": sample_transcript}) print(result)

运行后，你会得到格式清晰、无需人工整理的结果。这就是LangChain真正的价值：把模型能力封装成可复用、可组合、可交付的“业务模块”。

5. 总结：你已经掌握了Qwen3-1.7B的入门钥匙

回顾这一程，你完成了：

在零配置环境下启动Qwen3-1.7B服务
用LangChain建立稳定、流式、带思考过程的调用链路
掌握提示词设计的3条实战铁律
学会处理长文本、多轮对话、输出控制等高频需求
动手搭建了一个能解决真实问题的会议纪要链

你不需要成为系统工程师，也能驾驭前沿大模型。Qwen3-1.7B的价值，不在于它有多少亿参数，而在于它能把复杂的推理能力，变成你Jupyter里一个.stream()就能调用的函数。

下一步，你可以尝试：

把这个链接入你的Notion数据库，自动生成周报
用RunnableWithMessageHistory加入记忆，做个个人知识助手
或者，回到镜像文档，探索更多extra_body参数，比如enable_search（联网搜索）、tool_choice（调用插件）

技术从不遥远，它就在你敲下第一个chat_model.stream()的那一刻，真正开始流动。

获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。

Qwen3-1.7B新手教程：Jupyter+LangChain快速体验