# 工作台操作指南

按前端实际入口完成数据准备、构图、分析、训练和报告，并管理项目、记忆与技能。

## 先选对入口

打开即进入默认工作区，无需登录、注册或切换用户。左侧“创建你的图”用于准备构图数据；“项目”组织共享同一批数据的会话；右侧“图工作台”展示当前会话的分析结果。这里介绍的是应用工作台，文档站本身不会接收数据或调用模型。

| 入口 | 适合做什么 |
| --- | --- |
| 创建你的图 | 上传 SQL / CSV / TXT，查看源数据、设置字段关系并构图。 |
| 项目 → 项目数据集 | 上传项目数据，或从已完成的个人构图结果导入独立副本。 |
| 新建任务 / 项目内新建会话 | 选择数据集和模型，通过对话发起查询、分析或训练。 |
| 图工作台 | 查看概览、图谱、数据、机器学习结果和分析产物。 |
| 记忆 / 技能 / 帮助 | 管理可复用的偏好和操作流程，查询工具及模型能力。 |

首页内置《天龙八部》、金融风控和化学分子性质分析示例。“使用示例图”会复用预置图并进入会话；点击首页案例中的问题主题会直接发送该问题并开始分析，无需等待重新抽取。预置资源是否可用以卡片状态为准。

在“模型服务”中配置对话模型。URL 和 API Key 不会自动填入输入框；留空保留已保存的连接，填写新值并保存后替换。构图页有独立的“构图模型配置”，可选择或自定义模型，并保存用于 TXT 智能抽取及表格智能构图的连接。

界面语言切换会即时更新示例名称、问题和系统标签。对话按发送时的界面语言回复；切换语言影响下一轮，不会翻译或重写已有消息。

## 上传后先核对源数据

选择“上传数据源”后，点击数据源卡片上的“构图”进入面板，先核对样例，再点击“开始构图”。“源数据示例”显示原始输入的有限样例，与构图后的节点、边和图结构概览分开。构图前、执行中和完成后都可以查看。

- SQL：切换表查看字段、类型、主外键和最多 5 条样例。字段解释优先采用源注释，其次说明键关系；按名称推断的解释会明确标为待核对。预览不会执行上传的 SQL 脚本。
- CSV：选择一个或多个 CSV 都会进入表结构对话框，当前按逗号读取表头。核对表名、主键、外键和复合键各列的顺序，再逐表检查样例。未经过表组配置、通过其他上传入口建立的直接单 CSV 源，可在构图页选择分隔符；不要用这个选项修补已经配置错误的表头。
- TXT：查看保留换行的原文片段，最多 4000 个字符。逐行记录适合保留原文结构；“智能抽取实体与关系”需要已配置的构图模型，完成后还要人工核对抽取含义。

> **样例用于理解数据**
> 每格较长内容会截断，超出预览限制的输入会给出提示。样例不能证明全表没有空值、重复值或异常值；“含义未知”也不表示数据无效，可能只是源文件没有说明。

- [构图流程与输入限制](/zh/construction/): 查看文本模式、键关系、评测查询和构图报告的详细说明。

## 构图、修改与项目复用

- 填写领域和构图参数，启动构图。状态会自动刷新；失败时阅读具体原因，修正输入或配置后再试。
- 完成后检查草稿的规模和类型关系，再点击“保存构图结果”，状态变为 ready 后才能用于分析。图结构概览显示节点类型与关系类型，不等于完整实例图。完整构图报告保存在服务端或 CLI 输出目录。
- 需要修改图时，先选择操作并“应用并预览”，检查差异后再保存。预览不会自动提交；版本冲突时重新读取当前版本。
- 在项目中“加载已构好的图”会导入独立副本。它有自己的 dataset_id 和后续版本，不会随个人源图的修改自动同步。
- 在目标项目中新建会话，选择导入的数据集。加载完成后核对当前图；数据集的 construction_revision 与会话 graph_version 是两套编号。

## 查看图、查找对象和追踪路径

| 界面 | 操作与核对方法 |
| --- | --- |
| 概览 | 核对图名、节点数、边数和方向。指标来自当前加载的图，不一定等于源表行数。 |
| 图谱 | 点击节点查看属性并复制 ID；可切换布局、过滤节点、调整显示或查看一跳/两跳邻域。局部邻域只基于已加载的数据。 |
| 图探索 | 将路径、邻居等查询发送到对话执行。核对工具实际返回，再解释高亮结果。 |
| 数据 | 核对当前图中的节点和边样例。这里不是构图页的原始 SQL / CSV 表预览。 |

