> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 反馈数据格式

<Check>
  在深入此内容之前，阅读以下内容可能会有所帮助：

  * [关于追踪与反馈的概念指南](/langsmith/observability-concepts)
</Check>

**反馈**是 LangSmith 在特定追踪或中间运行（区间）上存储评估标准和分数的方式。反馈可以通过多种方式产生，例如：

1. [随追踪一起从 LLM 应用发送](/langsmith/attach-user-feedback)
2. 由用户在应用中[内联](/langsmith/annotate-traces-inline)或在[标注队列](/langsmith/annotation-queues)中生成
3. 在[离线评估](/langsmith/evaluate-llm-application)期间由自动评估器生成
4. 由[在线评估器](/langsmith/online-evaluations-llm-as-judge)生成

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

| 字段名                        | 类型       | 描述                                       |
| -------------------------- | -------- | ---------------------------------------- |
| `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 表示示例：

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "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"
  }
}
```

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档连接](/use-these-docs)到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/feedback-data-format.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>