跳到主要内容

在游乐场中测试流

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

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

游乐场 允许您快速迭代流的逻辑和行为，使其更容易进行原型设计和改进您的应用程序。

在游乐场中运行流​

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

提示

如果 游乐场 中没有消息输入字段，请确保您的流包含一个 聊天输入 (Chat Input) 组件，该组件直接或间接地连接到 语言模型 (Language Model) 或 代理 (Agent) 组件的 输入 (Input) 端口。

由于 游乐场 是为使用 LLM 进行查询和响应格式（如聊天机器人和代理）的流设计的，因此流必须包含 聊天输入、语言模型/代理 和 聊天输出 组件，才能得到 游乐场 聊天界面的完全支持。

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

游乐场窗口

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

查看代理逻辑​

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

带代理响应的游乐场

查看聊天记录​

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

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

游乐场日志

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

在游乐场中修改记忆​

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

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

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

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

设置自定义会话 ID​

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

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

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

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

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

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

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

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

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

提示

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

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

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

分享流的游乐场​

注意

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

可分享的游乐场 在 Langflow 桌面版中不可用。

可分享的游乐场 选项在 /public_flow/$FLOW_ID 端点公开单个流的 游乐场。

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

要与另一个用户分享流的 游乐场，请执行以下操作：

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

另请参阅​

Search