可以先问：“请确认当前图的方向、节点类型、关系类型和 graph_version，再根据我提供的两个真实节点 ID 计算最少跳数路径，显式使用 use_weight=false，并展示路径子图。”把 ID 换成从数据或节点详情中复制的值。路径遵循当前图的方向，边多不代表金额高或销量大。

> **显示范围不等于全图范围**
> 图中会显示实际加载的节点和边数。可视化可能截断，大图分区快照也不支持完整画布渲染；应根据查询返回的范围说明结论。搜索节点的语义检索还需要向量模型和索引，未配置时直接使用真实节点 ID。

分区大图采用独立的快照和作业流程：先确认 get_large_graph_capabilities 返回的能力，通过 prepare_large_graph 准备分区版本，再用 run_large_graph_algorithm 提交计算，完成后读取结果文件。可以在对话中要求智能体按这些步骤执行。大图算法可能采用采样或近似实现，应按返回的范围和方法解释结果。

## 训练、推理与项目对比

通过对话提交任务、模型和参数。节点分类需要合适的特征、标签和数据划分；没有标签的业务关系图可用于适用的预训练任务，不能直接宣称完成了分类评估。多图分类有单独的数据格式和加载流程。

- 在“机器学习”页查看训练状态、损失与评估曲线，也可切换表格。已提交或仍在运行的作业还不能作为最终训练结果。
- 项目会话中可在“当前会话”和“项目对比”间切换，查看任务、模型名称、轮次、指标和完成状态，并确认数据集。完整参数和 model_id 需要从对话中的工具返回核对，也可以请智能体读取。不同任务或划分的指标不能直接排名。
- 训练完成后用真实 model_id 发起推理。返回样例条数不等于评估样本数；训练列表中某项指标为“-”时，不能当作 0，也不能用推理结果冒充训练时已记录的指标。

- [图学习任务与参数](/zh/graph-ml/): 查看支持的模型、输入要求、训练协议和结果解释。

## 查看报告与下载文件

“分析产物”页同时显示结构化报告和会话文件。报告卡片用于阅读分析内容；文件列表会列出上传文件，并为 Derived 中允许下载的结果文件提供下载按钮。对话中出现一段报告文字，不代表已经生成可下载文件。

- 要求报告列明数据来源、dataset_id、construction_revision、graph_version、所用工具和指标口径。结构化报告工具默认启用；服务端将 MCP_ENABLE_REPORTING_TOOLS 设为 false 时不可用。
- 需要下载时，明确要求生成 Markdown 等结果文件并发布到 Derived。文件生成后，打开“分析产物”中的“会话文件”，必要时点击“刷新文件”，再使用对应下载按钮。
- 检查报告中的数值是否来自完成的工具结果，区分原始事实、结构指标和模型推断。

## 管理记忆、技能与帮助

左侧“记忆”用于查看和删除用户记忆，可搜索内容。若希望后续会话沿用某项偏好，应明确要求保存为用户记忆，再重新打开记忆面板核对。学习经验库与用户记忆采用不同存储方式，save_learning 的结果不一定出现在这个列表中。

“技能”显示已发现的操作流程及详情，可上传 .md 或 .zip 技能并审核候选；上传或生成成功不等于已经批准使用。技能可否删除仍由其来源与可编辑状态决定，内置技能与工作区自建技能有不同规则。“帮助”支持按名称、任务或用途搜索图工具与图学习模型。

一项可复用的偏好可以写成：“先核对源字段和主外键；报告注明数据来源和图版本；连接数反映当前图的全部关系结构，不能解释为销量或金额。”在新会话中询问已保存的偏好，可以检验是否成功读取。

## 确认完成与处理异常

- 页面暂时没有新消息时，先读取会话状态或重新打开会话。后台任务可能仍在执行，不要因等待而反复提交同一写入。
- 取消是否可用取决于服务端 capabilities。支持取消时，“正在停止”不等于已经停止，应等待终态；关闭页面也不等于取消。
- 一次完整分析应能核对数据来源、图版本、已完成查询、最终模型或报告文件。只显示进度、图像或模型生成的结论还不够。