资料摄取 Ingest｜Agent 调用与人工确认
用 wiki_ingest 查找已登记资料、启动和跟踪任务，保留人工主题确认。
- 开发预览
- 本页模块仍在开发预览中，实际入口以当前版本为准。
Agent 可以把已经登记的资料交给原生处理管线，并跟踪任务。它不需要在对话里另写一套提取与写作流程。你仍然负责确认候选主题，以及检查生成的知识。
先准备已经登记的资料
先通过知识库“资料 → 添加资料”保存来源。仅有一个磁盘路径、聊天附件或 Inbox 笔记，不表示它已经登记为可处理的 Source。
在对话中说明准确名称，并先让 Agent 查询匹配项。需要时使用 wiki-ingest 技能。找不到来源时，回到添加资料流程，不要让 Agent 猜测来源 ID 或手改内部资料目录记录。
可以这样说：
- 请先查询已登记资料中名称含 DuckDB 的条目，列出准确路径和当前处理状态。先不要启动或重新处理。
Agent 按什么顺序调用
原生工具名是 wiki_ingest。用户用自然语言表达目标即可，不需要自己输入工具参数。
- list：按名称或路径查找已经登记的资料。
- start：用准确的
sourceId或sourcePath派发任务。 - status / wait：用返回的
runId查询或有界等待进展，读取阶段摘要。 - 等待人工确认：状态变为
awaiting_review时，提示你通过聊天中的审核入口或资料页打开候选主题界面。 - 再次查看状态：你确认后继续跟踪，最终报告真实产出路径或失败原因。
例如：
- 请处理刚才查到的那份已登记资料。复用已有任务，告诉我当前阶段；需要确认主题时提醒我打开审核界面。完成后列出真实产出文件，不要代替我确认。
accepted: true 表示任务已接受派发，不表示 Wiki 已完成。reused: true 表示复用现有任务，应继续核对其状态。查询日志有分页和长度边界，返回的是进展摘要，不是全部模型请求内容。
Agent 派发后复用资料页的原生处理管线。本图是已有任务的实际阶段记录，不是本轮聊天工具执行记录。
哪些决定仍然需要人
工具只提供 list、start、status、wait 和 cancel，没有“confirm”动作。人工主题确认只能在审核界面完成。即使允许工具执行或开启较宽松的权限模式，也不能绕过主题确认。
启动和取消会改变任务状态，按当前工具权限处理。list、status、wait 用于查询，不替你授权后续写入。后台进度通知也不是用户同意继续生成的证据。
进入候选主题审核检查主体和原文依据，再确认生成。生成结束后，仍需检查最终正文。
重试、重新处理与取消
再次 start 会复用排队、运行或待审核中的任务。已完成、失败、取消或中断的记录也可能直接返回，不代表已经重跑。
确实要重新处理时，要明确说明。Agent 通过 reprocess: true 请求新的处理尝试，正在运行的任务仍不会重复派发。原始资料内容已变更时，也需要明确重新处理。
停止聊天中的回答或等待，不会自动取消已经派发的处理任务。需要停掉管线时，明确让 Agent 对准确的 runId 调用 cancel，并再查询状态。取消不会自动撤回已保存的来源或所有阶段产物。
与子代理、定时任务怎样配合
当前实现禁止子代理和无人值守执行通过 wiki_ingest 的 start 或 cancel 改变原生摄取任务。不要安排“每天自动 ingest 并自动确认主题”作为已经支持的功能。
子代理可以承担独立的资料分析和证据汇总，调度可以处理重复工作的其他步骤。原生摄取仍应由有人参与的主对话派发，并保留主题审核。继续阅读子代理和定时任务。
与“提炼回复”有什么区别
聊天回复上的“提纯为永久知识（ingest）”以及 Agent 的 propose_ingest，用于提出另一条提炼路线。回复入口在你确认提交后才把完整回复保存到 Inbox，再进入相应工作台。
当前这条工作台与资料页原生管线仍有不同的编排和审核过程。不要把回复提炼的暂存、预览或采纳步骤当成 wiki_ingest 已登记来源的同一套界面。capture_url 抓取网页到 Inbox，也不自动证明已经完成 Source 登记或 Wiki 发布。
两条路线都应保留出处与人工核对。想把一份外部资料按本章原生流程处理时，从资料页登记来源开始。
完成后，按知识视野选择需要的知识，或在聊天中明确引用笔记。Knowledge 与独立 Memory 的统一关联仍在研发。
Agent 与界面处理选项的差别
资料界面当前默认关闭“分析图片与图表”，开启扫描页文字识别。Agent 的 wiki_ingest 启动不传这组显式选项，会使用后端默认：图片分析与扫描识别均开启。两条入口的默认值不同。
开启标记不表示每份资料必定发生视觉调用：还取决于是否存在图片或扫描页、视觉模型是否可用，以及是否能复用结果。可能发送相关图像并产生额外服务用量，需要控制时先在资料界面核对选项，不把聊天里一句“处理资料”当作已经关闭视觉处理。人工主题确认仍不能由 Agent 绕过。
文档核对说明
- 查看编写与验证范围
- 对应操作截图待补
- 当前配图展示共用管线的历史处理过程，尚未展示聊天中实际调用 wiki_ingest 及跳转审核的状态。
- 开发预览与截图范围
- 当前源码在开发模式开放资料处理，生产默认入口仍关闭。本页说明按当前代码核对。实拍来自 Windows 开发实例，完成记录使用已有公开 DuckDB 资料；本轮没有导入新资料、确认主题或重新生成 Wiki。
- 本页验证范围
- 下列工具行为来自当前代码和内置 wiki-ingest 技能。截图展示共用管线的已有处理记录。本轮未在聊天中实调 wiki_ingest，不把相关页面截图当作 Agent 调用成功的证据。
内容来自 Orrery Desktop 的 Wiki，文档仍在持续完善。功能开放情况以当前版本为准。