Article body
正文
摘要： 复杂分析常涉及数据理解、查询、指标和图表创作。衡石 Data Agent 提供数据问答、指标创建、仪表盘生成等能力。恢复中断任务时，需要保留原始业务意图，核查失败前的真实状态，再继续尚未完成的部分。下文以华东销售分析为例，讨论企业实施与验收中的恢复方法。
一、先固定任务口径与已完成结果
衡石 Data Agent 支持围绕业务数据展开对话，并可结合建模、指标和可视化能力推进分析任务。一次任务中既有查询，也可能包含资产创建或更新。恢复前要先区分失败发生在哪一步，并保留此前已验证的结果；重新提交一个相似问题，可能改变原先的数据范围、指标口径或交付位置。
以“分析过去十二个月华东各省销售趋势，并创建含同比比较的仪表盘”为例，先明确销售额口径、日期字段、地区层级、关联数据集、发起账号、可见数据范围和目标位置。计算同比还需要分析窗口对应的上年同期数据，不能只检查最近十二个月是否有数。恢复时沿用已确认的定义，确保趋势和同比回答的是同一个业务问题。
大模型生成结果存在不确定性。团队需要保存原始请求、已确认的分析条件和通过核验的中间结果，让接手者可以区分“已经完成”“执行失败”和“尚未开始”，并据此选择续跑位置。
二、用数据说明和运行证据减少恢复盲区
一份可交接的恢复记录至少包含四类信息：原始请求和已确认口径；当时的账号、数据包、应用与筛选范围；失败的调用参数和原始返回；目标位置中已经存在的资产及其状态。工单、工作流记录或运维日志都可以承载这些证据，但应标清来源与时间，避免把旧状态当成当前事实。
数据准备和授权信息是这份记录的基础。团队应维护数据集、字段和指标的名称与描述，在数据集知识管理中补充业务术语、同义词、筛选规则和字段或指标映射，并隐藏无关对象。数据向量化可以帮助按语义检索相关内容，却不能替代业务方确认口径。用户按角色权限在数据集或指标主题范围内提问；自然语言不能成为提权理由，Agent 也不能自行扩大数据访问范围。
示例：华东销售仪表盘中断在同比图表
如果任务已经返回销售趋势结果，却在创建同比图表时中断，交接记录应说明趋势查询是否通过、同比指标是否已验证、草稿仪表盘是否已创建，以及已经写入哪些图表或筛选器。恢复者先读取目标资产，确认失败发生在计算、创建还是保存阶段，再决定修正输入、补充元素或交由负责人处理口径与权限问题。
三、按异常信息选择恢复动作
不同数据源、操作入口和执行阶段会返回不同的异常信息。可结合原始返回、元数据与目标资产状态，使用下表组织排查。处理规则应保留原任务的指标、范围、粒度和授权条件。
| 异常信号 | 恢复前应核查的内容与动作 | 停止边界 |
|---|---|---|
| 字段、指标或数据集与任务描述不匹配 | 核对数据集元数据、字段和指标说明、业务同义词及关联数据包；由数据或指标负责人确认候选映射。 | 含义未确认时，不以名称相似为依据替换字段或指标；存在口径歧义时交由负责人确认。 |
| 表达式、查询或工具调用失败 | 保留原始问题、筛选条件、所用指标、调用参数和返回信息；在已确认语义下修正输入后再做小范围验证。 | 修正后仍失败或无法解释报错时，保留证据并调整排查路径；不通过无限重试掩盖问题。 |
| 查询等待过久或超时 | 先检查数据源状态、任务范围、筛选条件和可接受的交付时限；必要时由数据团队评估查询和数据准备方案。 | 不得擅自缩短时间范围、替换指标、合并地区或降低分析粒度来换取返回结果。 |
| 数据源结构或字段含义发生变化 | 重新核对数据集和相关语义信息，列出受影响的指标、图表和过滤条件，再由业务负责人确认新的映射。 | 不能未经确认自动更新指标定义、字段含义或业务口径。 |
| 账号缺少所需资源或操作权限 | 说明需要访问的资源、动作和业务原因，交由具备管理权限的人员按现有授权流程处理。 | 不能自行提权、借用其他账号或用提示词绕过权限配置。 |
| 创建或更新动作中断 | 恢复前先读取目标位置的实际状态，核查数据集、指标、仪表盘或元素是否已经创建，再决定补做哪一步。 | 不能直接重放写操作；未核查已创建对象会产生重复资产或覆盖既有内容。 |
恢复是否有效，应同时检查任务含义是否保持一致、目标状态是否得到确认、缺失步骤是否完成。缩短时间范围、替换指标或改变粒度都会影响分析含义，确有必要时应先说明影响并取得业务确认。
四、从已确认状态继续执行
查询失败与写入中断需要采用不同处理方式。对于只读查询，可以在错误原因得到解释后，在原范围内进行有限次数的重试。对于创建或更新动作，应先按已返回的资产 ID 读取当前状态；名称只能作为查找线索，不能单独证明对象属于本次任务。
华东销售任务若在同比指标处失败，先确认同比定义、日期字段和上年同期数据，再验证该指标在授权范围内的计算结果。通过后继续生成缺失图表。若创建仪表盘的请求中断，先确认目标目录及已有对象，保留已完成元素，再补齐缺失部分；状态无法确认时交由负责人处理，避免重复创建或覆盖。
涉及目标资产覆盖、权限调整或其他高影响写操作时，应遵循既有的授权和审阅流程。恢复记录需要说明哪些动作已经完成、哪些仍未执行，以及下一步由谁处理。这样的交接可减少整项任务从头重做，也便于业务方复核最终交付物。
五、约定协作责任与执行方式
复杂分析任务需要将业务责任与执行方式同时约定清楚。业务负责人确认指标口径和可接受的替代方案；数据负责人维护数据集、字段与结构变更信息；分析人员或 Agent 在授权范围内完成问数、建模和创作；权限管理员处理访问申请；交付负责人核验资产状态并组织验收。
执行方式应随场景选择：开放式分析可采用 Agent 模式；步骤固定、规则可预期的场景可采用 Workflow；企业自有后端或多 Agent 编排可通过 API 接入。接入方案应写清谁推进下一步、谁保存状态、谁负责失败补偿与结果呈现，不能把 API、SDK 或 iframe 视为同一种运行方式。
六、用真实任务验收恢复结果
上线前，可围绕同一份华东销售任务验证三类情况：正常权限账号完成已确认口径下的分析和仪表盘草稿；受限账号只能看到授权区域的数据；模拟字段更名、查询超时与创建中断后，处理者能识别停止条件、保留已完成结果并续跑缺失步骤。对实际启用的追问、嵌入、分享与导出入口，也应分别核验其身份和权限传递。
恢复验收应同时关注结果与资产：趋势和同比使用同一份指标定义、时间及区域口径；已完成图表与续跑图表可以对账；目标位置没有重复或误覆盖资产；结果仍处于授权范围内。团队还可记录人工接管原因、重复创建次数和恢复用时，用来改进数据说明与执行流程。衡石的数据问答、建模创作、语义模型和权限治理，为这些检查提供能力基础；项目团队负责把检查落实到具体场景。