跳到主要内容
LangSmith 与开源的 openevals 包集成,提供了一套预构建的评估器,你可以将其用作评估的起点。
本操作指南将演示如何设置和运行一种评估器(LLM-as-a-judge)。有关预构建评估器的完整列表和使用示例,请参阅 openevalsagentevals 仓库。

设置

你需要安装 openevals 包才能使用预构建的 LLM-as-a-judge 评估器。
pip install -U openevals
你还需要将你的 OpenAI API 密钥设置为环境变量,当然你也可以选择不同的提供商。
export OPENAI_API_KEY="your_openai_api_key"
我们还将使用 LangSmith 的 pytest(用于 Python)和 Vitest/Jest(用于 TypeScript)集成来运行我们的评估。openevals 也与 evaluate 方法无缝集成。有关设置说明,请参阅相应的指南

运行评估器

一般流程很简单:从 openevals 导入评估器或工厂函数,然后在你的测试文件中使用输入、输出和参考输出来运行它。LangSmith 将自动把评估器的结果记录为反馈。 请注意,并非所有评估器都需要每个参数(例如,精确匹配评估器只需要输出和参考输出)。此外,如果你的 LLM-as-a-judge 提示需要额外的变量,将其作为 kwargs 传入将把它们格式化到提示中。 像这样设置你的测试文件:
import pytest
from langsmith import testing as t
from openevals.llm import create_llm_as_judge
from openevals.prompts import CORRECTNESS_PROMPT

correctness_evaluator = create_llm_as_judge(
    prompt=CORRECTNESS_PROMPT,
    feedback_key="correctness",
    model="openai:o3-mini",
)

# Mock standin for your application
def my_llm_app(inputs: dict) -> str:
    return "Doodads have increased in price by 10% in the past year."

@pytest.mark.langsmith
def test_correctness():
    inputs = "How much has the price of doodads changed in the past year?"
    reference_outputs = "The price of doodads has decreased by 50% in the past year."
    outputs = my_llm_app(inputs)

    t.log_inputs({"question": inputs})
    t.log_outputs({"answer": outputs})
    t.log_reference_outputs({"answer": reference_outputs})

    correctness_evaluator(
        inputs=inputs,
        outputs=outputs,
        reference_outputs=reference_outputs
    )
feedback_key/feedbackKey 参数将用作你实验中反馈的名称。 在你的终端中运行评估将得到类似以下结果: 预构建评估器终端结果 如果你已经在 LangSmith 中创建了一个数据集,你也可以直接将预构建的评估器传递给 evaluate 方法。如果使用 Python,这需要 langsmith>=0.3.11
from langsmith import Client
from openevals.llm import create_llm_as_judge
from openevals.prompts import CONCISENESS_PROMPT

client = Client()
conciseness_evaluator = create_llm_as_judge(
    prompt=CONCISENESS_PROMPT,
    feedback_key="conciseness",
    model="openai:o3-mini",
)

experiment_results = client.evaluate(
    # This is a dummy target function, replace with your actual LLM-based system
    lambda inputs: "What color is the sky?",
    data="Sample dataset",
    evaluators=[
        conciseness_evaluator
    ]
)
有关可用评估器的完整列表,请参阅 openevalsagentevals 仓库。
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.