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

# 集成 W&B Weave

> Dify Cloud | 社区版本号需 ≥ v1.3.1

### 什么是 W\&B Weave

Weights & Biases (W\&B) Weave 是一个用于跟踪、实验、评估、部署和改进基于 LLM 的应用程序的框架。Weave 专为灵活性和可扩展性而设计，支持 LLM 应用程序开发工作流的每个阶段。

<Info>
  更多详情，请参考 [Weave](https://weave-docs.wandb.ai/)。
</Info>

***

### 如何配置 Weave

#### 1. 注册/登录

前往 [W\&B Weave](https://wandb.ai/signup) 注册/登录。创建一个 Weights & Biases (W\&B) 账户，并在[此处](https://wandb.ai/authorize)复制 API 密钥。

#### 2. 将 W\&B Weave 与 Dify 集成

在 Dify 应用程序中配置 Weave。打开需要监控的应用程序，在侧边菜单中打开**监控**，在页面上选择**跟踪应用性能**。

![](https://assets-docs.dify.ai/2025/04/c33e8fda75ee9052ed23c8690e314862.png)

点击配置后，粘贴 **API 密钥**和**项目名称**，指定 **W\&B 实体**(可选，默认为您的用户名)到配置中并保存。

![](https://assets-docs.dify.ai/2025/04/60bce1ae7b883825b13526d172ae0073.png)

成功保存后，您可以在当前页面查看监控状态。

![](https://assets-docs.dify.ai/2025/04/9486cee7bbb61f069842c9ea860e679c.png)

### 在 Weave 中查看监控数据

配置完成后，Dify 内应用的调试或生产数据可以在 Weave 中进行监控。

![](https://assets-docs.dify.ai/2025/04/a1c5aa80325e6d0223d48a178393baec.png)

当您切换到 Weave 时，可以在仪表板中查看 Dify 应用程序的详细操作日志。

![](https://assets-docs.dify.ai/2025/04/2cb04027c00b606029fcc26af2801bfe.png)

通过 Weave 获取的详细 LLM 操作日志将帮助您优化 Dify 应用程序的性能。

### 监控数据列表

#### **工作流/对话流追踪信息**

**用于追踪工作流和对话流**

| 工作流                                      | Weave 追踪               |
| ---------------------------------------- | ---------------------- |
| workflow\_app\_log\_id/workflow\_run\_id | id                     |
| user\_session\_id                        | 放置在元数据中                |
| workflow\_{id}                           | name                   |
| start\_time                              | start\_time            |
| end\_time                                | end\_time              |
| inputs                                   | inputs                 |
| outputs                                  | outputs                |
| 模型令牌消耗                                   | usage\_metadata        |
| metadata                                 | extra                  |
| error                                    | error                  |
| workflow                                 | tags                   |
| "conversation\_id/none for workflow"     | 元数据中的 conversation\_id |
| conversion\_id                           | parent\_run\_id        |

**工作流追踪信息**

* workflow\_id - 工作流的唯一标识符
* conversation\_id - 对话 ID
* workflow\_run\_id - 当前运行的 ID
* tenant\_id - 租户 ID
* elapsed\_time - 当前运行所花费的时间
* status - 运行状态
* version - 工作流版本
* total\_tokens - 当前运行中使用的总令牌数
* file\_list - 处理的文件列表
* triggered\_from - 触发当前运行的来源
* workflow\_run\_inputs - 当前运行的输入数据
* workflow\_run\_outputs - 当前运行的输出数据
* error - 当前运行期间遇到的错误
* query - 运行期间使用的查询
* workflow\_app\_log\_id - 工作流应用程序日志 ID
* message\_id - 关联的消息 ID
* start\_time - 运行的开始时间
* end\_time - 运行的结束时间
* workflow node executions - 工作流节点执行的信息
* 元数据
  * workflow\_id - 工作流的唯一标识符
  * conversation\_id - 对话 ID
  * workflow\_run\_id - 当前运行的 ID
  * tenant\_id - 租户 ID
  * elapsed\_time - 当前运行所花费的时间
  * status - 运行状态
  * version - 工作流版本
  * total\_tokens - 当前运行中使用的总令牌数
  * file\_list - 处理的文件列表
  * triggered\_from - 触发当前运行的来源

#### **消息追踪信息**

**用于追踪与 LLM 相关的对话**

| 聊天                            | Weave 追踪               |
| ----------------------------- | ---------------------- |
| message\_id                   | id                     |
| user\_session\_id             | 放置在元数据中                |
| "message\_{id}"               | name                   |
| start\_time                   | start\_time            |
| end\_time                     | end\_time              |
| inputs                        | inputs                 |
| outputs                       | outputs                |
| 模型令牌消耗                        | usage\_metadata        |
| metadata                      | extra                  |
| error                         | error                  |
| "message", conversation\_mode | tags                   |
| conversation\_id              | 元数据中的 conversation\_id |
| conversion\_id                | parent\_run\_id        |

**消息追踪信息**

* message\_id - 消息 ID
* message\_data - 消息数据
* user\_session\_id - 用户会话 ID
* conversation\_model - 对话模式
* message\_tokens - 消息中的令牌数
* answer\_tokens - 回答中的令牌数
* total\_tokens - 消息和回答中的总令牌数
* error - 错误信息
* inputs - 输入数据
* outputs - 输出数据
* file\_list - 处理的文件列表
* start\_time - 开始时间
* end\_time - 结束时间
* message\_file\_data - 与消息关联的文件数据
* conversation\_mode - 对话模式
* 元数据
  * conversation\_id - 对话 ID
  * ls\_provider - 模型提供商
  * ls\_model\_name - 模型 ID
  * status - 消息状态
  * from\_end\_user\_id - 发送用户的 ID
  * from\_account\_id - 发送账户的 ID
  * agent\_based - 消息是否基于代理
  * workflow\_run\_id - 工作流运行 ID
  * from\_source - 消息来源

#### **审核追踪信息**

**用于追踪对话审核**

| 审核            | Weave 追踪        |
| ------------- | --------------- |
| user\_id      | 放置在元数据中         |
| "moderation"  | name            |
| start\_time   | start\_time     |
| end\_time     | end\_time       |
| inputs        | inputs          |
| outputs       | outputs         |
| metadata      | extra           |
| \[moderation] | tags            |
| message\_id   | parent\_run\_id |

**审核追踪信息**

* message\_id - 消息 ID
* user\_id: 用户 ID
* workflow\_app\_log\_id - 工作流应用程序日志 ID
* inputs - 审核输入数据
* message\_data - 消息数据
* flagged - 内容是否被标记为需要注意
* action - 采取的特定操作
* preset\_response - 预设响应
* start\_time - 审核开始时间
* end\_time - 审核结束时间
* 元数据
  * message\_id - 消息 ID
  * action - 采取的特定操作
  * preset\_response - 预设响应

#### **建议问题追踪信息**

**用于追踪建议的问题**

| 建议问题                | Weave 追踪        |
| ------------------- | --------------- |
| user\_id            | 放置在元数据中         |
| suggested\_question | name            |
| start\_time         | start\_time     |
| end\_time           | end\_time       |
| inputs              | inputs          |
| outputs             | outputs         |
| metadata            | extra           |
| suggested\_question | tags            |
| message\_id         | parent\_run\_id |

**消息追踪信息**

* message\_id - 消息 ID
* message\_data - 消息数据
* inputs - 输入内容
* outputs - 输出内容
* start\_time - 开始时间
* end\_time - 结束时间
* total\_tokens - 令牌数
* status - 消息状态
* error - 错误信息
* from\_account\_id - 发送账户的 ID
* agent\_based - 消息是否基于代理
* from\_source - 消息来源
* model\_provider - 模型提供商
* model\_id - 模型 ID
* suggested\_question - 建议的问题
* level - 状态级别
* status\_message - 状态消息
* 元数据
  * message\_id - 消息 ID
  * ls\_provider - 模型提供商
  * ls\_model\_name - 模型 ID
  * status - 消息状态
  * from\_end\_user\_id - 发送用户的 ID
  * from\_account\_id - 发送账户的 ID
  * workflow\_run\_id - 工作流运行 ID
  * from\_source - 消息来源

#### **数据集检索追踪信息**

**用于追踪知识库检索**

| 数据集检索              | Weave 追踪        |
| ------------------ | --------------- |
| user\_id           | 放置在元数据中         |
| dataset\_retrieval | name            |
| start\_time        | start\_time     |
| end\_time          | end\_time       |
| inputs             | inputs          |
| outputs            | outputs         |
| metadata           | extra           |
| dataset\_retrieval | tags            |
| message\_id        | parent\_run\_id |

**数据集检索追踪信息**

* message\_id - 消息 ID
* inputs - 输入内容
* documents - 文档数据
* start\_time - 开始时间
* end\_time - 结束时间
* message\_data - 消息数据
* 元数据
  * message\_id - 消息 ID
  * ls\_provider - 模型提供商
  * ls\_model\_name - 模型 ID
  * status - 消息状态
  * from\_end\_user\_id - 发送用户的 ID
  * from\_account\_id - 发送账户的 ID
  * agent\_based - 消息是否基于代理
  * workflow\_run\_id - 工作流运行 ID
  * from\_source - 消息来源

#### **工具追踪信息**

**用于追踪工具调用**

| 工具                    | Weave 追踪        |
| --------------------- | --------------- |
| user\_id              | 放置在元数据中         |
| tool\_name            | name            |
| start\_time           | start\_time     |
| end\_time             | end\_time       |
| inputs                | inputs          |
| outputs               | outputs         |
| metadata              | extra           |
| \["tool", tool\_name] | tags            |
| message\_id           | parent\_run\_id |

#### **工具追踪信息**

* message\_id - 消息 ID
* tool\_name - 工具名称
* start\_time - 开始时间
* end\_time - 结束时间
* tool\_inputs - 工具输入
* tool\_outputs - 工具输出
* message\_data - 消息数据
* error - 错误信息（如果有）
* inputs - 消息的输入
* outputs - 消息的输出
* tool\_config - 工具配置
* time\_cost - 时间成本
* tool\_parameters - 工具参数
* file\_url - 关联文件的 URL
* 元数据
  * message\_id - 消息 ID
  * tool\_name - 工具名称
  * tool\_inputs - 工具输入
  * tool\_outputs - 工具输出
  * tool\_config - 工具配置
  * time\_cost - 时间成本
  * error - 错误信息（如果有）
  * tool\_parameters - 工具参数
  * message\_file\_id - 消息文件 ID
  * created\_by\_role - 创建者的角色
  * created\_user\_id - 创建者的用户 ID

**生成名称追踪信息**

**用于追踪对话标题生成**

| 生成名称           | Weave 追踪    |
| -------------- | ----------- |
| user\_id       | 放置在元数据中     |
| generate\_name | name        |
| start\_time    | start\_time |
| end\_time      | end\_time   |
| inputs         | inputs      |
| outputs        | outputs     |
| metadata       | extra       |
| generate\_name | tags        |

**生成名称追踪信息**

* conversation\_id - 对话 ID
* inputs - 输入数据
* outputs - 生成的对话名称
* start\_time - 开始时间
* end\_time - 结束时间
* tenant\_id - 租户 ID
* 元数据
  * conversation\_id - 对话 ID
  * tenant\_id - 租户 ID

<CardGroup cols="2">
  <Card title="编辑此页面" icon="pen-to-square" href="https://github.com/langgenius/dify-docs-mintlify/edit/main/zh-hans/guides/monitoring/integrate-external-ops-tools/integrate-weave.mdx">
    通过直接提交修改来帮助改进文档内容
  </Card>

  <Card title="提交问题" icon="github" href="https://github.com/langgenius/dify-docs-mintlify/issues/new?title=文档问题%3A%20rate-we&body=%23%23%20问题描述%0A%3C%21--%20请简要描述您发现的问题%20--%3E%0A%0A%23%23%20页面链接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs-mintlify%2Fblob%2Fmain%2Fzh-hans/guides/monitoring/integrate-external-ops-tools%2Fintegrate-weave.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20如果有具体的修改建议，请在此说明%20--%3E%0A%0A%3C%21--%20感谢您对文档质量的关注！%20--%3E">
    发现错误或有改进建议？请提交问题反馈
  </Card>
</CardGroup>
