PyCharm 2026.3 Help

LangSmith

PyCharm 为使用 LangSmith、 LangChain 或 LangGraph 的项目提供专门支持。 它会分析环境文件、LangGraph 配置文件、运行配置和 Python 代码中与 LangSmith 相关的配置。

LangSmith 环境变量

LangSmith 使用环境变量来配置跟踪、身份验证和服务端点。 这些变量可以存储在 .env 和 .env.example 文件中。

PyCharm 会识别这些文件中的 LangSmith 环境变量,并检查其名称和值。 例如:

LANGCHAIN_API_KEY=lsv2_sk_... LANGCHAIN_TRACING_V2=True LANGCHAIN_ENDPOINT=https://eu.api.smith.langchain.com

在此示例中,PyCharm 会检测受支持的旧版 LANGCHAIN_* 变量名称,并建议将其替换为对应的 LANGSMITH_* 名称。

已弃用的 LangSmith 环境变量

使用 重命名所有已弃用的 LangSmith 键 快速修复替换文件中所有受支持的已弃用变量名称。

PyCharm 还会验证 LangSmith 专用值。 例如,它会检测无效的跟踪值或无法识别的 LangSmith 端点主机,并建议有效的替换项。

无效的跟踪值

LangGraph 环境文件

LangGraph 项目可以在 langgraph.json 的 env 属性中声明环境文件。 例如:

{ "dependencies": ["."], "graphs": { "agent": "./my_agent/agent.py:graph" }, "env": ".env" }

PyCharm 会分析此属性,并检查引用的环境文件是否存在。 如果文件不存在,PyCharm 会高亮显示其路径。

LangGraph 环境文件不存在

PyCharm 还会检查在 langgraph.json 中声明的环境文件是否已附加到 Python 运行配置。

如果文件未附加,PyCharm 会在运行配置设置中显示警告。 点击 修复 可自动添加环境文件。

LangGraph 环境文件未附加

硬编码的 LangSmith API 密钥

PyCharm 会检测在 Python 代码中直接传递给 LangSmith 客户端的 LangSmith API 密钥。 例如:

from langsmith import Client client = Client(api_key="lsv2_sk_...")

在此示例中,PyCharm 会高亮显示 API 密钥,并报告其在源代码中被硬编码。 检查建议改为将密钥存储在环境变量中。

硬编码的 LangSmith API 密钥

环境加载顺序

PyCharm 会检测在导入 LangChain 或 LangSmith 模块后调用 load_dotenv() 的情况。 在这种情况下,来自 .env 文件的环境变量可能加载得太晚,无法影响 LangSmith 配置。

from langchain_openai import ChatOpenAI from dotenv import load_dotenv load_dotenv() model = ChatOpenAI()

在此示例中,PyCharm 会高亮显示 load_dotenv() 调用,并建议使用 将 load_dotenv() 移到 LangChain 导入上方 快速修复。

LangSmith 环境加载顺序

该快速修复会将 dotenv 导入和 load_dotenv() 调用移到 LangChain 或 LangSmith 导入之前。

2026年 11月 3日