---
title: 工作区使用
description: DeerFlow 工作区是一个基于浏览器的对话界面，你可以在其中向 Agent 发送消息、上传文件、查看中间步骤，以及下载生成的产出物。
---

import { Callout, Cards } from "nextra/components";

# 工作区使用

<Callout type="info" emoji="💬">
  DeerFlow 工作区是你与 Agent
  交互的地方。本页面涵盖主要用户界面工作流——创建对话、上传文件、查看产出物和使用技能。
</Callout>

DeerFlow 工作区是一个基于浏览器的对话界面，你可以在其中向 Agent 发送消息、上传文件、查看中间步骤，以及下载生成的产出物。

## 新建对话

1. 打开 [http://localhost:2026](http://localhost:2026)。
2. 在主界面点击 **New Thread**（新建线程）按钮，或直接在输入框中输入消息。
3. 输入你的第一条消息并发送。

每个对话是一个**线程**，有独立的历史记录、产出物和检查点。

## 选择模型

在消息输入区域，点击**模型选择器**从 `config.yaml` 中配置的模型中选择。默认选中第一个配置的模型。

你可以在对话中途切换模型——每次新的发送都会使用所选的模型。

## 选择 Agent

打开 **Agent 选择器**从可用 Agent 中选择：

- **默认 Agent**：使用所有全局工具和技能的通用 Agent。
- **自定义 Agent**：具有专门技能组合、工具访问和提示词的命名 Agent。

参见 [Agent 与线程](/docs/application/agents-and-threads)页面了解如何创建自定义 Agent。

## 上传文件

拖放文件到消息输入区域，或点击附件图标上传。上传的文件挂载在沙箱的 `/mnt/user-data/uploads/` 路径下，Agent 可以直接读取和处理。

**支持的操作**：

- 读取和分析文件内容
- 处理数据文件（CSV、JSON、Excel）
- 提取 PDF 内容
- 分析图像（需要支持视觉的模型）

<Callout type="tip">
  上传大文件时，告诉 Agent
  文件的具体内容，以便获得更好的结果（例如"分析这个包含季度销售数据的 CSV"）。
</Callout>

## 使用技能

某些 Agent 配置暴露了**技能选择器**。技能告诉 Agent 要执行哪类工作（深度研究、数据分析、图表生成等）。

在输入框中点击技能选择器选择一个技能。选定的技能会将专业指令和工作流注入到当前对话中。

## 查看 Agent 思考过程

当 Agent 调用工具或进行推理时，你可以展开**思考步骤**：

- **工具调用**：Agent 正在调用哪个工具、使用什么参数。
- **工具结果**：工具返回了什么。
- **思考内容**（如果模型支持）：模型的内部推理过程。
- **待办列表**（计划模式）：当前任务列表及其完成状态。

点击消息旁边的展开箭头查看完整的推理链。

## 理解 Token 用量

如果启用了 Token 用量显示，DeerFlow 会在顶部显示一个对话级总量，并在消息列表中按配置显示每轮或调试级别的用量摘要。

- **顶部总量**：后端持久化的线程级总账。当当前回复仍在流式返回时，顶部还可能临时叠加这条未完成回复的可见进行中用量。
- **每轮 / 调试用量**：根据当前界面里可见的 assistant 消息计算出来的用量。

因此，顶部总量和当前可见的每轮总和**不要求完全相等**。顶部展示的是整个线程的总账；每轮展示的是你当前能看到的消息视图。

这些数字也可能与模型供应商的账单页不同。常见原因包括重试请求、失败请求、缓存输入 token、推理 token、供应商自己的计费口径，以及不会以普通聊天消息形式显示的内部调用。

## 查看产出物

当 Agent 生成文件（报告、图表、代码文件、演示文稿）时，它们会以**产出物**的形式出现在对话中。

点击产出物卡片：

- 在浏览器中预览文件。
- 下载文件到本地机器。
- 复制文件内容。

产出物会持久保存在线程的用户数据目录中（`.deer-flow/threads/{thread_id}/user-data/outputs/`）。

## 管理线程

**查看过往线程**：使用侧边栏浏览之前的对话。

**重命名线程**：`TitleMiddleware` 会在第一次交互后自动生成标题。你也可以手动重命名线程。

**删除线程**：从线程侧边栏菜单中选择删除。这会移除线程状态和所有相关的用户数据文件。

<Cards num={2}>
  <Cards.Card
    title="Agent 与线程"
    href="/docs/application/agents-and-threads"
  />
  <Cards.Card
    title="运维与排障"
    href="/docs/application/operations-and-troubleshooting"
  />
</Cards>
