LangSmith
PyCharm 为使用 LangSmith、 LangChain 或 LangGraph 的项目提供专门支持。 它会分析环境文件、LangGraph 配置文件、运行配置和 Python 代码中与 LangSmith 相关的配置。
LangSmith 环境变量
LangSmith 使用环境变量来配置跟踪、身份验证和服务端点。 这些变量可以存储在 .env 和 .env.example 文件中。
PyCharm 会识别这些文件中的 LangSmith 环境变量,并检查其名称和值。 例如:
在此示例中,PyCharm 会检测受支持的旧版 LANGCHAIN_* 变量名称,并建议将其替换为对应的 LANGSMITH_* 名称。

使用 重命名所有已弃用的 LangSmith 键 快速修复替换文件中所有受支持的已弃用变量名称。
PyCharm 还会验证 LangSmith 专用值。 例如,它会检测无效的跟踪值或无法识别的 LangSmith 端点主机,并建议有效的替换项。

LangGraph 环境文件
LangGraph 项目可以在 langgraph.json 的 env 属性中声明环境文件。 例如:
PyCharm 会分析此属性,并检查引用的环境文件是否存在。 如果文件不存在,PyCharm 会高亮显示其路径。

PyCharm 还会检查在 langgraph.json 中声明的环境文件是否已附加到 Python 运行配置。
如果文件未附加,PyCharm 会在运行配置设置中显示警告。 点击 修复 可自动添加环境文件。

硬编码的 LangSmith API 密钥
PyCharm 会检测在 Python 代码中直接传递给 LangSmith 客户端的 LangSmith API 密钥。 例如:
在此示例中,PyCharm 会高亮显示 API 密钥,并报告其在源代码中被硬编码。 检查建议改为将密钥存储在环境变量中。

环境加载顺序
PyCharm 会检测在导入 LangChain 或 LangSmith 模块后调用 load_dotenv() 的情况。 在这种情况下,来自 .env 文件的环境变量可能加载得太晚,无法影响 LangSmith 配置。
在此示例中,PyCharm 会高亮显示 load_dotenv() 调用,并建议使用 将 load_dotenv() 移到 LangChain 导入上方 快速修复。

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