跳到主要内容

在 Playground 中测试流

Langflow 的 Playground 是一个动态界面，您可以用来实时测试基于 LLM 的流。

您可以测试流如何响应不同的输入，查看并修改记忆，以及监控流的输出和逻辑。例如，您可以确保代理流（agent flows）使用适当的工具来响应不同的输入。

Playground 允许您快速迭代流的逻辑和行为，从而更轻松地进行应用程序的原型设计和改进。

在 Playground 中运行流​

要在 Playground 中运行流，请打开该流，然后点击 Playground。接着，如果您的流包含 Chat Input 组件，请输入提示词或使用语音模式来触发流并开始对话会话。

提示

如果 Playground 中没有消息输入框，请确保您的流中有一个 Chat Input 组件，且该组件已直接或间接地连接到 Language Model 或 Agent 组件的 Input 端口。

由于 Playground 是为使用 LLM 查询响应格式（如聊天机器人和代理）的流设计的，因此流必须包含 Chat Input、Language Model/Agent 和 Chat Output 组件，才能获得 Playground 聊天界面的完整支持。

对于需要其他输入类型（如 webhook 事件、文件上传或文本输入）的流，您可以使用 Langflow API 触发流，然后打开 Playground 查看该流运行的 LLM 活动（如果适用）。

Playground window

有关 Playground 工作原理的技术细节，请参阅监控端点。

审查代理逻辑​

如果您的流包含 Agent 组件，Playground 会打印代理使用的工具以及每个工具的输出。这有助于您监控代理的工具使用情况，并理解代理响应背后的逻辑。例如，以下代理使用了连接的 fetch_content 工具来执行网络搜索：

Playground with agent response

查看聊天历史​

在 Playground 中，您可以查看每个流聊天会话的消息日志，包括时间戳、内容和发送者。

在 Playground 侧边栏中，找到您想要查看的聊天会话，点击 Options（选项），然后选择 Message Logs（消息日志）。

Playground logs

消息日志会拆解每条聊天消息的 Message 数据。点击消息日志中的任何单元格即可查看该单元格的完整内容。

在 Playground 中修改记忆​

为了协助调试和测试流，您可以在 消息日志 中编辑或删除单条消息。例如，您可能想要删除在测试某个已不再属于流的组件时发送的消息。

您还可以从侧边栏删除整个聊天会话：点击 Options（选项），然后选择 Delete（删除）。

如果您继续聊天会话，或者在多个聊天会话中保留记忆，修改记忆将会影响聊天机器人响应的行为。

编辑消息日志会编辑 Langflow 内部的 messages 表，这是默认的聊天记忆存储。 有关在 Langflow 中管理会话和聊天记忆的更多信息，请参阅 使用自定义会话 ID 和 记忆管理选项。

设置自定义会话 ID​

聊天会话由会话 ID (session_id) 标识，它是流运行的唯一标识符。

默认会话 ID 是流 ID，这意味着一个流的所有聊天消息都存储在同一个会话 ID 下，作为一个巨大的聊天会话。

如果您需要在多次流运行中保留聊天上下文，或者在调试流时区分不同的聊天会话，可以设置自定义 session_id。

自定义会话 ID 在以下几种情况下很有帮助：

  • 在同一个流有多个聊天会话的情况下隔离会话，例如一个可以同时处理多个用户交互的聊天机器人。
  • 在跨多次流运行继续聊天会话，或将上下文从一个流传递到另一个流时保留记忆。
  • 区分同一流中来自多个用户的活动。
  • 在调试和测试流时识别您自己的聊天会话。

您可以在可视化编辑器中设置自定义会话 ID，也可以通过编程方式设置。

在您的 输入和输出组件 中，使用 Session ID 字段：

  1. 点击您想要设置自定义会话 ID 的组件。
  2. 在 组件的标题菜单 中，点击 Controls（控件）.
  3. 启用 Session ID。
  4. 点击 Close（关闭）。
  5. 输入自定义会话 ID。如果该字段为空，流将使用默认会话 ID。
  6. 打开 Playground，在您的自定义会话 ID 下开始聊天。

当您想要开始新的聊天会话或以不同的会话 ID 继续之前的聊天会话时，请务必更改 Session ID。

提示

在生产环境中，请考虑使用变量而不是硬编码值作为会话 ID。

例如，如果您想为经过身份验证的用户保留上下文，用户 ID 可以作为会话 ID 的有用变量。或者，如果您希望每次聊天都是唯一的，您可能希望为每个会话 ID 自动生成一个 UUID。

更多信息请参阅 使用会话 ID 管理组件间的通信。

共享流的 Playground​

警告

可共享的 Playground 仅用于测试目的。Playground 不适用于将流嵌入到应用程序中。有关在应用程序或网站中运行流的信息，请参阅 使用 Langflow API 触发流。

可共享的 Playground 在 Langflow 桌面版中不可用。

可共享的 Playground 选项会在 /public_flow/$FLOW_ID 端点公开单个流的 Playground。

在您 部署公开的 Langflow 服务器 后，您可以将此公开 URL 分享给其他用户，允许他们仅访问指定流的 Playground。用户可以与流的聊天输入和输出进行交互并查看结果，而无需安装 Langflow 或生成 Langflow API 密钥。

要与另一位用户共享流的 Playground，请执行以下操作：

  1. 在 Langflow 中，打开您想要分享的流。
  2. 在 工作区 中，点击 Share（分享），然后启用 Shareable Playground。
  3. 再次点击 Shareable Playground 以打开 Playground 窗口。该窗口的 URL 即为流的 Shareable Playground 地址，例如 https://3f7c-73-64-93-151.ngrok-free.app/playground/d764c4b8-5cec-4c0f-9de0-4b419b11901a。
  4. 将该 URL 发送给其他用户，授予他们访问该流 Playground 的权限。

另请参阅​

Search