反馈数据格式

在深入阅读本内容之前，建议先了解以下内容：

• 关于追踪与反馈的概念指南

反馈是 LangSmith 用于存储针对特定追踪或中间运行（span）的评估标准和得分的方式。反馈可以通过多种方式生成，例如：

1. 从 LLM 应用程序中随追踪一起上传
2. 用户在应用中内联生成或在标注队列中生成
3. 在离线评估期间由自动评估器生成
4. 由在线评估器生成

反馈以简单的格式存储，包含以下字段：

字段名称	类型	描述
id	UUID	记录本身的唯一标识符
created_at	datetime	记录创建的时间戳
modified_at	datetime	记录最后修改的时间戳
session_id	UUID	运行所属的实验或追踪项目的唯一标识符
run_id	UUID	会话内特定运行的唯一标识符
key	string	描述反馈标准的键，例如 'correctness'
score	number	与反馈键关联的数值分数
value	string	保留用于存储与分数关联的值。适用于分类反馈。
comment	string	与记录相关的任何注释或注解。这可以是给定分数的理由。
correction	object	保留用于存储更正详情，如果有的话
feedback_source	object	包含有关反馈源信息的对象
feedback_source.type	string	反馈来源的类型，例如 'api', 'app', 'evaluator'
feedback_source.metadata	object	保留用于附加元数据，目前
feedback_source.user_id	UUID	提供反馈的用户的唯一标识符

以下是上述格式中反馈记录的 JSON 示例：

{
  "created_at": "2024-05-05T23:23:11.077838",
  "modified_at": "2024-05-05T23:23:11.232962",
  "session_id": "c919298b-0af2-4517-97a2-0f98ed4a48f8",
  "run_id": "e26174e5-2190-4566-b970-7c3d9a621baa",
  "key": "correctness",
  "score": 1.0,
  "value": null,
  "comment": "我给出这个分数是因为答案是正确的。",
  "correction": null,
  "id": "62104630-c7f5-41dc-8ee2-0acee5c14224",
  "feedback_source": {
    "type": "app",
    "metadata": null,
    "user_id": "ad52b092-1346-42f4-a934-6e5521562fab"
  }
}

---

Edit this page on GitHub or file an issue.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.