主题
评估 是衡量 LLM 应用程序性能的一种定量方法。LLM 的行为可能难以预测,即使是对提示词、模型或输入的微小更改也可能显著影响结果。评估提供了一种结构化的方式来识别故障、比较版本并构建更可靠的 AI 应用程序。
在 LangSmith 中运行评估需要三个关键组件:
本快速入门将指导您使用 LangSmith SDK 或 UI 运行一个入门评估,以检查 LLM 响应的正确性。
如果您更喜欢观看关于开始使用追踪的视频,请参阅数据集和评估的视频指南。
先决条件
开始之前,请确保您已具备:
- 一个 LangSmith 账户:在 smith.langchain.com 注册或登录。
- 一个 LangSmith API 密钥:请遵循创建 API 密钥指南。
- 一个 OpenAI API 密钥:通过 OpenAI 仪表板生成。
选择 UI 或 SDK 筛选器以查看说明:
UI
SDK
1. 设置工作区密钥
在 LangSmith UI 中,请确保您的 OpenAI API 密钥已设置为 工作区密钥。
- 导航至 设置,然后转到 密钥 选项卡。
- 选择 添加密钥,输入
OPENAI_API_KEY作为密钥,并将您的 API 密钥填入 值 字段。 - 选择 保存密钥。
在 LangSmith UI 中添加工作区密钥时,请确保密钥名称与您的模型提供商所期望的环境变量名称相匹配。
2. 创建提示词
LangSmith 的提示词游乐场使得对不同的提示词、新模型或测试不同的模型配置运行评估成为可能。
- 在 LangSmith UI 中,导航到 Prompt Engineering 下的 Playground。
- 在 Prompts 面板下,将 system 提示词修改为:
Answer the following question accurately:保持 Human 消息不变:{question}。
3. 创建数据集
- 点击 Set up Evaluation,这将在页面底部打开一个 New Experiment(新实验)表格。
- 在 Select or create a new dataset 下拉菜单中,点击 + New 按钮创建一个新数据集。


- 将以下示例添加到数据集中:
| Inputs(输入) | Reference Outputs(参考输出) |
|---|---|
| question: Which country is Mount Kilimanjaro located in? | output: Mount Kilimanjaro is located in Tanzania. |
| question: What is Earth's lowest point? | output: Earth's lowest point is The Dead Sea. |
- 点击 Save 并输入名称以保存您新创建的数据集。
4. 添加评估器
- 点击 + Evaluator 并从 Pre-built Evaluator(预构建评估器)选项中选择 Correctness(正确性)。
- 在 Correctness 面板中,点击 Save。
5. 运行评估
- 选择右上角的 Start 来运行您的评估。这将在 New Experiment 表格中创建一个带有预览的实验。您可以通过点击实验名称查看完整视图。


后续步骤
要了解更多关于在 LangSmith 中运行实验的信息,请阅读评估概念指南。
- 有关评估的更多详细信息,请参阅评估文档。
- 了解如何在 UI 中创建和管理数据集。
- 了解如何从提示词游乐场运行评估。