Agent 只读完一页文档列表，为什么不能说全部查完？
Agent 找到一页文档后，不能仅凭列表不为空就回答“全部查完”。文档工具需要同时返回记录与覆盖信息：本次查了哪个范围、是否还有下一页、服务端有没有提示结果不完整。列表里的每一项都正确，也不代表没有遗漏。
先约定“全部”究竟指什么
假设任务是盘点某个项目目录中的方案附件。“全部”可能指目录直属文件，也可能包含子目录、共享空间和历史归档。执行前应明确范围、筛选条件与可见身份。没有权限读取的区域应标为未覆盖，不能据此得出那里不存在文件的结论。
Google Drive 的文件列表接口是一个具体例子：响应包含文件列表、下一页标记以及搜索不完整标志。下一页标记存在时，还应继续取后续结果；搜索不完整则意味着部分文档可能没有被搜索到。其他文档平台的字段和语义需要分别核实，不能自行补出相同能力。
不要拿返回条数猜结束
请求一百条却只收到二十条，可能是到达末页，也可能是服务端返回了较少结果。终止条件应按接口契约判断。分页过程中保持相同的范围、排序与筛选条件；如果用户调整查询，应建立新一轮遍历，不把前后两种查询的页拼成一份清单。
| 观察 | 合理处理 |
|---|---|
| 仍有下一页标记 | 沿用查询条件继续读取 |
| 空页但还有下一页 | 按接口约定继续，不以空页判定完成 |
| 下一页标记重复 | 停止循环并保留未完成状态 |
| 服务端提示搜索不完整 | 缩小支持的搜索范围或报告覆盖缺口 |
列表在变化时，保留遍历的时间边界
翻页期间有人新增、移动或删除文件，列表可能变化。稳定文件 ID 能帮助合并重复记录，但去重只解决重复，不能自动找回遗漏。如果接口没有提供快照一致性，就不要把一次分页遍历描述为某一秒的完整资产快照。
可以记录开始和结束时间、各页游标与获取数量。对必须完整的交付任务，再按已知目录或清单进行核对。发现游标失效时，遵照接口规则重新查询，并保留此前结果与重新查询的关联；不要无条件从断点继续，也不要悄悄丢弃前一轮缺口。
给汇总者一张覆盖回执
返回结果除了文档数组，还应包含查询条件、已读取页数、唯一对象数、下一页入口和覆盖状态。可区分“读取中”“遍历结束”“部分范围不可用”。这些字段是建议的业务设计，不是所有平台已有的原生返回值，适配层只能填写真实可获得的证据。
验收可使用三页测试清单，中间页包含重复对象，再加入一次空页和一次查询失败。核对最终唯一 ID 集合是否符合预期，失败是否保留缺口，重启后是否继续同一查询。若工具只向模型传递部分摘要，还应明确总清单保存在哪里，避免摘要截断再次变成信息遗漏。
最终回答应与覆盖证据一致：可以说“在指定目录与当前权限下读取了这些文件”，只有满足约定的完整性条件后，才能说这一区域已经查全。这个差别直接影响后续统计、知识接入和批量修改会不会漏掉真正需要处理的资料。
在企业文档中验证
如果要把本文方法用于企业文档，可预约演示，结合实际资料核对协作、权限与集成方式。
需要在自己的环境中验证时，可先了解私有化部署方案，再确定试用范围与验收要求。