这一篇把 LangSmith 接到现有项目：注册账号、创建 API Key、写入环境变量。三步完成后，运行 LangChain 代码就会自动上报调用记录。
13.1 注册或登录
访问 LangSmith 官网：https://smith.langchain.com/。首次进入先选择数据区域（US Central 或 EU West），页面会提示这个选择之后不能修改。然后可以选择 Google、GitHub、Discord 账号，或用邮箱注册。
登录成功后进入欢迎页，页面上会显示 Tracing、Studio、Playground、Experiment 的完成进度，以及最近 7 天的项目和数据集。
13.2 获取 API Key
步骤 1：打开设置。在左下角找到 Settings，进入 API Keys 页面。页面上方会提示：API Key 只在创建时展示一次，如果丢失，只能重新创建一个。
步骤 2：创建 API Key。点击右上角「+ API Key」，填写 Description（名称），选择 Key Type：
- Personal Access Token：以个人身份调用 API，适合本地开发和日常使用；
- Service Key：绑定服务主体，适合自动化和 CI 工作流。
再选择默认 Workspace 和过期时间（Never、30d、90d、1 year 或 Custom），最后点击 Create API Key。
步骤 3：保存 Key。创建成功后会弹出「Copy your new API key」，点击 Copy 把 Key 复制到剪贴板。这个窗口关闭后，官网就再也看不到 Key 的完整内容了，务必先存到安全的地方。
回到列表可以看到已创建的 Key，包含描述、工作区、创建时间、最近使用时间和过期时间。
步骤 4（可选）：删除 Key。不再使用的 Key，点击右侧删除图标，在确认弹窗中选 Delete 即可。
13.3 新增环境变量
在项目的 .env 文件中添加四个变量：
# 是否启用 LangSmith 监控
LANGSMITH_TRACING=true
# LangSmith API 地址（注意不是 WebUI 地址）
LANGSMITH_ENDPOINT=https://api.smith.langchain.com
# 上一步创建的 API Key
LANGSMITH_API_KEY=<YOUR_API_KEY>
# 自定义项目名称，WebUI 会按这个名称归类运行记录
LANGSMITH_PROJECT=pr-clear-harmony-32四个变量的作用分别是：
LANGSMITH_TRACING：设为true才会上报；设为false或删除则不记录。LANGSMITH_ENDPOINT：API 接收端，不是浏览器里打开的smith.langchain.com。LANGSMITH_API_KEY：账号里创建的 Key，属于敏感信息。LANGSMITH_PROJECT：项目名，用来在 WebUI 中区分不同应用或不同实验；建议显式设置。
代码中通过 load_dotenv() 把变量加载进环境，override=True 表示 .env 优先：
from dotenv import load_dotenv
load_dotenv(override=True)安全提醒：.env 里现在有 API Key，务必加入 .gitignore，不要提交到仓库；也不要把 Key 写进文章、截图或日志。
13.4 小结
账号侧只需要记住三件事：数据区域注册后不可改；API Key 只展示一次，先保存再关窗口；四个环境变量里，Tracing 开关、API 地址、Key、项目名缺一不可。
下一篇：LangChain 1.2 入门（十四）：用 LangSmith 查看追踪与监控指标；上一篇：LangSmith 是什么。
本文根据公开课程课件整理，并结合 LangSmith 官方文档核对与补充。